Instruction
VPTESTMW
Sets a mask bit for each pair of words whose AND is not zero.
- Extensions
- Forms
- 6 (6 EVEX)
- Data
- Intel XED v2026.08.23
VPTESTMW ANDs each pair of words and sets a bit of the destination mask where the AND has any bit set, one bit per word: 8, 16 or 32 of them. It is the word form of VPTESTMD, whose page explains the family and the common tests, and of VPTESTMB; VPTESTNMW sets the bits where the AND is zero. It needs AVX512BW and has no broadcast form.
Recorded on Zen 5
- Any shared bit. In
vptestmw k1, ymm1, ymm2, 8000h against FFFFh and 000Fh against 0001h set their bits, and 8000h against 7FFFh, 0010h against 0001h and 0 against 0 did not, giving BE15h. - The write mask.
vptestmw k5{k3}, xmm24, xmmword ptr [mem]set the bits of four of the six words K3 selected, E1h, and none outside; the words left out were 8000h against 7FFFh and 0 against 1.
In compiled code
GCC 14 and Clang 23 at -O2 with -march=x86-64-v4 compile
_mm512_test_epi16_mask to VPTESTMW. They part on the rest:
- Selecting words. For
o[i] = (a[i] & b[i]) ? a[i] : 0overuint16_tarrays, Clang testsa[i]againstb[i]in memory, on YMM registers; GCC ANDs them with VPANDQ and compares the result with zero, using VPCMPW with predicate 4. Both store through a zero-masked VMOVDQU16. - Nonzero words.
_mm512_cmpneq_epi16_mask(a, zero)isvptestmw k0, zmm0, zmm0in Clang and VPCMPW against a zeroed register in GCC. - Masked test. GCC keeps
_mm512_mask_test_epi16_maskasvptestmw k0{k1}; Clang tests unmasked and ANDs in EAX.
AMD’s Zen 5 latency spreadsheet gives VPTESTMW 3, 4 and 6 cycles for XMM, YMM and ZMM, one macro-op on FP1 or FP2 and two with a memory source, as VPTESTMB.
Forms
| Instruction | Encoding | Requires |
|---|---|---|
VPTESTMW k {k}, xmm, xmm
VPTESTMW_MASKmskw_MASKmskw_XMMu16_XMMu16_AVX512 | EVEX.128.66.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTMW k {k}, xmm, m128
VPTESTMW_MASKmskw_MASKmskw_XMMu16_MEMu16_AVX512 | EVEX.128.66.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTMW k {k}, ymm, ymm
VPTESTMW_MASKmskw_MASKmskw_YMMu16_YMMu16_AVX512 | EVEX.256.66.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTMW k {k}, ymm, m256
VPTESTMW_MASKmskw_MASKmskw_YMMu16_MEMu16_AVX512 | EVEX.256.66.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTMW k {k}, zmm, zmm
VPTESTMW_MASKmskw_MASKmskw_ZMMu16_ZMMu16_AVX512 | EVEX.512.66.0F38.W1 26 /r | AVX10.1 or AVX512BW |
VPTESTMW k {k}, zmm, m512
VPTESTMW_MASKmskw_MASKmskw_ZMMu16_MEMu16_AVX512 | EVEX.512.66.0F38.W1 26 /r | AVX10.1 or AVX512BW |
Latency and throughput
| Model | k {k}, xmm, xmmno mask | k {k}, xmm, xmmwith a mask | k {k}, xmm, m128 | k {k}, ymm, ymm | k {k}, ymm, m256k {k}, zmm, m512 | k {k}, zmm, zmmno mask | k {k}, zmm, zmmwith a mask |
|---|---|---|---|---|---|---|---|
| Skylake-SP, Ice Lake | 4 / 1p5 | 4 / 1p5 | 10 / 1p5 | 4 / 1p5 | 11 / 1p5 | 4 / 1p5 | 4 / 1p5 |
| Sapphire Rapids | 3 / 1p5 | 3 / 1p5 | 3 / 1p5 | 3 / 1p5 | 3 / 1p5 | 3 / 1p5 | 3 / 1p5 |
| Zen 4 | 1 / 0.25FP0 FP1 FP2 FP3 | 3 / 1.5FP0 FP1 | 8 / 0.5FP0 FP1 FP2 FP3 | 4 / 2FP0 FP1 | 8 / 0.5FP0 FP1 FP2 FP3 | 1 / 0.5FP0 FP1 FP2 FP3 | 5 / 2.5FP0 FP1 |
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 word works alike: 8, 16 and 32 words in the xmm, ymm and zmm forms.
Bit i of k1 comes from word 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.w[i]
b = src3.w[i]
k1[i] = k2[i] and a & b != 0
# the other bits of k1 are clearedRun on AMD Zen 5 (EPYC 9645): 6 cases.
Operands
| Operand | Kind | Action |
|---|---|---|
VPTESTMW k {k}, xmm, xmm/m128 VPTESTMW k {k}, ymm, ymm/m256 VPTESTMW k {k}, zmm, zmm/m512 | ||
k | explicit | write (masked) |
{k} | explicit | read (write mask) |
xmm, ymm, zmm | explicit | read |
xmm/m128, ymm/m256, zmm/m512 | 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-E4
Attributes
What else XED records about the forms. How to read.
- All forms
- write masking
- Memory forms
- memory fault suppression
Intrinsics
The C intrinsics of Clang 23.1.2 that compile to VPTESTMW, 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_test_epi16_mask
__mmask8 _mm_test_epi16_mask(__m128i __A, __m128i __B) |
|
_mm_mask_test_epi16_mask
__mmask8 _mm_mask_test_epi16_mask(__mmask8 __U, __m128i __A, __m128i __B) |
|
_mm256_test_epi16_mask
__mmask16 _mm256_test_epi16_mask(__m256i __A, __m256i __B) |
|
_mm256_mask_test_epi16_mask
__mmask16 _mm256_mask_test_epi16_mask(__mmask16 __U, __m256i __A, __m256i __B) |
|
_mm512_test_epi16_mask
__mmask32 _mm512_test_epi16_mask(__m512i __A, __m512i __B) |
|
_mm512_mask_test_epi16_mask
__mmask32 _mm512_mask_test_epi16_mask(__mmask32 __U, __m512i __A, __m512i __B) |
|
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 |
|---|---|---|
AVX512BW_128 | AVX10.1 or AVX512BW + AVX512VL | Cannon Lake, Ice Lake (client), Tiger Lake, Nova Lake, Skylake-SP, Cascade Lake, Cooper Lake, Ice Lake (server), Sapphire Rapids, Emerald Rapids, Granite Rapids, Diamond Rapids, Zen 4, Zen 5, Zen 6 |
AVX512BW_256 | Same as AVX512BW_128 | Same as AVX512BW_128 |
AVX512BW_512 | AVX10.1 or AVX512BW | Same as AVX512BW_128 |
More AVX10.1 instructions
- VPSRLD
- VPSRLDQ
- VPSRLQ
- VPSRLVD
- VPSRLVQ
- VPSRLVW
- VPSRLW
- VPSUBB
- VPSUBD
- VPSUBQ
- VPSUBSB
- VPSUBSW
- VPSUBUSB
- VPSUBUSW
- VPSUBW
- VPTERNLOGD
- VPTERNLOGQ
- VPTESTMB
- VPTESTMD
- VPTESTMQ
- VPTESTNMB
- VPTESTNMD
- VPTESTNMQ
- VPTESTNMW
- VPUNPCKHBW
- VPUNPCKHDQ
- VPUNPCKHQDQ
- VPUNPCKHWD
- VPUNPCKLBW
- VPUNPCKLDQ
- VPUNPCKLQDQ
- VPUNPCKLWD
- VPXORD
- VPXORQ
- VRANGEPD
- VRANGEPS
- VRANGESD
- VRANGESS
- VRCP14PD
- VRCP14PS
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-654 (VPTESTMB/
VPTESTMW/ VPTESTMD/ VPTESTMQ) - 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.