# `sw`

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

**Store word**

Category: Load and store

Stores the 32-bit value in the first register at the address in the second plus an offset; the address must be word-aligned.

Used in: [Loads, stores and immediates](https://asm-editor.specy.app/learn/courses/mips/introduction/loads-stores-and-immediates.md) (MIPS assembly), [The stack and $sp](https://asm-editor.specy.app/learn/courses/mips/think-in-assembly/the-stack-and-sp.md) (MIPS assembly), [jal, jr, and the course calling convention](https://asm-editor.specy.app/learn/courses/mips/think-in-assembly/jal-jr-and-the-calling-convention.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), [Exceptions and coprocessor 0](https://asm-editor.specy.app/learn/courses/mips/talking-to-the-outside-world/exceptions-and-coprocessor-0.md) (MIPS assembly), [Variables in memory and constants](https://asm-editor.specy.app/learn/courses/mips/examples/variables-in-memory.md) (MIPS assembly), [Fill an array with a guarded counting loop](https://asm-editor.specy.app/learn/courses/mips/examples/counting-loop.md) (MIPS assembly), [Stack arguments and a stack frame](https://asm-editor.specy.app/learn/courses/mips/examples/subroutine-with-stack-arguments.md) (MIPS assembly), [Recursion: factorial and Fibonacci](https://asm-editor.specy.app/learn/courses/mips/examples/factorial-and-fibonacci.md) (MIPS assembly), [Bubble sort](https://asm-editor.specy.app/learn/courses/mips/examples/bubble-sort.md) (MIPS assembly)

## Forms

- `sw $t1, imm16($t2)`

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

- `sw $t1, %lo(label)($t2)` · Write to label's address, reached through the %hi already in $t2
  - `sw $t1,%lo(label)($t2)` → `sw $t1, lo(label)($t2)`

Store $t1 contents into effective memory word address

- `sw $t1, ($t2)`
  - `sw $t1,($t2)` → `sw $t1, 0($t2)`
- `sw $t1, imm`
  - `sw $t1,-100` → `sw $t1, imm($zero)`
  - `sw $t1,100` → `ori $at, $zero, imm`; `sw $t1, 0($at)`
  - `sw $t1,100000` → `lui $at, hi(imm)`; `sw $t1, lo(imm)($at)`
- `sw $t1, imm($t2)`
  - `sw $t1,100($t2)` → `ori $at, $zero, imm`; `addu $at, $at, $t2`; `sw $t1, 0($at)`
  - `sw $t1,100000($t2)` → `lui $at, hi(imm)`; `addu $at, $at, $t2`; `sw $t1, lo(imm)($at)`
- `sw $t1, label($t2)`
  - `sw $t1,label($t2)` → `lui $at, hi(label)`; `addu $at, $at, $t2`; `sw $t1, lo(label)($at)`
- `sw $t1, label+imm32`
  - `sw $t1,label+100000` → `lui $at, hi(label+imm32)`; `sw $t1, lo(label+imm32)($at)`
- `sw $t1, label+imm32($t2)`
  - `sw $t1,label+100000($t2)` → `lui $at, hi(label+imm32)`; `addu $at, $at, $t2`; `sw $t1, lo(label+imm32)($at)`

- `sw $t1, label` · Store $t1 contents into memory word at label's address
  - `sw $t1,label` → `lui $at, hi(label)`; `sw $t1, lo(label)($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`).
- `imm16`: A signed 16-bit immediate, `-32768` to `32767`.
- `$t2`: A general-purpose register. It may be the same register as `$t1`.
- `label`: A named address in the program, such as the start of a loop or a variable in `.data`.
- `imm`: An immediate value: a signed 16-bit value (`-32768` to `32767`), an unsigned 16-bit value (`0` to `65535`) 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.
- `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

The address must be word-aligned (divisible by 4). Example: 'sw $t0,0($sp)' stores a value at the top of the stack.

## Example

```mips
.data
.align 2
data: .word 0
.text
# Write initialized value 0x12345678 with sw; inspect data bytes after the instruction: [0x78, 0x56, 0x34, 0x12].
la $t1, data
li $t0, 0x12345678
sw $t0, 0($t1)
```
