先看 vl
当前 vl 决定 body 元素数量。典型代码会先执行 vsetvli、vsetivli 或 vsetvl，再执行本页指令。
VMSIF.M
RISC-V VMSIF.M 指令详解
指令手册R-type把第一个 active set mask bit 及其之前的位置置 1
指令语法
vmsif.m vd, vs2, vm
操作数说明
vd：掩码目标寄存器，每个元素产生一位布尔结果。
vs2/vs1 或标量源：按当前 SEW 参与比较。
vm：vm=0 使用 v0 限制参与比较的元素，vm=1 为未掩码。
V向量掩码操作
指令行为说明
VMSIF.M 扫描 vs2 源掩码，找到第一个 active 且为 1 的元素，并把该 first 及其之前的 active 位置写为 1；之后的位置写为 0。
VMSIF.M 指令解析与执行动画
从 OP-V 编码字段开始，展示 VMSIF.M 如何把第一个 active set bit 及其之前的位置置 1。
输入的指令
vmsif.m
OP-V encodingfunct6 | vm | vs2 | vs1=00011 | funct3 | vd | opcode
funct6
010100
vm
0
vs2
01000
vs1
00011
funct3
010
vd
00100
opcode
1010111
lane
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
v8
0
0
1
0
1
0
1
0
0
1
0
0
1
0
0
1
v0.t
1
0
1
1
1
1
0
1
1
1
1
0
1
1
1
1
scan
1
off
1
0
0
0
off
0
0
0
0
off
0
0
0
0
v4
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
当前步骤
显示 OP-V 32 位编码字段
vmsif.m 使用 OP-V 编码；vs1 字段固定为 00011，语法中没有 vs1 操作数。
动画只展示官方 V 扩展定义的 ISA 可见关系：OP-V 字段解析、vl 内 active mask bit 扫描、目标 mask bit 写回；不模拟流水线、缓存或执行时延。
快速理解与检索要点
VMSIF.M 生成“包含 first”的前缀 mask：first 本身也置 1。
源操作数 vs2 按 mask register layout 解释；每个元素只对应一个 mask bit，不按 SEW 读取整数元素。
只扫描当前 vl 范围内的 body 元素；vm=0 时，v0.t 为 0 的元素不参与 first 查找或计数。
官方说明要求这些指令在 vstart 非零时保留为非法指令异常；动画只展示 vstart=0 的正常路径。
目标 vd 是 mask 结果；VMSIF.M 对 first 及之前的 active 位置写 1，对之后写 0。
目标 mask 寄存器 vd 不得与源 vs2 重叠；masked 执行时 vd 也不得与 v0 重叠。
masked-off 目标元素不是确定的 0，实际值由当前 mask policy 决定；mask 结果的尾部元素按 tail-agnostic 处理。
向量执行上下文
阅读 VMSIF.M 时，不要只看助记符。官方 V 扩展语义还依赖当前 vl、vtype 和掩码状态。后缀和操作数形式决定源操作数来自向量、标量还是立即数。
再看 vtype
当前 vtype 提供 SEW、LMUL、tail policy 和 mask policy；这些规则影响元素宽度、寄存器组大小以及非活动/尾部目标元素。
最后看 vm/v0
带 vm 的普通向量指令在 vm=0 时用 v0 作为执行掩码，vm=1 表示未掩码。VMERGE 等少数形式会把 v0 当作数据选择输入。
常见使用场景
循环终止条件
结合 «vmsif.m v1, v0» 等实际代码理解该场景。
数据依赖退出
结合 «vmsif.m v1, v0» 等实际代码理解该场景。
使用前检查清单
语法检查
- 确认当前指令格式为 R-type。
- 确认操作数排列顺序与示例一致。
语义检查
- 确认目标寄存器用途和调用约定兼容。
- 确认该指令不是伪指令展开后的底层形式。
容易混淆 / 常见误区
vmsbf.m/vmsif.m/vmsof.m 在 first 位置的输出不同：before 不包含 first，including 包含 first，only 只保留 first。
目标 vd 不得与源 vs2 重叠；masked 执行时目标 vd 也不得与 v0 重叠。
vstart 非零会触发非法指令异常。
masked-off 目标元素不应被当成确定的 0；其值由当前 mask policy 决定，尾部元素按 tail-agnostic 处理。
常见问题
VMSIF.M 和 VMSBF.M 的区别是什么？
VMSIF.M 包含 first 位置；VMSBF.M 不包含 first 位置。