BitAndString (String function)

Do bitwise And of strings (String class)

[Introduced in Sirius Mods 7.9]

BitAndString does a logical AND of the bits in two strings.

Syntax

%result = string:BitAndString( andBits, [Pad= c])

Syntax terms

%result	A string to receive the result of ANDing together the bits in string and andBits.
string	One of the strings to be ANDed.
andBits	The other string to be ANDed.
Pad	This name required parameter is a single character that indicates the character with which the shorter of the two input strings is to be extended. As many copies of c are used as is required to make the shorter string as long as the longer. If both strings are of equal length, no padding is required. The default value of c is '00':x.

Usage notes

• Using a null string for andBits is an easy way of ANDing each byte in a string with a specific byte value (the Pad value).
• BitAndString is most useful for working with binary data, for example binary data being sent or received with Janus Sockets.

Examples

1. The following example turns off the low order bit of a numeric value's string representation, rounding every digit down to an even number (because EBCDIC binary digits map 0-9 to hex values X'F0'-X'F9'):

   %evenDigits = %digits:bitAndString('', pad='FE':x)

   In the above code, if %digits were '31415926', %evenDigits would be set to '20404826'.

2. The following example:

   printText {~='Red':bitAndString('Green', pad='FF':x)}

   outputs

   'Red':bitAndString('Green', pad='FF':x)=Aaden

   To see why this is correct, run the following:

   printText {~='Red':stringToHex} printText {~='Green':stringToHex} printText {~='Red':bitAndString('Green', pad='FF':x):stringToHex}

   This is the result:

   'Red':stringToHex=D98584 'Green':stringToHex=C799858595 'Red':bitAndString('Green', pad='FF':x):stringToHex=C181848595

See also

BitOffString BitOnString BitOrString BitXorString

BitClearString, BitFlipString, and BitSetString BitValueString BitCountString

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