Automatic control function programming manual ladder language

6.2 Convert an ASCII String to a Signed Integer of 32 Bits atoj
Syntax
6 - 4 en-938846/7
atoj(&&end, &source)
&&end: Address of the long word (%M or %V) to be loaded with the address
of the character on which conversion was stopped.
&source: Address of the ASCII string to be converted.
Returns a signed integer on 32 bits resulting from conversion of the ASCII string.
Operation
Conversion is stopped when a ZERO byte or a character other than a decimal digit is detected.
This function operates in the same way as atoi(). Function atoj() loads address &&end with the address of the character
on which conversion was stopped or zero if the end of the string was reached.
In case of overflow, atoj() returns the maximum positive value of a signed integer on 32 bits, i.e. 0x7FFFFFFF.
The long word at address &&end is loaded with:
- 0 if conversion was stopped on a ZERO byte at the end of the string,
- the address of the (nonzero) character on which conversion was stopped,
- -1 in case of overflow.
Return code
If OK
Signed integer on 32 bits resulting from the conversion
Error
0x7FFFFFFF: Overflow of conversion of a signed integer on 32 bits.
Programming error causing a CPU fault
Access to a prohibited address:
- &source parameter error,
- &&end parameter error,
- end of string outside authorised area.