BitOnString and BitOrString (String functions) - Revision history

ELowell at 20:25, 3 September 2015

2015-09-03T20:25:39Z

← Older revision		Revision as of 20:25, 3 September 2015
Line 1:		Line 1:
	{{Template:String:BitOnString and BitOrString subtitle}}		{{Template:String:BitOnString and BitOrString subtitle}}

	These functions do a logical OR of the binary bits in two strings: that is, if the bits are "on" in either of the inputs, they are "on" in the output.		These functions do a logical OR of the binary bits in two strings: that is, if the bits are "on" in either of the inputs, they are "on" in the output.

Line 9:		Line 8:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%result</th><td>A string to receive the result of the logical OR operation on the bits of <var class="term">string</var> and <var class="term">onBits</var> (or <var class="term">string</var> and <var class="term">orBits</var>).</td></tr>		<tr><th nowrap>%result</th><td>A string to receive the result of the logical OR operation on the bits of <var class="term">string</var> and <var class="term">onBits</var> (or <var class="term">string</var> and <var class="term">orBits</var>).</td></tr>

	<tr><th>string</th>		<tr><th>string</th>

Admin: /* See also */

2013-03-22T01:06:40Z

Admin: /* See also */

2013-03-21T23:28:47Z

JAL at 22:41, 1 November 2012

2012-11-01T22:41:13Z

