HPlogo MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions (ABORTSESS - FCLOSE)

DBINARY

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Converts a numeric ASCII string to a 32-bit binary value. The numeric ASCII string can be octal, hexadecimal, or decimal.

Syntax



  I32                 CA         I16V
  dbineqv := DBINARY (dasciieqv, length);

Functional Return


dbineqv

32-bit signed integer (assigned functional return)

Returns the converted 32-bit binary value.

Parameters


dasciieqv

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 string begins with a plus sign, 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)

Returns 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.

  • If the value of length is negative, the intrinsic causes the process to abort.

Condition Codes


CCE (2)Request granted. A 32-bit binary value is returned to the process.
CCG (0)Request denied. A word overflow, possibly resulting from too many characters (dasciieqv number too large), occurred in the value (dbineqv) returned.
CCL (1)Request denied. An illegal character was encountered in dasciieqv. For example, the digits 8 or 9 were specified in an octal value.

Related Information


Intrinsics ASCII, BINARY, CTRANSLATE, DASCII, HPFPCONVERT
Manuals Data Types Conversion Programmer's Guide




DATELINE


DEBUG