Instruction
VPTESTNMW
Sets a mask bit for each pair of words whose AND is zero.
- Extensions
- Forms
- 6 (6 EVEX)
- Data
- Intel XED v2026.08.23
VPTESTNMW sets bit i of its destination mask when words i of its two sources have no 1 bit in common, that is when their AND is zero: 8, 16 or 32 bits for the XMM, YMM and ZMM forms. It is the word form of VPTESTNMD, whose page covers the masking it shares with the compares, and the complement of VPTESTMW. Like VPTESTNMB it needs AVX512BW. With one register named twice, it marks the words that are zero.
Recorded on Zen 5
- AND, not equality.
{evex} vptestnmw k7, ymm24, ymm3gave 7A84h: 8000h against 1, 0 against 8000h, 10h against 1 and 8000h against 7FFFh all count as zero, while FFFFh against FFFFh, 7FFFh against 1 and 8000h against 8000h do not. - Under a write mask.
vptestnmw k5{k2}, zmm1, zmm2gave 78841281h, the bits of the AND test that K2 also selects; every other bit of K5, the upper 32 included, became 0.
In compiled code
At -O2 with -march=x86-64-v4, GCC 14 and Clang 23 compile
h[i] == 0 ? c[i] : h[i] over int16_t to VPTESTNMW of one register
with itself and a masked VMOVDQU16 load of c[i].
For (h[i] & c[i]) == 0 ? 1 : h[i], Clang tests the two arrays with
VPTESTNMW, one from memory, while GCC computes the AND with VPANDQ,
compares it with zero using VPCMPW and blends with
VPBLENDMW. _mm512_testn_epi16_mask is one
VPTESTNMW and a KMOVD.
AMD’s Zen 5 latency spreadsheet gives one macro-op on pipe FP1 or FP2 and 3, 4 and 6 cycles for XMM, YMM and ZMM sources, with a second macro-op for a memory operand.
Forms
| Instruction | Encoding | Requires |
|---|---|---|
VPTESTNMW k {k}, xmm, xmm
VPTESTNMW_MASKmskw_MASKmskw_XMMu16_XMMu16_AVX512 | EVEX.128.F3.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTNMW k {k}, xmm, m128
VPTESTNMW_MASKmskw_MASKmskw_XMMu16_MEMu16_AVX512 | EVEX.128.F3.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTNMW k {k}, ymm, ymm
VPTESTNMW_MASKmskw_MASKmskw_YMMu16_YMMu16_AVX512 | EVEX.256.F3.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTNMW k {k}, ymm, m256
VPTESTNMW_MASKmskw_MASKmskw_YMMu16_MEMu16_AVX512 | EVEX.256.F3.0F38.W1 26 /r | AVX10.1 or AVX512BW + AVX512VL |
VPTESTNMW k {k}, zmm, zmm
VPTESTNMW_MASKmskw_MASKmskw_ZMMu16_ZMMu16_AVX512 | EVEX.512.F3.0F38.W1 26 /r | AVX10.1 or AVX512BW |
VPTESTNMW k {k}, zmm, m512
VPTESTNMW_MASKmskw_MASKmskw_ZMMu16_MEMu16_AVX512 | EVEX.512.F3.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 |
|---|---|---|
VPTESTNMW k {k}, xmm, xmm/m128 VPTESTNMW k {k}, ymm, ymm/m256 VPTESTNMW 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 VPTESTNMW, 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_testn_epi16_mask
__mmask8 _mm_testn_epi16_mask(__m128i __A, __m128i __B) |
|
_mm_mask_testn_epi16_mask
__mmask8 _mm_mask_testn_epi16_mask(__mmask8 __U, __m128i __A, __m128i __B) |
|
_mm256_testn_epi16_mask
__mmask16 _mm256_testn_epi16_mask(__m256i __A, __m256i __B) |
|
_mm256_mask_testn_epi16_mask
__mmask16 _mm256_mask_testn_epi16_mask(__mmask16 __U, __m256i __A, __m256i __B) |
|
_mm512_testn_epi16_mask
__mmask32 _mm512_testn_epi16_mask(__m512i __A, __m512i __B) |
|
_mm512_mask_testn_epi16_mask
__mmask32 _mm512_mask_testn_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
- VPSRLVQ
- VPSRLVW
- VPSRLW
- VPSUBB
- VPSUBD
- VPSUBQ
- VPSUBSB
- VPSUBSW
- VPSUBUSB
- VPSUBUSW
- VPSUBW
- VPTERNLOGD
- VPTERNLOGQ
- VPTESTMB
- VPTESTMD
- VPTESTMQ
- VPTESTMW
- VPTESTNMB
- VPTESTNMD
- VPTESTNMQ
- VPUNPCKHBW
- VPUNPCKHDQ
- VPUNPCKHQDQ
- VPUNPCKHWD
- VPUNPCKLBW
- VPUNPCKLDQ
- VPUNPCKLQDQ
- VPUNPCKLWD
- VPXORD
- VPXORQ
- VRANGEPD
- VRANGEPS
- VRANGESD
- VRANGESS
- VRCP14PD
- VRCP14PS
- VRCP14SD
- VRCP14SS
- VRCPPH
- VRCPSH
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-657 (VPTESTNMB/
W/ D/ Q) - 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.