# `add`

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

Category: Arithmetic

Adds the source (second) operand to the destination (first) operand and leaves the sum in the destination.

8086 and later

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

Used in: [Getting started with x86-64](https://asm-editor.specy.app/learn/courses/x86/introduction/getting-started.md) (x86-64 assembly), [Memory, little endian and sizes](https://asm-editor.specy.app/learn/courses/x86/introduction/memory-little-endian-and-sizes.md) (x86-64 assembly), [Bytes, words, dwords and qwords](https://asm-editor.specy.app/learn/courses/x86/introduction/bytes-words-dwords-and-qwords.md) (x86-64 assembly), [The x86-64 instruction set](https://asm-editor.specy.app/learn/courses/x86/introduction/the-x86-instruction-set.md) (x86-64 assembly), [The flags register](https://asm-editor.specy.app/learn/courses/x86/introduction/the-flags-register.md) (x86-64 assembly), [Loops](https://asm-editor.specy.app/learn/courses/x86/think-in-assembly/loops.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)

## 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

- `add r/m, reg` (8, 16, 32, 64) · accepts the `lock` prefix with a memory operand
  - `add r/m8, reg8`
  - `add r/m16, reg16`
  - `add r/m32, reg32`: 386 and later
  - `add r/m64, reg64`
- `add reg, r/m` (8, 16, 32, 64)
  - `add reg8, r/m8`
  - `add reg16, r/m16`
  - `add reg32, r/m32`: 386 and later
  - `add reg64, r/m64`
- `add r/m, imm` (8, 16, 32, 64) · accepts the `lock` prefix with a memory operand
  - `add r/m16, imm8`
  - `add r/m32, imm8`: 386 and later
  - `add r/m64, imm8`
  - `add r/m8, imm8`
  - `add r/m16, imm16`
  - `add r/m32, imm32`: 386 and later
  - `add r/m64, imm32`
- `add acc, imm` (8, 16, 32, 64)
  - `add al, imm8`
  - `add ax, imm16`
  - `add eax, imm32`: 386 and later
  - `add 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 carry; 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

        add rax, rbx

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