# `subi`

[MIPS Documentation](https://asm-editor.specy.app/documentation/mips.md) › [Instructions](https://asm-editor.specy.app/documentation/mips/instruction.md)

Web page: https://asm-editor.specy.app/documentation/mips/instruction/subi

**Subtract immediate with overflow trap** · Pseudo-instruction

Category: Arithmetic

Subtracts an immediate from the second register and stores the difference in the first, trapping if the signed result overflows.

## Forms

- `subi $t1, $t2, imm`
  - `subi $t1,$t2,-100`: Set $t1 to ($t2 minus 16-bit immediate) → `addi $at, $zero, imm`; `sub $t1, $t2, $at`
  - `subi $t1,$t2,100000`: Set $t1 to ($t2 minus 32-bit immediate) → `lui $at, hi(imm)`; `ori $at, $at, lo(imm)`; `sub $t1, $t2, $at`

## Operands

- `$t1`: Any general-purpose register, `$0` to `$31`, using its numeric or named spelling, such as `$8` or `$t0` (`$zero` is `$0`; `$ra` is `$31`).
- `$t2`: A general-purpose register. It may be the same register as `$t1`.
- `imm`: An immediate value: a signed 16-bit value (`-32768` to `32767`) or a 32-bit value (`-2147483648` to `4294967295`). The size your value needs decides which real instructions the assembler uses. Open the row to see them for each size.

## Example

```mips
# Subtract immediate 3 from 7. Inspect $t2: 4.
li $t0, 7
subi $t2, $t0, 3
```
