Instruction
VREDUCEBF16
Subtracts from each packed bfloat16 value its value rounded to the number of fraction bits an immediate gives, leaving the reduced argument.
- Extensions
- Forms
- 6 (6 EVEX)
- Data
- Intel XED v2026.08.23
VREDUCEBF16 returns, for each bfloat16 value, what rounding to M fraction bits takes away: x minus x rounded to a multiple of 2^-M, where M is bits 7:4 of the immediate, 8, 16 or 32 per register. It is the bfloat16 form of VREDUCEPS and belongs to AVX10.2; the opcode is 56h in map 0F3A with the F2 prefix and W0, where VREDUCEPH has no prefix, and the source may be broadcast from 16 bits of memory.
One rounding, few special cases
The AVX10.2 specification (revision 7.0) rounds to nearest even only: its routine reads bits 7:4 of the immediate and none of the bits that choose the direction for VREDUCEPS, as on VRNDSCALEBF16’s page. So the result lies between -2^(-M-1) and 2^(-M-1), never in the one-sided ranges that the other directions give. Denormal inputs are read as zeros and denormal results flushed, and from 2^(7-M) up every bfloat16 is a multiple of 2^-M, where the result is zero.
The entry has no table of special inputs: its routine treats only NaNs, which come back quiet, and does not say what an infinity gives, where VREDUCEPS’s table gives +0. Like VRCPBF16’s entry, it also lacks the sentence on exceptions and MXCSR that VADDBF16’s entry has, and relies on exception class E4, defined in Section 4.2.5 as causing no SIMD floating-point exceptions.
In our builds
GCC 14 has no AVX10.2 option. Clang 23 at -O2 with -mavx10.2 compiles
_mm512_reduce_pbh(x, 0x10) to vreducebf16 zmm0, zmm0, 16. A loop of
X[i] - __builtin_elementwise_roundeven(X[i]) over a global __bf16
array does not: it rounds each element as a single with VROUNDSS or
VRNDSCALESS, narrows it, and subtracts with
VSUBBF16, with or without -ffast-math. No AVX10.2
processor appears in this site’s recorded cases.
Forms
| Instruction | Encoding | Requires |
|---|---|---|
VREDUCEBF16 xmm {k}{z}, xmm, imm8
VREDUCEBF16_XMMbf16_MASKmskw_XMMbf16_IMM8_AVX512 | EVEX.128.F2.0F3A.W0 56 /r ib | AVX10.2 |
VREDUCEBF16 xmm {k}{z}, m128/m16bcst, imm8
VREDUCEBF16_XMMbf16_MASKmskw_MEMbf16_IMM8_AVX512 | EVEX.128.F2.0F3A.W0 56 /r ib | AVX10.2 |
VREDUCEBF16 ymm {k}{z}, ymm, imm8
VREDUCEBF16_YMMbf16_MASKmskw_YMMbf16_IMM8_AVX512 | EVEX.256.F2.0F3A.W0 56 /r ib | AVX10.2 |
VREDUCEBF16 ymm {k}{z}, m256/m16bcst, imm8
VREDUCEBF16_YMMbf16_MASKmskw_MEMbf16_IMM8_AVX512 | EVEX.256.F2.0F3A.W0 56 /r ib | AVX10.2 |
VREDUCEBF16 zmm {k}{z}, zmm, imm8
VREDUCEBF16_ZMMbf16_MASKmskw_ZMMbf16_IMM8_AVX512 | EVEX.512.F2.0F3A.W0 56 /r ib | AVX10.2 |
VREDUCEBF16 zmm {k}{z}, m512/m16bcst, imm8
VREDUCEBF16_ZMMbf16_MASKmskw_MEMbf16_IMM8_AVX512 | EVEX.512.F2.0F3A.W0 56 /r ib | 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 bfloat16 works alike: 8, 16 and 32 bfloat16s 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 bfloat16 from memory stands for every element of the last source.
Result bfloat16 i comes from bfloat16 i of xmm2. Result bfloat16s 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.bf16[i]
zmm1.bf16[i] = reduce(a, imm8)
elif zeroing:
zmm1.bf16[i] = 0
# else: zmm1.bf16[i] keeps its value
# imm8[7:4]: fraction bits kept; [1:0]: rn, rd, ru, rz; bit 2: MXCSR.RC; bit 3: no PE
# m16bcst: src2.bf16[i] is the m16 for every i
# BF16: to nearest even, denormals flushed, no flags; MXCSR unused
# zmm1 is zeroed from bit VL upNot run on a processor: none of these processors has AVX10.2.
Operands
| Operand | Kind | Action |
|---|---|---|
VREDUCEBF16 xmm {k}{z}, xmm/m128/m16bcst, imm8 VREDUCEBF16 ymm {k}{z}, ymm/m256/m16bcst, imm8 VREDUCEBF16 zmm {k}{z}, zmm/m512/m16bcst, imm8 | ||
xmm, ymm, zmm | explicit | write (masked) |
{k} | explicit | read (write mask) |
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-E4
Attributes
What else XED records about the forms. How to read.
- All forms
- write masking; always rounds to nearest even; denormal inputs read as zero; denormal results flushed to zero
- Memory forms
- embedded broadcast (tuple Full); memory fault suppression
Intrinsics
The C intrinsics of Clang 23.1.2 that compile to VREDUCEBF16, 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_reduce_pbh
__m128bh _mm_reduce_pbh(__m128bh __A, const int imm) |
|
_mm_mask_reduce_pbh
__m128bh _mm_mask_reduce_pbh(__m128bh __W, __mmask8 __U, __m128bh __A, const int imm) |
|
_mm_maskz_reduce_pbh
__m128bh _mm_maskz_reduce_pbh(__mmask8 __U, __m128bh __A, const int imm) |
|
_mm256_reduce_pbh
__m256bh _mm256_reduce_pbh(__m256bh __A, const int imm) |
|
_mm256_mask_reduce_pbh
__m256bh _mm256_mask_reduce_pbh(__m256bh __W, __mmask16 __U, __m256bh __A, const int imm) |
|
_mm256_maskz_reduce_pbh
__m256bh _mm256_maskz_reduce_pbh(__mmask16 __U, __m256bh __A, const int imm) |
|
_mm512_reduce_pbh
__m512bh _mm512_reduce_pbh(__m512bh __A, const int imm) |
|
_mm512_mask_reduce_pbh
__m512bh _mm512_mask_reduce_pbh(__m512bh __W, __mmask32 __U, __m512bh __A, const int imm) |
|
_mm512_maskz_reduce_pbh
__m512bh _mm512_maskz_reduce_pbh(__mmask32 __U, __m512bh __A, const int imm) |
|
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 |
|---|---|---|
AVX10_2_BF16_128 | AVX10.2 | Nova Lake, Diamond Rapids |
AVX10_2_BF16_256 | Same as AVX10_2_BF16_128 | Same as AVX10_2_BF16_128 |
AVX10_2_BF16_512 | Same as AVX10_2_BF16_128 | Same as AVX10_2_BF16_128 |
More AVX10.2 instructions
- VFNMSUB132BF16
- VFNMSUB213BF16
- VFNMSUB231BF16
- VFPCLASSBF16
- VGETEXPBF16
- VGETMANTBF16
- VMAXBF16
- VMINBF16
- VMINMAXBF16
- VMINMAXPD
- VMINMAXPH
- VMINMAXPS
- VMINMAXSD
- VMINMAXSH
- VMINMAXSS
- VMOVD
- VMOVW
- VMPSADBW
- VMULBF16
- VPDPBSSD
- VPDPBSSDS
- VPDPBSUD
- VPDPBSUDS
- VPDPBUUD
- VPDPBUUDS
- VPDPWSUD
- VPDPWSUDS
- VPDPWUSD
- VPDPWUSDS
- VPDPWUUD
- VPDPWUUDS
- VRCPBF16
- VRNDSCALEBF16
- VRSQRTBF16
- VSCALEFBF16
- VSQRTBF16
- VSUBBF16
- VUCOMXSD
- VUCOMXSH
- VUCOMXSS
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.