# `subu`

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

**Subtract unsigned (no overflow trap)**

Category: Arithmetic

Subtracts the third register, or an immediate, from the second and stores the difference in the first, wrapping on overflow instead of trapping.

Used in: [Maximum and unsigned distance](https://asm-editor.specy.app/learn/courses/mips/examples/if-else.md) (MIPS assembly), [Byte length of a string](https://asm-editor.specy.app/learn/courses/mips/examples/string-length.md) (MIPS assembly), [A bouncing ball](https://asm-editor.specy.app/learn/courses/mips/examples/bouncing-ball.md) (MIPS assembly)

## Forms

- `subu $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.

- `subu $t1, $t2, imm32` · Set $t1 to ($t2 minus 32-bit immediate), no overflow
  - `subu $t1,$t2,100000` → `lui $at, hi(imm32)`; `ori $at, $at, lo(imm32)`; `subu $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`.
- `imm32`: A 32-bit immediate, `-2147483648` to `4294967295`. A pseudo-instruction that takes one uses the register `$at` as a temporary, so `$at` loses the value it held.

## Description

No exception is raised on overflow; the result wraps modulo 2^32. The most common subtract instruction in practice.

## Example

```mips
# Subtract 1 from zero without signed-overflow trapping. Inspect $t2: 0xFFFFFFFF.
li $t0, 0
subu $t2, $t0, 1
```