← Older revision		Revision as of 22:41, 1 November 2012
Line 1:		Line 1:
	{{Template:String:BitOnString and BitOrString subtitle}}		{{Template:String:BitOnString and BitOrString subtitle}}
	These functions do a logical OR of the bits in two strings, that is, ~~output~~ bits are "on" if they are "on" in ~~either of~~ the ~~inputs~~.
			These functions do a logical OR of the binary bits in two strings: that is, if the bits are "on" in either of the inputs, they are "on" in the output.

	==Syntax==		==Syntax==
	{{Template:String:BitOnString syntax}}		{{Template:String:BitOnString syntax}}
	{{Template:String:BitOrString syntax}}		{{Template:String:BitOrString syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%result</th><td>A string to receive the result of ~~combinining~~ the bits in <var class="term">string</var> and <var class="term">orBits</var> ~~as a result of the logical OR operation~~.</td></tr>		<tr><th>%result</th><td>A string to receive the result of the logical OR operation on the bits of <var class="term">string</var> and <var class="term">onBits</var> (or <var class="term">string</var> and <var class="term">orBits</var>).</td></tr>

	<tr><th>string</th>		<tr><th>string</th>
	<td>~~One of the strings in the logical OR operation~~.</td></tr>		<td>A string.</td></tr>
	~~<!--~~<tr><th>onBits</th>
	<td>A string ~~that specifies~~ the ~~bits to set~~.</td></tr>~~-->~~		<tr><th>onBits</th>
	<tr><th>~~onBits~~ orBits</th>		<td>A string to be combined via bit-wise OR with the method object, <var class="term">string</var>.</td></tr>
	<td>~~The other~~ string in the ~~logical OR operation~~.</td></tr>
			<tr><th>orBits</th>
			<td>A string to be combined via bit-wise OR with the method object, <var class="term">string</var>.</td></tr>

	<tr><th><var>Pad</var></th>		<tr><th><var>Pad</var></th>
	<td>A single character ~~that indicates the character~~ with which the shorter of the two input strings is to be extended. As many copies of <var class="term">c</var> 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 <var class="term">c</var> is <code>'00':x</code>.</td></tr>		<td>This [[Notation conventions for methods#Named parameters\|name required]] parameter is the single-character value with which the shorter of the two input strings is to be extended. As many copies of <var class="term">c</var> 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.
			<p>
			The default value of <var class="term">c</var> is <code>'00':x</code>.</p></td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>Using a null ~~<var class="term">~~string~~</var>~~ for <var class="term">orBits</var> is an easy way of ORing each byte in a string with a specific byte value (the <var ~~class="term"~~>~~pad~~</var> value).		<li>Using a null string for <var class="term">orBits</var> is an easy way of ORing each byte in a <var class="term">string</var> with a specific byte value (the <var>Pad</var> value).

	<li><var>BitOrString</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>BitOrString</var> is most useful for working with binary data, for example binary data being sent or received with <var class="product">[[Janus Sockets]]</var>.
	</ul>		</ul>

Dme: /* Syntax terms */

2012-09-29T20:54:59Z

Syntax terms

← Older revision		Revision as of 20:54, 29 September 2012
Line 12:		Line 12:
	<!--<tr><th>onBits</th>		<!--<tr><th>onBits</th>
	<td>A string that specifies the bits to set.</td></tr>-->		<td>A string that specifies the bits to set.</td></tr>-->
	<tr><th>orBits ~~onBits~~</th>		<tr><th>onBits orBits</th>
	<td>The other string in the logical OR operation.</td></tr>		<td>The other string in the logical OR operation.</td></tr>
	<tr><th><var>Pad</var></th>		<tr><th><var>Pad</var></th>

Dme: /* Syntax terms */

2012-09-29T20:54:08Z

Syntax terms

← Older revision		Revision as of 20:54, 29 September 2012
Line 10:		Line 10:
	<tr><th>string</th>		<tr><th>string</th>
	<td>One of the strings in the logical OR operation.</td></tr>		<td>One of the strings in the logical OR operation.</td></tr>
	<tr><th>orBits</th>		<!--<tr><th>onBits</th>
			<td>A string that specifies the bits to set.</td></tr>-->
			<tr><th>orBits onBits</th>
	<td>The other string in the logical OR operation.</td></tr>		<td>The other string in the logical OR operation.</td></tr>
	<tr><th><var>Pad</var></th>		<tr><th><var>Pad</var></th>

Dme at 20:48, 29 September 2012

2012-09-29T20:48:13Z

← Older revision		Revision as of 20:48, 29 September 2012
Line 1:		Line 1:
	{{Template:String:BitOrString subtitle}}		{{Template:String:BitOnString and BitOrString subtitle}}
			These functions do a logical OR of the bits in two strings, that is, output bits are "on" if they are "on" in either of the inputs.
	~~<var>BitOrString</var> does~~ a logical OR of the bits in two strings.

	==Syntax==		==Syntax==
			{{Template:String:BitOnString syntax}}
	{{Template:String:BitOrString syntax}}		{{Template:String:BitOrString syntax}}
	===Syntax terms===		===Syntax terms===

Dme: moved BitOrString (String function) to BitOnString and BitOrString (String functions)

2012-09-29T20:46:23Z

moved BitOrString (String function) to BitOnString and BitOrString (String functions)

← Older revision	Revision as of 20:46, 29 September 2012
(No difference)

JAL2: /* Examples */

2012-06-05T18:58:47Z

Examples

← Older revision		Revision as of 18:58, 5 June 2012
Line 26:		Line 26:
	<p class="pre">%upper = %lower:bitOrString('', pad='40':x)		<p class="pre">%upper = %lower:bitOrString('', pad='40':x)
	</p>		</p>
	In, the above code, if <code>%lower</code> were <code>'foobar'</code>, <code>%upper</code> would be set to <code class="output">'FOOBAR'</code>.		In the above code, if <code>%lower</code> were <code>'foobar'</code>, <code>%upper</code> would be set to <code class="output">'FOOBAR'</code>.

	==See also==		==See also==

JAL2: /* Syntax terms */

2012-03-30T21:26:45Z

Syntax terms

← Older revision		Revision as of 21:26, 30 March 2012
Line 13:		Line 13:
	<td>The other string in the logical OR operation.</td></tr>		<td>The other string in the logical OR operation.</td></tr>
	<tr><th><var>Pad</var></th>		<tr><th><var>Pad</var></th>
	<td>A single character that indicates the character with which the shorter of the two input strings is to be extended. As many copies of <var class="term">~~pad~~</var> 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 <var class="term">~~pad~~</var> is <code>'00':x</code>.</td></tr>		<td>A single character that indicates the character with which the shorter of the two input strings is to be extended. As many copies of <var class="term">c</var> 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 <var class="term">c</var> is <code>'00':x</code>.</td></tr>
	</table>		</table>

← Older revision		Revision as of 01:06, 22 March 2013
Line 40:		Line 40:

	==See also==		==See also==
			<table>
			<tr>
			<td>
	<ul>		<ul>
	<li><var>[[BitAndString (String function)\|~~BitAndString~~]]</var>		<li><var>[[BitAndString (String function)\|BitandString]]</var>
	<li><var>[[BitOffString (String function)\|BitOffString]]</var>		<li><var>[[BitOffString (String function)\|BitOffString]]</var>
	~~<li><var>[[BitOnString (String function)\|BitOnString]]</var>~~
	<li><var>[[BitXorString (String function)\|BitXorString]]</var>		<li><var>[[BitXorString (String function)\|BitXorString]]</var>
	</ul>		</ul>
			</td>
			<td>
			<ul>
			<li><var>[[BitClearString, BitFlipString, and BitSetString (String functions)\|BitClearString, BitFlipString, and BitSetString]]</var>
			<li><var>[[BitValueString (String function)\|BitValueString]]</var>
			<li><var>[[BitCountString (String function)\|BitCountString]]</var>
			</ul>
			</td>
	[[Category:Bit manipulation methods]]		[[Category:Bit manipulation methods]]
	{{Template:String:BitOrString footer}}		{{Template:String:BitOrString footer}}

← Older revision		Revision as of 23:28, 21 March 2013
Line 46:		Line 46:
	<li><var>[[BitXorString (String function)\|BitXorString]]</var>		<li><var>[[BitXorString (String function)\|BitXorString]]</var>
	</ul>		</ul>
			[[Category:Bit manipulation methods]]
	{{Template:String:BitOrString footer}}		{{Template:String:BitOrString footer}}