# `sub`

[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/sub

**Subtract with overflow trap**

Category: Arithmetic

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

Used in: [The 32 registers and their names](https://asm-editor.specy.app/learn/courses/mips/introduction/the-32-registers.md) (MIPS assembly), [The MIPS instruction set](https://asm-editor.specy.app/learn/courses/mips/introduction/the-mips-instruction-set.md) (MIPS assembly), [The bitmap display and keyboard registers](https://asm-editor.specy.app/learn/courses/mips/talking-to-the-outside-world/the-bitmap-display-and-the-keyboard.md) (MIPS assembly), [Moving values around](https://asm-editor.specy.app/learn/courses/mips/examples/moving-values.md) (MIPS assembly), [Variables in memory and constants](https://asm-editor.specy.app/learn/courses/mips/examples/variables-in-memory.md) (MIPS assembly), [A jump table](https://asm-editor.specy.app/learn/courses/mips/examples/jump-table.md) (MIPS assembly), [Read two numbers and print their sum](https://asm-editor.specy.app/learn/courses/mips/examples/sum-of-two-numbers.md) (MIPS assembly), [Drawing shapes on the screen](https://asm-editor.specy.app/learn/courses/mips/examples/drawing-on-the-screen.md) (MIPS assembly), [A bouncing ball](https://asm-editor.specy.app/learn/courses/mips/examples/bouncing-ball.md) (MIPS assembly), [Flappy ASM](https://asm-editor.specy.app/learn/courses/mips/examples/flappy-asm.md) (MIPS assembly)

## Forms

- `sub $t1, $t2, $t3`

## Pseudo-instructions

The processor does not have these forms. The assembler replaces each of them with one or more real instructions. Open a row to see them.

- `sub $t1, $t2, imm`
  - `sub $t1,$t2,-100`: Set $t1 to ($t2 minus 16-bit immediate) → `addi $at, $zero, imm`; `sub $t1, $t2, $at`
  - `sub $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`.
- `$t3`: 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.

## Description

Raises an overflow exception if the true result does not fit in 32 bits. Use 'subu' when overflow should be silently ignored.

## Example

```mips
# Initialize both inputs, then execute sub with initialized inputs. Inspect $t2: 4.
li $t0, 7
li $t1, 3
sub $t2, $t0, $t1
```
