BitXorString (String function)

Do bitwise exclusive Or of strings (String class)

[Introduced in Sirius Mods 7.9]

BitXorString does a logical XOR (exclusive OR) of the bits in two strings.

Syntax

%result = string:BitXorString( xorBits, [Pad= c])

Syntax terms

%result	A string to receive the result of XORing together the bits in string and xorBits.
string	One of the strings to be XORed.
xorBits	The other string to be XORed.
Pad	A single character that indicates the character with which the shorter of the two input strings is to be extended. As many copies of pad 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 pad is '00':x.

Usage notes

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

Examples

The following example compares the result of BitXorString (logical exclusive OR) versus BitOrString (logical inclusive OR):

b printText {~='Ale':stringToHex} printText {~='Lager':stringToHex} print '======================' printText {~='Ale':bitOrString('Lager', pad='40':x)} printText {~='Ale':bitOrString('Lager', pad='40':x):stringToHex} print '======================' printText {~='Ale':bitXorString('Lager', pad='40':x)} printText {~='Ale':bitXorString('Lager', pad='40':x):stringToHex} end

The result is:

'Ale':stringToHex=C19385 'Lager':stringToHex=D381878599 ====================== 'Ale':bitOrString('Lager', pad='40':x)=LlgER 'Ale':bitOrString('Lager', pad='40':x):stringToHex=D39387C5D9 ====================== 'Ale':bitXorString('Lager', pad='40':x)=???ER 'Ale':bitXorString('Lager', pad='40':x):stringToHex=121202C5D9

See also

• BitAndString
• BitOffString
• BitOnString
• BitOrString

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