# `loopq`

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

**Loop with rcx as the counter**

Category: Control flow

Decrements rcx by one and jumps to the short target if the counter is non-zero.

x86-64 and later

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

## Flags

| Flag | Effect |
| --- | --- |
| CF | not changed |
| PF | not changed |
| AF | not changed |
| ZF | not changed |
| SF | not changed |
| DF | not changed |
| OF | not changed |

## Forms

- `loopq imm8`

## Operands

- `imm8`: A branch target, written as a label or address. NASM calculates the displacement from the end of the instruction. The displacement must fit a signed byte, `-128` to `127`.

## Description

It leaves flags unchanged. A zero initial counter wraps to its maximum value when decremented.

The q suffix explicitly selects the 64-bit counter and address size. This form requires 64-bit mode. The suffix chooses the counter width, not the branch displacement width.

Write a target label or address. NASM calculates a signed 8-bit displacement from the end of the instruction (−128 through 127 bytes). There is no longer near encoding.

## Example

```x86
global _start

section .text
_start:
        mov rcx, 5          ; the counter this family reads
        xor rax, rax
again:
        add rax, rcx
        cmp rax, 0          ; the conditional forms read the flags too
        loopq again         ; decrements rcx and jumps while it is not zero

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