14.19 LENGTH (Search String Length (Terminating NULL))
■
Instruction format
■
List of operands
Operand Description
S1 The starting address of the string to be searched is specified.
S2
The starting device address for storing the maximum searched string length or a constant is
specified. (Available range: 1 to 4096)
D The starting address storing string length is specified.
■
Available devices (●: Available)
Operan
d
16-Bit device:
32-Bit
device:
Integer
Real
numbe
r
St
rin
g
Index
modifie
r
W
X
W
Y
W
R
W
L
W
S
S
D
D
T
L
D
U
M
WI
W
O
TS
C
S
TE
C
E
IX K U H SF
D
F
" "
S1 ● ● ● ● ● ● ●
S2 ● ● ● ● ● ● ● ● ● ● ●
D ● ● ● ● ● ● ●
■
Outline of operation
This instruction detects a termination character (null) from a string and acquires the number of
characters. Null characters are not included in the number of characters.
■
Processing
● Searches the length of the string specified by [S1].
● Searches NULL characters for the number of characters specified by [S2] (maximum string
length) from [S1], and stores the string length excluding NULL characters in [D] (result) when
NULL characters exist.
● When there is no NULL character within the maximum string length [S2], the CY (SR9) flag is
set, and the maximum string length is stored in the result [D].
● When a NULL character is found, the CY (SR9) flag is not cleared.
14.19 LENGTH (Search String Length (Terminating NULL))
WUME-FP7CPUPGR-12 14-87