BinaryToInteger (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 43: Line 43:
     %string = '00':hexToString                                     
     %string = '00':hexToString                                     
     printText {%string:binaryToInteger}
     printText {%string:binaryToInteger}
===See also===                                                                                       
[[List of Intrinsic String Methods]]


[[Category:Intrinsic Methods]]
[[Category:Intrinsic Methods]]
[[Category:Intrinsic String Methods]]
[[Category:Intrinsic String Methods]]

Revision as of 22:43, 27 August 2010

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

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

BinaryToInteger syntax

  %num = string:BinaryToInteger([Signed=bool])                                                               

Syntax Terms

%num
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=bool
This name-required argument ('Signed') is a boolean value that indicates whether the method object string is converted to a signed integer. If 'True', the method object 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, Signed is an optional argument that defaults to 'False', which produces an unsigned conversion.

Usage Notes

Examples

Several examples follow.

  • The following statement displays '240':
   printText {'0':binaryToInteger}       
  • The following statement displays '61680':
   printText {'00':binaryToInteger}                              
                                                                 
  • The result of the following pair of statements is '-3856':
   %string = '00'                                                
   printText {%string:binaryToInteger(signed=true)}              
                                                                 
  • The result of the following pair of statements is '0':
   %string = '00':hexToString                                    
   printText {%string:binaryToInteger}

See also

List of Intrinsic String Methods