BitOffString (String function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
Line 21: Line 21:
<li>Using a null <var class="term">string</var> for <var class="term">offBits</var> is an easy way of turning off a specific set of bits for each byte in a string (the <var class="term">pad</var> value).
<li>Using a null <var class="term">string</var> for <var class="term">offBits</var> is an easy way of turning off a specific set of bits for each byte in a string (the <var class="term">pad</var> value).
<li><var>BitOffString</var> is most useful for working with binary data, for example binary data being sent or received with <var class="product">[[Janus Sockets]]</var>.
<li><var>BitOffString</var> is most useful for working with binary data, for example binary data being sent or received with <var class="product">[[Janus Sockets]]</var>.
<li><var>BitOffString</var> was introduced in <var class="product">[[Sirius Mods|Sirius Mods]]</var> version 7.9.
</ul>
</ul>



Revision as of 21:31, 17 February 2012

Clear bits in one string from another (String class)

[Introduced in Sirius Mods 7.9]


BitOffString turns off a set of bits in one string as indicated by another.

Syntax

%result = string:BitOffString( offBits, [Pad= c])

Syntax terms

%resultA string to receive the result of turning off the bits in offBits for string.
string The string to turn off bits in.
offBits The bits to turn off.
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 for offBits is an easy way of turning off a specific set of bits for each byte in a string (the pad value).
  • BitOffString is most useful for working with binary data, for example binary data being sent or received with Janus Sockets.

See also