 |
» |
|
|
 |
NM and CM callable. Converts a numeric (octal or decimal) ASCII string to a 16-bit
twos complement binary value. Syntax |  |
I16 CA I16V bineqv:=BINARY(asciieqv,length); |
Functional Return |  |
- bineqv
16-bit signed integer (assigned functional
return) Passes the twos complement binary equivalent of the
numeric string.
Parameters |  |
- asciieqv
character array (required) Passes the octal or signed-decimal number (in ASCII
characters) to be converted. If the character string begins with
a percent sign (%), it is treated as an octal value. If the character
string begins with a dollar sign ($), it is treated as a hexadecimal value. In this
case, the string must be less than 6 characters and only 0 through
9, a through f, and A through F are allowed. The maximum hex strings
are $ffff and $7fff. If the character string begins with a plus
sign, a minus sign, or a number, it is treated as a decimal value.
Leading blanks are not allowed and are treated as illegal characters. - length
16-bit signed integer by value (required) Passes the length (number of bytes) of the ASCII-coded
value. If the value of length is 0, the intrinsic returns 0 to the calling process.
When the value of length is negative, the intrinsic causes the process to abort.
Condition Codes |  |
- CCE (2)
Request granted. A 16-bit binary value is returned
to the process. - CCG (0)
Request denied. A word overflow, possibly resulting
from too many characters (asciieqv number too large), occurred in the value returned. - CCL (1)
Request denied. An illegal character was encountered
in asciieqv. For example, the digits 8 or 9 were specified in an
octal value.
Related Information |  |
- Intrinsics
DBINARY - Commands
None - Manuals
Data Types Conversion Programmer's Guide
|