首页/指令库/VFCLASS-V
VFCLASS.V

RISC-V VFCLASS.V 指令详解

指令手册OPFVV

按官方 FCLASS 10 类表分类每个活动浮点元素,并把 one-hot 分类码写入 vd[i] 低位。

指令语法

vfclass.v vd, vs2, vm
操作数说明
vd、vs2 为 SEW 位向量寄存器组;同 EEW 源/目标可重叠。VFADD.VV 的 vs1 也是同 SEW 向量源,同名源必须读取相同初值;一元指令的 vs1 编码位是固定选择字段。
要求 V、VS/FS 已启用且 vtype 受支持;V 支持 binary32/64,SEW=16 的这些指令需要 Zvfh,不能仅凭 Zvfhmin。FS=Off 触发非法指令;H 且 V=1 时还须使 vsstatus.FS/VS 已启用。
活动元素满足 vstart≤i<vl 且(vm=1 或 v0[i]=1);省略 v0.t 表示 vm=1。prestart 不修改,inactive/tail 遵循 vma/vta;VL=0 或 vstart≥vl 时目标完全不更新。成功完成后 vstart=0;实现可拒绝其不能产生的非零 vstart。
masked vd 不得重叠 v0;v0 不能同时以 EEW=1 掩码和 SEW 数据源读取。无效 frm 的使用保留,即使不依赖舍入、VL=0 或 vstart≥vl;这不等于规范保证触发非法指令。
分类码占 vd[i] 低 10 位,高位为零;恰好一位为 1,sNaN/qNaN 也不设置 fflags。
V向量运算浮点

指令行为说明

VFCLASS.V 是 RVV 一元浮点分类指令,语法为 vfclass.v vd, vs2, vm;每个活动元素读取 vs2[i] 的浮点编码,并把 10 位 one-hot 分类码写入普通向量数据元素 vd[i] 的低位,高位为 0。分类码 bit 0..9 依次表示负无穷、负正规数、负非正规数、负零、正零、正非正规数、正正规数、正无穷、signaling NaN 和 quiet NaN。

VFCLASS.V 指令解析与执行动画

从 OP-V 编码解码到 VFUNARY1 浮点分类:每个活动元素读取 vs2[i] 的原始浮点编码,并写出 10 位 one-hot 分类码。

输入的指令
vfclass.v
执行环境
LMULm1本动画固定的寄存器组倍数
VLEN4096固定向量寄存器长度(bits)
VLMAX128m1 下的最大元素数
vstart0本动画不展示 prestart 元素
frmRNE本指令不按 frm 舍入
FP stateFS enabledFS=Off 会触发非法指令;本动画固定展示 FS 已启用的架构路径
vta/vmata, ma尾部/非活动元素策略
opcode1010111OP-V 主操作码
vs110000VFUNARY1 分类选择字段
编码字段
0x4c881257
31..26
25
24..20
19..15
14..12
11..7
6..0
010011
funct6
0
vm
01000
vs2
10000
vs1/class
001
funct3
00100
vd
1010111
OP-V
执行数据路径

lane 0: class(0xff800000) bit0 -> 0x001 (-infinity)

显示的 lane 与当前步骤高亮同步;其余逐元素结果位于下方。

步骤 1 / 23
读取 OP-V 编码字段

V 扩展浮点指令使用 OP-V 主操作码,字段包含 funct6、源寄存器、vm、funct3、vd 和 opcode。

逐元素结果
长向量在模块内部横向滚动,不造成页面溢出。
i=0活动
class(0xff800000) bit0
0x001 (-infinity)
i=1活动
class(0xc0200000) bit1
0x002 (-normal)
i=2跳过
v0.t=0,不执行
--
i=3活动
class(0x80000000) bit3
0x008 (-zero)
i=4活动
class(0x00000000) bit4
0x010 (+zero)
i=5活动
class(0x00000001) bit5
0x020 (+subnormal)
i=6跳过
v0.t=0,不执行
--
i=7活动
class(0x7f800000) bit7
0x080 (+infinity)
i=8活动
class(0x7f800001) bit8
0x100 (signaling NaN)
i=9活动
class(0x7fc00000) bit9
0x200 (quiet NaN)
i=10跳过
v0.t=0,不执行
--
i=11活动
class(0xc0200000) bit1
0x002 (-normal)
i=12活动
class(0x80000001) bit2
0x004 (-subnormal)
i=13活动
class(0x80000000) bit3
0x008 (-zero)
i=14跳过
v0.t=0,不执行
--
i=15活动
class(0x00000001) bit5
0x020 (+subnormal)
SEW=32 / binary32 示例按官方 FCLASS 10 类表展示 one-hot 分类码:bit 0..9 分别表示 -inf、-normal、-subnormal、-0、+0、+subnormal、+normal、+inf、sNaN、qNaN。分类不舍入,也不设置 fflags。

教学环境固定 VLEN=4096、LMUL=m1、vstart=0、VS/FS 已启用、所选 SEW 受支持。输入浮点数先表示为相应 binary32/64。VL=0 时不更新任何目标元素;同宽源/目标可重叠。非活动及尾元素遵循 ma/ta,不显示确定数值。

快速理解与检索要点

VFCLASS.V 不产生浮点数或布尔掩码;它把每个活动浮点元素映射成官方 10 类 one-hot 整数分类码。

