


bstring
const type: bstring 
Type for byte strings.
Operator Summary 
bstring 
(attr bstring) parse (in string: stri) 
 Convert a string to a bstring value.  
char 
(in bstring: bstri) [ (in integer: index) ] 
 Get a character, identified by an index, from a bstring.  
boolean 
(in bstring: bstri1) = (in bstring: bstri2) 
 Check if two bstrings are equal.  
boolean 
(in bstring: bstri1) <> (in bstring: bstri2) 
 Check if two bstrings are not equal.  
Function Summary 
string 
str (in bstring: bstri) 
 Convert a bstring value to a string.  
integer 
length (in bstring: bstri) 
 Determine the length of a bstring.  
integer 
hashCode (in bstring: bstri) 
 Compute the hash value of a bstring.  
integer 
compare (in bstring: bstri1, in bstring: bstri2) 
 Compare two bstrings.  
bigInteger 

bigInteger 

bstring 

bstring 

parse
const func bstring: (attr bstring) parse (in string: stri) 
Convert a string to a bstring value.
 Returns:
 the bstring result of the conversion.
 Raises:
 RANGE_ERROR  When characters beyond '\255;' are present.
 MEMORY_ERROR  Not enough memory to represent the result.
[
const func char: (in bstring: bstri) [ (in integer: index) ] 
Get a character, identified by an index, from a bstring.
The first character has the index 1.
 Returns:
 the character specified with the index.
 Raises:
 RANGE_ERROR  When the index is less than 1 or greater than the length of the bstring.
=
const func boolean: (in bstring: bstri1) = (in bstring: bstri2) 
Check if two bstrings are equal.
 Returns:
 TRUE if both bstrings are equal, FALSE otherwise.
<>
const func boolean: (in bstring: bstri1) <> (in bstring: bstri2) 
Check if two bstrings are not equal.
 Returns:
 FALSE if both bstrings are equal, TRUE otherwise.
str
const func string: str (in bstring: bstri) 
Convert a bstring value to a string.
 Returns:
 the string result of the conversion.
 Raises:
 MEMORY_ERROR  Not enough memory to represent the result.
length
const func integer: length (in bstring: bstri) 
Determine the length of a bstring.
 Returns:
 the length of the bstring.
hashCode
const func integer: hashCode (in bstring: bstri) 
Compute the hash value of a bstring.
 Returns:
 the hash value.
compare
const func integer: compare (in bstring: bstri1, in bstring: bstri2) 
Compare two bstrings.
 Returns:
 1, 0 or 1 if the first argument is considered to be respectively less than, equal to, or greater than the second.
bStriBe2BigInt
const func bigInteger: bStriBe2BigInt (in bstring: bstri,
in boolean: isSigned) 
Convert a bstring (interpreted as bigendian) to a bigInteger.
 Parameters:
 bstri  Bstring to be converted. The bytes are interpreted as binary bigendian representation with a base of 256.
 isSigned  Defines if bstri is interpreted as signed value. When isSigned is TRUE the twoscomplement representation is used. In this case the result is negative when the most significant byte (the first byte) has an ordinal >= 128.
 Returns:
 a bigInteger created from the bigendian bytes.
bStriLe2BigInt
const func bigInteger: bStriLe2BigInt (in bstring: bstri,
in boolean: isSigned) 
Convert a bstring (interpreted as littleendian) to a bigInteger.
 Parameters:
 bstri  Bstring to be converted. The bytes are interpreted as binary littleendian representation with a base of 256.
 isSigned  Defines if bstri is interpreted as signed value. When isSigned is TRUE the twoscomplement representation is used. In this case the result is negative when the most significant byte (the last byte) has an ordinal >= 128.
 Returns:
 a bigInteger created from the littleendian bytes.
bStriBe
const func bstring: bStriBe (in bigInteger: number,
in boolean: isSigned) 
Convert a bigInteger into a bigendian bstring.
The result uses binary representation with a base of 256.
 Parameters:
 number  BigInteger number to be converted.
 isSigned  Determines the signedness of the result. When isSigned is TRUE the result is encoded with the twoscomplement representation. In this case a negative number is converted to a result where the most significant byte (the first byte) has an ordinal >= 128.
 Returns:
 a bstring with the bigendian representation.
 Raises:
 RANGE_ERROR  When number is negative and isSigned is FALSE.
 MEMORY_ERROR  Not enough memory to represent the result.
bStriLe
const func bstring: bStriLe (in bigInteger: number,
in boolean: isSigned) 
Convert a bigInteger into a littleendian bstring.
The result uses binary representation with a base of 256.
 Parameters:
 number  BigInteger number to be converted.
 isSigned  Determines the signedness of the result. When isSigned is TRUE the result is encoded with the twoscomplement representation. In this case a negative number is converted to a result where the most significant byte (the last byte) has an ordinal >= 128.
 Returns:
 a bstring with the littleendian representation.
 Raises:
 RANGE_ERROR  When number is negative and isSigned is FALSE.
 MEMORY_ERROR  Not enough memory to represent the result.


