BinaryToInteger (String function)

Convert a binary string to an integer (String class)

BinaryToInteger is an intrinsic function that treats a string as if it were binary and converts it to an integer. The string may contain no more than four characters.

Syntax

%number = string:BinaryToInteger[( [Signed= boolean])]

Syntax terms

%number	A numeric variable to receive the integer value of the method object string.
string	A binary string value. The string's length must be four characters or less, but greater than zero.
Signed	This is an optional, but NameRequired, argument is a boolean enumeration; if you specify a value, the parameter name Signed is required. Signed is a boolean enumeration value that indicates whether the method object string is converted to a signed integer. Signed is an optional argument that defaults to False, which produces an unsigned conversion. If Signed=True, the method object string is treated as if it were preceded by a negative sign, a two's complement conversion is performed, and the returned value is preceded by a negative sign.

Usage notes

• The BinaryToInteger function is available as of Sirius Mods version 7.3.

Examples

1. The following statement displays 240:

   printText {'0':binaryToInteger}

2. The following statement displays 61680:

   printText {'00':binaryToInteger}

3. The result of the following pair of statements is -3856:

   %string = '00' printText {%string:binaryToInteger(signed=true)}

4. The result of the following pair of statements is 0:

   %string = '00':hexToString printText {%string:binaryToInteger}

See also

• For information about the PrintText statement, pleae see printText.
• The inverse of BinaryToInteger is IntegerToBinary.

Float class String class Unicode class	List of Float methods List of String methods List of Unicode methods List of Intrinsic methods	Float methods syntax String methods syntax Unicode methods syntax
Notation conventions for methods