BINARY

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

Related Information