# `sub`

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

Web page: https://asm-editor.specy.app/documentation/x86/instruction/sub

**Subtract**

Category: Arithmetic

Subtracts the source (second) operand from the destination (first) operand and leaves the difference in the destination.

8086 and later

[Intel's reference: SUB](https://intel.github.io/SDM/instruction/SUB.html)

Used in: [The flags register](https://asm-editor.specy.app/learn/courses/x86/introduction/the-flags-register.md) (x86-64 assembly), [Arithmetic, logic and bits](https://asm-editor.specy.app/learn/courses/x86/think-in-assembly/arithmetic-logic-and-bits.md) (x86-64 assembly), [Arrays, strings and the string instructions](https://asm-editor.specy.app/learn/courses/x86/think-in-assembly/arrays-strings-and-the-string-instructions.md) (x86-64 assembly), [The stack, push and pop](https://asm-editor.specy.app/learn/courses/x86/think-in-assembly/the-stack-push-and-pop.md) (x86-64 assembly), [call, ret and the System V convention](https://asm-editor.specy.app/learn/courses/x86/think-in-assembly/call-ret-and-the-system-v-convention.md) (x86-64 assembly), [syscall and the Linux x86-64 ABI](https://asm-editor.specy.app/learn/courses/x86/talking-to-the-outside-world/syscall-and-the-linux-abi.md) (x86-64 assembly), [Fill an array with the numbers from 1 to 10](https://asm-editor.specy.app/learn/courses/x86/examples/counting-loop.md) (x86-64 assembly), [Length of a string](https://asm-editor.specy.app/learn/courses/x86/examples/string-length.md) (x86-64 assembly), [A subroutine with its arguments in registers](https://asm-editor.specy.app/learn/courses/x86/examples/subroutine-with-register-arguments.md) (x86-64 assembly), [Stack arguments and a stack frame](https://asm-editor.specy.app/learn/courses/x86/examples/subroutine-with-stack-arguments.md) (x86-64 assembly)

## Flags

| Flag | Effect |
| --- | --- |
| CF | depends on the result |
| PF | depends on the result |
| AF | depends on the result |
| ZF | depends on the result |
| SF | depends on the result |
| DF | not changed |
| OF | depends on the result |

## Forms

- `sub r/m, reg` (8, 16, 32, 64) · accepts the `lock` prefix with a memory operand
  - `sub r/m8, reg8`
  - `sub r/m16, reg16`
  - `sub r/m32, reg32`: 386 and later
  - `sub r/m64, reg64`
- `sub reg, r/m` (8, 16, 32, 64)
  - `sub reg8, r/m8`
  - `sub reg16, r/m16`
  - `sub reg32, r/m32`: 386 and later
  - `sub reg64, r/m64`
- `sub r/m, imm` (8, 16, 32, 64) · accepts the `lock` prefix with a memory operand
  - `sub r/m16, imm8`
  - `sub r/m32, imm8`: 386 and later
  - `sub r/m64, imm8`
  - `sub r/m8, imm8`
  - `sub r/m16, imm16`
  - `sub r/m32, imm32`: 386 and later
  - `sub r/m64, imm32`
- `sub acc, imm` (8, 16, 32, 64)
  - `sub al, imm8`
  - `sub ax, imm16`
  - `sub eax, imm32`: 386 and later
  - `sub rax, imm32`

## Operands

- `r/m`: A general-purpose register or memory location matching the operation’s size, for example `rax` or `qword [rbp-8]`.
- `reg`: A general-purpose register matching the operation’s size, for example `al`, `ax`, `eax` or `rax`.
- `imm`: An immediate value: a constant written in the instruction as a number, a character or a label, for example `10`, `0x1f`, `'a'` or `msg`. Open a row to see the size it has in each form, such as `imm8` or `imm32`.
- `acc`: The accumulator: `al`, `ax`, `eax` or `rax`, whichever matches the operation’s size. The form accepts no other register in this position.

## Description

CF reports unsigned borrow; OF reports signed overflow.

The destination is a register or memory operand; the source is a register, memory operand or immediate, with at most one memory operand. Register and memory operands have the same width. When the instruction writes a 32-bit register, that write clears the upper half of its 64-bit register.

An 8-bit immediate used with a wider operand is sign-extended from −128 through 127. For a 64-bit operation, the longer immediate field is only 32 bits and is also sign-extended; there is no full 64-bit immediate form. The encoded bits determine the value used by the operation. For example, a 32-bit field of `0xffffffff` becomes `0xffffffffffffffff` (−1), not positive 4294967295. An out-of-range constant can produce a warning and truncated bits; use a register for a value that cannot be represented by these sign extensions.

NASM normally chooses the short immediate encoding when it preserves the value; a `byte` qualifier is not required. `strict` with an immediate size can prevent that shortening.

## Example

```x86
global _start

section .text
_start:
        mov rax, 12
        mov rbx, 5
        mov rcx, 3
        mov rsi, 9

        sub rax, rbx

        mov rax, 60         ; syscall 60: exit
        xor rdi, rdi
        syscall
```
