Instruction
VCVTPH2IUBS
Converts packed half-precision values to unsigned bytes with saturation, each result in the low byte of a zeroed 16-bit element.
- Extensions
- Forms
- 6 (6 EVEX)
- Data
- Intel XED v2026.08.23
VCVTPH2IUBS converts each half-precision value to an unsigned byte,
rounding as MXCSR.RC or the {er} operand says: above 255 gives FFh,
below 0 gives 0, and a NaN gives 0, each result in the low byte of its
word with the high byte cleared. Its opcode is 6Bh without a prefix in
EVEX map 5, two above the signed VCVTPH2IBS’s 69h,
and the two pages share everything else; VCVTPS2IBS
describes the family.
Where the range ends
The rounding decides which values set IE. The specification’s helper function gives a range for each mode: to nearest even, below -1/2 or from 255.5 on; rounding down, anything below 0, so -0.1 sets IE and gives 0; rounding up, -1 or less, and anything above 255. A value that stays in range but is not an integer sets PE. The comment at the top of that helper gives the unsigned maximum as 2^(w-1), which would be 128 for a byte; its code returns FFh. The helper for the single-precision VCVTPS2IUBS has one range for every mode instead.
In our builds
GCC 14 has no AVX10.2 option. Clang 23 with -mavx10.2 compiles
_mm512_ipcvts_ph_epu8 to vcvtph2iubs zmm0, zmm0, and
_mm512_ipcvts_roundph_epu8(x, _MM_FROUND_TO_ZERO | _MM_FROUND_NO_EXC) to vcvtph2iubs zmm0, zmm0, {rz-sae}, which gives
the results of the truncating VCVTTPH2IUBS
without reporting exceptions. No AVX10.2 processor appears in this
site’s recorded cases.
Forms
| Instruction | Encoding | Requires |
|---|---|---|
VCVTPH2IUBS xmm {k}{z}, xmm
VCVTPH2IUBS_XMMu8_MASKmskw_XMMf16_AVX512 | EVEX.128.NP.MAP5.W0 6B /r | AVX10.2 |
VCVTPH2IUBS xmm {k}{z}, m128/m16bcst
VCVTPH2IUBS_XMMu8_MASKmskw_MEMf16_AVX512 | EVEX.128.NP.MAP5.W0 6B /r | AVX10.2 |
VCVTPH2IUBS ymm {k}{z}, ymm
VCVTPH2IUBS_YMMu8_MASKmskw_YMMf16_AVX512 | EVEX.256.NP.MAP5.W0 6B /r | AVX10.2 |
VCVTPH2IUBS ymm {k}{z}, m256/m16bcst
VCVTPH2IUBS_YMMu8_MASKmskw_MEMf16_AVX512 | EVEX.256.NP.MAP5.W0 6B /r | AVX10.2 |
VCVTPH2IUBS zmm {k}{z}, zmm, {er}
VCVTPH2IUBS_ZMMu8_MASKmskw_ZMMf16_AVX512 | EVEX.512.NP.MAP5.W0 6B /r | AVX10.2 |
VCVTPH2IUBS zmm {k}{z}, m512/m16bcst
VCVTPH2IUBS_ZMMu8_MASKmskw_MEMf16_AVX512 | EVEX.512.NP.MAP5.W0 6B /r | AVX10.2 |
Data flow
Where the elements of the sources go, element 0 on the right; results that depend on a control value are drawn for an example. How to read.
Every half works alike: 8, 16 and 32 halves in the xmm, ymm and zmm forms. The forms write under a mask: where its bit is 0, the element keeps its old value, or zeroes it with {z}. With m16bcst, one half from memory stands for every element of the last source.
Result half i comes from half i of xmm2. Result halves 7 to 0: r7, unchanged (bit 6 of k1 is 0), r5, r4, r3, r2, r1, r0.
Operation
What the forms do, in pseudocode that our tests run against results recorded on real processors. How to read.
for i in range(VL // 16):
if k1[i]:
a = src2.f16[i]
zmm1.w[i] = cvts_uint(a, 8)
elif zeroing:
zmm1.w[i] = 0
# else: zmm1.w[i] keeps its value
# m16bcst: src2.f16[i] is the m16 for every i
# {er}: the form's rounding, not MXCSR.RC, and no flags
# zmm1 is zeroed from bit VL upNot run on a processor: none of these processors has AVX10.2.
Operands
| Operand | Kind | Action |
|---|---|---|
VCVTPH2IUBS xmm {k}{z}, xmm/m128/m16bcst VCVTPH2IUBS ymm {k}{z}, ymm/m256/m16bcst VCVTPH2IUBS zmm {k}{z}, zmm/m512/m16bcst, {er} | ||
xmm, ymm, zmm | explicit | write (masked) |
{k} | explicit | read (write mask) |
xmm/m128/m16bcst, ymm/m256/m16bcst, zmm/m512/m16bcst | explicit | read |
Flags
None: XED records no flag that the forms test or change.
Exceptions
The exception class is XED's name for the set of exception conditions that a form follows. How to read.
- All forms
AVX512-E2
Attributes
What else XED records about the forms. How to read.
- All forms
- write masking; follows MXCSR
- Memory forms
- embedded broadcast (tuple Full); memory fault suppression
Intrinsics
The C intrinsics of Clang 23.1.2 that compile to VCVTPH2IUBS, each with the form it compiles to and the Clang options it needs. The forms come from compiling every intrinsic and decoding the result with Intel XED; all intrinsics A–Z explains the method.
| Intrinsic | Compiles to |
|---|---|
_mm_ipcvts_ph_epu8
__m128i _mm_ipcvts_ph_epu8(__m128h A) |
|
_mm_mask_ipcvts_ph_epu8
__m128i _mm_mask_ipcvts_ph_epu8(__m128i W, __mmask8 U, __m128h A) |
|
_mm_maskz_ipcvts_ph_epu8
__m128i _mm_maskz_ipcvts_ph_epu8(__mmask8 U, __m128h A) |
|
_mm256_ipcvts_ph_epu8
__m256i _mm256_ipcvts_ph_epu8(__m256h A) |
|
_mm256_mask_ipcvts_ph_epu8
__m256i _mm256_mask_ipcvts_ph_epu8(__m256i W, __mmask16 U, __m256h A) |
|
_mm256_maskz_ipcvts_ph_epu8
__m256i _mm256_maskz_ipcvts_ph_epu8(__mmask16 U, __m256h A) |
|
_mm512_ipcvts_ph_epu8
__m512i _mm512_ipcvts_ph_epu8(__m512h A) |
|
_mm512_ipcvts_roundph_epu8
__m512i _mm512_ipcvts_roundph_epu8(__m512h A, const int R) |
|
_mm512_mask_ipcvts_ph_epu8
__m512i _mm512_mask_ipcvts_ph_epu8(__m512i W, __mmask32 U, __m512h A) |
|
_mm512_mask_ipcvts_roundph_epu8
__m512i _mm512_mask_ipcvts_roundph_epu8(__m512i W, __mmask32 U, __m512h A, const int R) |
|
_mm512_maskz_ipcvts_ph_epu8
__m512i _mm512_maskz_ipcvts_ph_epu8(__mmask32 U, __m512h A) |
|
_mm512_maskz_ipcvts_roundph_epu8
__m512i _mm512_maskz_ipcvts_roundph_epu8(__mmask32 U, __m512h A, const int R) |
|
CPUID and processors
Each form belongs to an XED ISA set. A form can be used when the processor reports every CPUID bit of one of its ISA set's alternatives.
| ISA set | CPUID | Processors |
|---|---|---|
AVX512_SAT_CVT_128 | AVX10.2 | Nova Lake, Diamond Rapids |
AVX512_SAT_CVT_256 | Same as AVX512_SAT_CVT_128 | Same as AVX512_SAT_CVT_128 |
AVX512_SAT_CVT_512 | Same as AVX512_SAT_CVT_128 | Same as AVX512_SAT_CVT_128 |
More AVX10.2 instructions
- VCOMXSD
- VCOMXSH
- VCOMXSS
- VCVT2PH2BF8
- VCVT2PH2BF8S
- VCVT2PH2HF8
- VCVT2PH2HF8S
- VCVT2PS2PHX
- VCVTBF162IBS
- VCVTBF162IUBS
- VCVTBIASPH2BF8
- VCVTBIASPH2BF8S
- VCVTBIASPH2HF8
- VCVTBIASPH2HF8S
- VCVTHF82PH
- VCVTPH2BF8
- VCVTPH2BF8S
- VCVTPH2HF8
- VCVTPH2HF8S
- VCVTPH2IBS
- VCVTPS2IBS
- VCVTPS2IUBS
- VCVTTBF162IBS
- VCVTTBF162IUBS
- VCVTTPD2DQS
- VCVTTPD2QQS
- VCVTTPD2UDQS
- VCVTTPD2UQQS
- VCVTTPH2IBS
- VCVTTPH2IUBS
- VCVTTPS2DQS
- VCVTTPS2IBS
- VCVTTPS2IUBS
- VCVTTPS2QQS
- VCVTTPS2UDQS
- VCVTTPS2UQQS
- VCVTTSD2SIS
- VCVTTSD2USIS
- VCVTTSS2SIS
- VCVTTSS2USIS
Sources
- Intel XED v2026.08.23 (commit
0bcb6237345c): forms, encodings, operands, flags, exception classes, attributes, ISA sets, CPUID bits and chip model. - Clang's x86 intrinsic headers, LLVM 23.1.2 (commit
85ac56026243): the intrinsics, their signatures and doc comments, and the Clang of that release, which compiled each of them. - Intel Advanced Vector Extensions 10.2 Architecture Specification, revision 7.0 (361050-007, April 2026)
The tables are derived from Intel XED, Copyright Intel Corporation, licensed under the Apache License 2.0; x86-64.net converted and reformatted them. The intrinsics and their signatures come from Clang, part of the LLVM Project, licensed under the Apache License 2.0 with LLVM Exceptions. The text is our own.