ADDS (immediate)

Add immediate value, setting flags

This instruction adds a register value and an optionally-shifted immediate value, and writes the result to the destination register. It updates the condition flags based on the result.

This instruction is used by the alias CMN (immediate).

313029282726252423222120191817161514131211109876543210
sf01100010shimm12RnRd
opS

Encoding for the 32-bit variant

Applies when (sf == 0)

ADDS <Wd>, <Wn|WSP>, #<imm>{, <shift>}

Encoding for the 64-bit variant

Applies when (sf == 1)

ADDS <Xd>, <Xn|SP>, #<imm>{, <shift>}

Decode for all variants of this encoding

let d : integer{} = UInt(Rd); let n : integer{} = UInt(Rn); let datasize : integer{} = 32 << UInt(sf); let imm : bits(24) = if sh == '0' then Zeros{12}::imm12 else imm12::Zeros{12};

Assembler Symbols

<Wd>

Is the 32-bit name of the general-purpose destination register, encoded in the "Rd" field.

<Wn|WSP>

Is the 32-bit name of the source general-purpose register or stack pointer, encoded in the "Rn" field.

<imm>

Is an unsigned immediate, in the range 0 to 4095, encoded in the "imm12" field.

<shift>

Is the optional left shift to apply to the immediate, defaulting to LSL #0 and encoded in sh:

sh <shift>
0 LSL #0
1 LSL #12
<Xd>

Is the 64-bit name of the general-purpose destination register, encoded in the "Rd" field.

<Xn|SP>

Is the 64-bit name of the source general-purpose register or stack pointer, encoded in the "Rn" field.

Alias Conditions

AliasIs preferred when
CMN (immediate)Rd == '11111'

Operation

let operand1 : bits(datasize) = if n == 31 then SP{datasize}() else X{datasize}(n); let operand2 : bits(datasize) = ZeroExtend{}(imm); var result : bits(datasize); var nzcv : bits(4); (result, nzcv) = AddWithCarry{datasize}(operand1, operand2, '0'); X{datasize}(d) = result; PSTATE.[N,Z,C,V] = nzcv;

Operational information

This instruction is a data-independent-time instruction as described in About PSTATE.DIT.


2026-03_rel 2026-03-26 20:48:11

Copyright © 2010-2026 Arm Limited or its affiliates. All rights reserved. This document is Non-Confidential.