TBL

Programmable table lookup in one or two vector table (zeroing)

This instruction reads each element of the second source (index) vector and uses its value to select an indexed element from a table of elements consisting of one or two consecutive vector registers, where the first or only vector holds the lower numbered elements, and places the indexed table element in the destination vector element corresponding to the index vector element. If an index value is greater than or equal to the number of vector elements, then it places zero in the corresponding destination vector element.

Since the index values can select any element in a vector this operation is not naturally vector length agnostic.

It has encodings from 2 classes: Single register table and Two register table

Single register table
(FEAT_SVE || FEAT_SME)

313029282726252423222120191817161514131211109876543210
00000101size1Zm001100ZnZd

Encoding

TBL <Zd>.<T>, { <Zn>.<T> }, <Zm>.<T>

Decode for this encoding

if !IsFeatureImplemented(FEAT_SVE) && !IsFeatureImplemented(FEAT_SME) then EndOfDecode(Decode_UNDEF); end; let esize : integer{} = 8 << UInt(size); let n : integer = UInt(Zn); let m : integer = UInt(Zm); let d : integer = UInt(Zd); let double_table : boolean = FALSE;

Two register table
(FEAT_SVE2 || FEAT_SME)

313029282726252423222120191817161514131211109876543210
00000101size1Zm001010ZnZd
op

Encoding

TBL <Zd>.<T>, { <Zn1>.<T>, <Zn2>.<T> }, <Zm>.<T>

Decode for this encoding

if !IsFeatureImplemented(FEAT_SVE2) && !IsFeatureImplemented(FEAT_SME) then EndOfDecode(Decode_UNDEF); end; let esize : integer{} = 8 << UInt(size); let n : integer = UInt(Zn); let m : integer = UInt(Zm); let d : integer = UInt(Zd); let double_table : boolean = TRUE;

Assembler Symbols

<Zd>

Is the name of the destination scalable vector register, encoded in the "Zd" field.

<T>

Is the size specifier, encoded in size:

size <T>
00 B
01 H
10 S
11 D
<Zn>

Is the name of the first source scalable vector register, encoded in the "Zn" field.

<Zm>

Is the name of the second source scalable vector register, encoded in the "Zm" field.

<Zn1>

Is the name of the first scalable vector register of the first source multi-vector group, encoded in the "Zn" field.

<Zn2>

Is the name of the second scalable vector register of the first source multi-vector group, encoded in the "Zn" field.

Operation

CheckSVEEnabled(); let VL : integer{} = CurrentVL(); let elements : integer = VL DIV esize; let indexes : bits(VL) = Z{}(m); var result : bits(VL); let table_size : integer{} = if double_table then VL*2 else VL; let table_elems : integer = table_size DIV esize; var table : bits(table_size); if double_table then let top : bits(VL) = Z{}((n + 1) MOD 32); let bottom : bits(VL) = Z{}(n); table = (top::bottom)[table_size-1:0]; else table = Z{table_size}(n); end; for e = 0 to elements-1 do let idx : integer = UInt(indexes[e*:esize]); result[e*:esize] = if idx < table_elems then table[idx*:esize] else Zeros{esize}; end; Z{VL}(d) = result;

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.