Instruction
VCMPPH
Compares packed half-precision values with one of 32 predicates chosen by an immediate and writes the results to a mask register.
- Extensions
- Forms
- 6 (6 EVEX)
- Data
- Intel XED v2026.08.23
VCMPPH compares halves element by element under one of the 32 predicates
of VCMPPS, chosen by bits 4:0 of the immediate, and
writes one bit per element to a mask register, up to 32 for zmm
registers; elements that its write mask leaves out get 0. That page
explains what bits 3 and 4 of the predicate do with NaNs. There is no
vector-result form: unlike VCMPPS, which also has VEX forms writing all
ones to an element, VCMPPH exists only in EVEX and only with a mask
destination. It takes a source broadcast from one half and {sae} on
the 512-bit register form, and reports invalid and denormal, never
reading a denormal as zero since FP16 ignores DAZ (Intel’s optimization
manual, Section 18.5.4). VADDPH covers the format and
the CPUID bits; VCMPSH compares the low halves.
In the 0F3A map
VCMPPS is opcode C2h in map 0F. VCMPPH is C2h with no prefix in map 0F3A, the map of FP16’s other instructions with an immediate, as VGETMANTPH’s page notes.
In our builds
At -O2 with -march=x86-64-v4 -mavx512fp16, GCC 14 and Clang 23
vectorize compares over global _Float16 arrays with VCMPPH, GCC on zmm
and Clang mostly on ymm registers, the second operand read from memory.
c[i] = a[i] < b[i] ? a[i] : 0 becomes predicate 1, less than and
signaling, followed by a zero-masked VMOVDQU16 that keeps the selected
halves. A mask stored as 16-bit integers, m[i] = a[i] == b[i], uses
predicate 0, which GCC turns into ones with a zero-masked move of a
vector of 1s and Clang into all-ones words with VPMOVM2W. isnan(a[i])
is predicate 3, unordered, of each vector with itself. Counting a[i] >= 1 swaps the operands to compare 1 <= a[i] with predicate 2, before the
bits are widened and added. Intel’s optimization manual shows the same
instruction through _mm512_cmp_ph_mask, and notes that comparing as
16-bit integers costs the same (Sections 18.4.4 and 18.6.3).
AMD’s Zen 5 guide does not list AVX512-FP16, and this site’s recorded cases include none of VCMPPH.
Forms
| Instruction | Encoding | Requires |
|---|---|---|
VCMPPH k {k}, xmm, xmm, imm8
VCMPPH_MASKmskw_MASKmskw_XMMf16_XMMf16_IMM8_AVX512 | EVEX.128.NP.0F3A.W0 C2 /r ib | AVX10.1 or AVX512_FP16 + AVX512VL |
VCMPPH k {k}, xmm, m128/m16bcst, imm8
VCMPPH_MASKmskw_MASKmskw_XMMf16_MEMf16_IMM8_AVX512 | EVEX.128.NP.0F3A.W0 C2 /r ib | AVX10.1 or AVX512_FP16 + AVX512VL |
VCMPPH k {k}, ymm, ymm, imm8
VCMPPH_MASKmskw_MASKmskw_YMMf16_YMMf16_IMM8_AVX512 | EVEX.256.NP.0F3A.W0 C2 /r ib | AVX10.1 or AVX512_FP16 + AVX512VL |
VCMPPH k {k}, ymm, m256/m16bcst, imm8
VCMPPH_MASKmskw_MASKmskw_YMMf16_MEMf16_IMM8_AVX512 | EVEX.256.NP.0F3A.W0 C2 /r ib | AVX10.1 or AVX512_FP16 + AVX512VL |
VCMPPH k {k}, zmm, zmm, imm8, {sae}
VCMPPH_MASKmskw_MASKmskw_ZMMf16_ZMMf16_IMM8_AVX512 | EVEX.512.NP.0F3A.W0 C2 /r ib | AVX10.1 or AVX512_FP16 |
VCMPPH k {k}, zmm, m512/m16bcst, imm8
VCMPPH_MASKmskw_MASKmskw_ZMMf16_MEMf16_IMM8_AVX512 | EVEX.512.NP.0F3A.W0 C2 /r ib | AVX10.1 or AVX512_FP16 |
Latency and throughput
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.
Where a bit of the write mask k2 is 0, the result bit is 0. Every half works alike: 8, 16 and 32 halves in the xmm, ymm and zmm forms. With m16bcst, one half from memory stands for every element of the last source.
Bit i of k1 comes from half i of xmm2 and xmm3. Result bits 7 to 0: r7, 0 (bit 6 of k2 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):
a = zmm2.f16[i]
b = src3.f16[i]
k1[i] = k2[i] and fcmp(imm8, a, b)
# imm8 & 31: 0 ==, 1 <, 2 <=, 3 unordered, 4 !=, 5 !<, 6 !<=, 7 ordered ...
# m16bcst: src3.f16[i] is the m16 for every i
# {sae}: no exception flags
# the other bits of k1 are clearedNot run on a processor: none of these processors has AVX512-FP16.
Operands
| Operand | Kind | Action |
|---|---|---|
VCMPPH k {k}, xmm, xmm/m128/m16bcst, imm8 VCMPPH k {k}, ymm, ymm/m256/m16bcst, imm8 VCMPPH k {k}, zmm, zmm/m512/m16bcst, imm8, {sae} | ||
k | explicit | write (masked) |
{k} | explicit | read (write mask) |
xmm, ymm, zmm | explicit | read |
xmm/m128/m16bcst, ymm/m256/m16bcst, zmm/m512/m16bcst | explicit | read |
imm8 | 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 VCMPPH, 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_cmp_ph_mask
__mmask8 _mm_cmp_ph_mask(__m128h a, __m128h b, const int p) |
|
_mm_mask_cmp_ph_mask
__mmask8 _mm_mask_cmp_ph_mask(__mmask8 m, __m128h a, __m128h b, const int p) |
|
_mm256_cmp_ph_mask
__mmask16 _mm256_cmp_ph_mask(__m256h a, __m256h b, const int p) |
|
_mm256_mask_cmp_ph_mask
__mmask16 _mm256_mask_cmp_ph_mask(__mmask16 m, __m256h a, __m256h b, const int p) |
|
_mm512_cmp_ph_mask
__mmask32 _mm512_cmp_ph_mask(__m512h A, __m512h B, const int P) |
|
_mm512_mask_cmp_ph_mask
__mmask32 _mm512_mask_cmp_ph_mask(__mmask32 U, __m512h A, __m512h B, const int P) |
|
_mm512_cmp_round_ph_mask
__mmask32 _mm512_cmp_round_ph_mask(__m512h A, __m512h B, const int P, const int R) |
|
_mm512_mask_cmp_round_ph_mask
__mmask32 _mm512_mask_cmp_round_ph_mask(__mmask32 U, __m512h A, __m512h B, const int P, 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_FP16_128 | AVX10.1 or AVX512_FP16 + AVX512VL | Nova Lake, Sapphire Rapids, Emerald Rapids, Granite Rapids, Diamond Rapids, Zen 6 |
AVX512_FP16_256 | Same as AVX512_FP16_128 | Same as AVX512_FP16_128 |
AVX512_FP16_512 | AVX10.1 or AVX512_FP16 | Same as AVX512_FP16_128 |
More AVX10.1 instructions
- VALIGNQ
- VANDNPD
- VANDNPS
- VANDPD
- VANDPS
- VBLENDMPD
- VBLENDMPS
- VBROADCASTF32X2
- VBROADCASTF32X4
- VBROADCASTF32X8
- VBROADCASTF64X2
- VBROADCASTF64X4
- VBROADCASTI32X2
- VBROADCASTI32X4
- VBROADCASTI32X8
- VBROADCASTI64X2
- VBROADCASTI64X4
- VBROADCASTSD
- VBROADCASTSS
- VCMPPD
- VCMPPS
- VCMPSD
- VCMPSH
- VCMPSS
- VCOMISD
- VCOMISH
- VCOMISS
- VCOMPRESSPD
- VCOMPRESSPS
- VCVTDQ2PD
- VCVTDQ2PH
- VCVTDQ2PS
- VCVTNE2PS2BF16
- VCVTNEPS2BF16
- VCVTPD2DQ
- VCVTPD2PH
- VCVTPD2PS
- VCVTPD2QQ
- VCVTPD2UDQ
- VCVTPD2UQQ
Sources
- Intel XED v2026.08.23 (commit
0bcb6237345c): forms, encodings, operands, flags, exception classes, attributes, ISA sets, CPUID bits and chip model. - The CPU data of x86-64.net: Zen 3 to Zen 6, from GCC’s
-marchfeature sets and AMD’s Processor Programming References, which the page of each processor cites. - 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. - LLVM 23.1.2's x86 scheduling models (commit
85ac56026243): the latency, reciprocal throughput and ports of each form, as llvm-mca reports them. - Intel Advanced Vector Extensions 10.2 Architecture Specification, revision 7.0 (361050-007, April 2026)
- Intel 64 and IA-32 Architectures Software Developer's Manual, Volume 2 (325383-093, September 2026): Volume 2C, page 5-20 (VCMPPH)
- Intel 64 and IA-32 Architectures Optimization Reference Manual, Volume 1 (248966-051, October 2026)
- Software Optimization Guide for the AMD Zen5 Microarchitecture (58455, rev. 1.00, August 2024), Wayback Machine copy of AMD's ZIP
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 and the timings from LLVM's scheduling models, both part of the LLVM Project, licensed under the Apache License 2.0 with LLVM Exceptions. The text is our own.