OP-V 编码中 funct6=010011、funct3=001 选择 VFUNARY1 浮点一元类操作,vs1 字段固定为 10000 选择 VFCLASS。
只对 vl 范围内的活动元素执行;vm=0 使用 v0.t 作为执行掩码,vm=1 表示不使用掩码。
10 位 one-hot 分类码 bit 0..9 分别覆盖 -inf、-normal、-subnormal、-0、+0、+subnormal、+normal、+inf、sNaN、qNaN。
分类结果写入普通向量数据元素低位,高位清零;VFCLASS 不执行舍入,也不设置 fflags。

向量执行上下文

vd、vs2 为 SEW 位向量寄存器组;同 EEW 源/目标可重叠。VFADD.VV 的 vs1 也是同 SEW 向量源,同名源必须读取相同初值;一元指令的 vs1 编码位是固定选择字段。

要求 V、VS/FS 已启用且 vtype 受支持;V 支持 binary32/64,SEW=16 的这些指令需要 Zvfh,不能仅凭 Zvfhmin。FS=Off 触发非法指令;H 且 V=1 时还须使 vsstatus.FS/VS 已启用。

活动元素满足 vstart≤i<vl 且(vm=1 或 v0[i]=1);省略 v0.t 表示 vm=1。prestart 不修改,inactive/tail 遵循 vma/vta;VL=0 或 vstart≥vl 时目标完全不更新。成功完成后 vstart=0;实现可拒绝其不能产生的非零 vstart。

masked vd 不得重叠 v0;v0 不能同时以 EEW=1 掩码和 SEW 数据源读取。无效 frm 的使用保留,即使不依赖舍入、VL=0 或 vstart≥vl;这不等于规范保证触发非法指令。

分类码占 vd[i] 低 10 位,高位为零;恰好一位为 1,sNaN/qNaN 也不设置 fflags。

The RISC-V Instruction Set Manual, Volume I: Unprivileged Architecture — Version 20260120, Chapter 31

常见使用场景

数值分类

假定 V/VS/FS 已启用、frm=RNE、vstart=0、e32,m1 可用、VLMAX≥4 且 a0=4;示例未掩码,全部四个 body 元素执行。初值和结果:v2=[-0,+0,-2.5,+∞] → v1=[0x008,0x010,0x002,0x080]。转换结果按目标整数/浮点类型解释;尾元素按 ta 处理,不假定清零。

NaN/无穷检测

假定 V/VS/FS 已启用、frm=RNE、vstart=0、e32,m1 可用、VLMAX≥4 且 a0=4;示例未掩码,全部四个 body 元素执行。初值和结果:v2=[-0,+0,-2.5,+∞] → v1=[0x008,0x010,0x002,0x080]。转换结果按目标整数/浮点类型解释;尾元素按 ta 处理,不假定清零。

向量化数据清洗

假定 V/VS/FS 已启用、frm=RNE、vstart=0、e32,m1 可用、VLMAX≥4 且 a0=4;示例未掩码,全部四个 body 元素执行。初值和结果:v2=[-0,+0,-2.5,+∞] → v1=[0x008,0x010,0x002,0x080]。转换结果按目标整数/浮点类型解释;尾元素按 ta 处理,不假定清零。

使用前检查清单

语法检查
  • vd、vs2 为 SEW 位向量寄存器组;同 EEW 源/目标可重叠。VFADD.VV 的 vs1 也是同 SEW 向量源,同名源必须读取相同初值;一元指令的 vs1 编码位是固定选择字段。
  • 要求 V、VS/FS 已启用且 vtype 受支持;V 支持 binary32/64,SEW=16 的这些指令需要 Zvfh,不能仅凭 Zvfhmin。FS=Off 触发非法指令;H 且 V=1 时还须使 vsstatus.FS/VS 已启用。
语义检查
  • 活动元素满足 vstart≤i<vl 且(vm=1 或 v0[i]=1);省略 v0.t 表示 vm=1。prestart 不修改,inactive/tail 遵循 vma/vta;VL=0 或 vstart≥vl 时目标完全不更新。成功完成后 vstart=0;实现可拒绝其不能产生的非零 vstart。
  • masked vd 不得重叠 v0;v0 不能同时以 EEW=1 掩码和 SEW 数据源读取。无效 frm 的使用保留,即使不依赖舍入、VL=0 或 vstart≥vl;这不等于规范保证触发非法指令。
  • 分类码占 vd[i] 低 10 位,高位为零;恰好一位为 1,sNaN/qNaN 也不设置 fflags。

容易混淆 / 常见误区

结果写入普通向量数据元素,不是每元素一位的掩码寄存器结果。
结果是 10 位 one-hot 分类码;不要把它当作 VMFEQ/VMFNE 这类 0/1 比较结果。
编码中的 vs1 字段固定为 10000 选择 VFCLASS;汇编语法中没有第二个源向量。
VFCLASS.V 不执行数值舍入,也不设置浮点异常标志。

常见问题

VFCLASS.V 的结果是掩码吗?

不是。它把 10 位 one-hot 分类码写入普通向量数据元素;这不同于 VMFEQ/VMFNE 生成的一位掩码结果。

VFCLASS.V 会因为 NaN 设置 invalid 标志吗?

不会。官方 FCLASS 语义说明分类不会设置浮点异常标志,包括对 signaling NaN 或 quiet NaN 分类。

VFCLASS.V 的 vs1 是什么?

汇编语法只有 vd、vs2 和 vm;编码中的 vs1 字段固定为 10000,用来在 VFUNARY1 空间中选择 classify。