TrimLeft and TrimRight (String functions) - Revision history

ELowell at 22:38, 3 September 2015

2015-09-03T22:38:41Z

← Older revision		Revision as of 22:38, 3 September 2015
Line 1:		Line 1:
	{{Template:String:TrimLeft and TrimRight subtitle}}		{{Template:String:TrimLeft and TrimRight subtitle}}

	These methods remove a specified number of bytes from the left or right end of a string.		These methods remove a specified number of bytes from the left or right end of a string.
	==Syntax==		==Syntax==
Line 24:		Line 23:

	==Examples==		==Examples==
	The following		The following code:
	<p class="code">begin		<p class="code">begin
	%ls is longstring		%ls is longstring
Line 33:		Line 32:
	end		end
	</p>		</p>
	outputs		outputs:
	<p class="output">%ls = 'Life is goo'		<p class="output">%ls = 'Life is goo'
	%ls = 'e is good'		%ls = 'e is good'

Goff: printtext

2011-02-23T09:39:15Z

printtext

← Older revision		Revision as of 09:39, 23 February 2011
Line 13:		Line 13:
	<td>The number of bytes to remove from the left or right of <var class="term">string</var>.</td></tr>		<td>The number of bytes to remove from the left or right of <var class="term">string</var>.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
Line 19:		Line 20:
	<li>An <var class="term">amount</var> greater than or equal to the length of <var class="term">string</var> results in the output string being set to a null string.		<li>An <var class="term">amount</var> greater than or equal to the length of <var class="term">string</var> results in the output string being set to a null string.
	<li><var>TrimLeft</var> accomplishes the same thing as <var>[[Substring (String function)\|SubString]]</var> when used with just the starting position and without a length. While it might be a little bit more efficient than <var>SubString</var>, it's mainly available for completeness.		<li><var>TrimLeft</var> accomplishes the same thing as <var>[[Substring (String function)\|SubString]]</var> when used with just the starting position and without a length. While it might be a little bit more efficient than <var>SubString</var>, it's mainly available for completeness.
	<li><var>TrimRight</var> functionality can be achieved by using the <var>[[Left (String function)\|Left]]</var> and <var>[[Length (String function)\|Length]]</var> functions but it is considerably more efficient and convenient.		<li><var>TrimRight</var> functionality can be achieved by using the <var>[[Left (String function)\|Left]]</var> and <var>[[Length (String function)\|Length]]</var> functions but it is considerably more efficient and convenient than doing so.
	</ul>		</ul>

Line 25:		Line 26:
	The following		The following
	<p class="code">begin		<p class="code">begin
	%ls is longstring		%ls is longstring
	%ls = 'Life is good':trimRight(1)		%ls = 'Life is good':trimRight(1)
	~~printtext~~ {~} = '{%ls}'		[[PrintText statement\|printText]] {~} = '{%ls}'
	%ls = 'Life is good':trimLeft(3)		%ls = 'Life is good':trimLeft(3)
	printtext {~} = '{%ls}'		printtext {~} = '{%ls}'
	end		end
	</p>		</p>
Line 36:		Line 37:
	%ls = 'e is good'		%ls = 'e is good'
	</p>		</p>

	==See also==		==See also==
	{{Template:String:TrimLeft footer}}		{{Template:String:TrimLeft footer}}

Alex: /* Usage notes */

2011-02-05T13:37:43Z

Usage notes

← Older revision		Revision as of 13:37, 5 February 2011
Line 15:		Line 15:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>An <var class="term">amount</var> of 0 results in the output string being set equal to the ~~method~~ string ~~object~~.		<li>An <var class="term">amount</var> of 0 results in the output string being set equal to the value of <var class="term">string</var>.
	<li>A negative <var class="term">amount</var> or an <var class="term">amount</var> greater than 2<sup>31</sup> results in request cancellation.		<li>A negative <var class="term">amount</var> or an <var class="term">amount</var> greater than 2<sup>31</sup> results in request cancellation.
	<li>An <var class="term">amount</var> greater than or equal to the length of ~~the method~~ string ~~object~~ results in the output string being set to a null string.		<li>An <var class="term">amount</var> greater than or equal to the length of <var class="term">string</var> results in the output string being set to a null string.
	<li><var>TrimLeft</var> accomplishes the same thing as <var>[[Substring (String function)\|SubString]]</var> when used with just the starting position and without a length. While it might be a little bit more efficient than <var>SubString</var>, it's mainly available for completeness.		<li><var>TrimLeft</var> accomplishes the same thing as <var>[[Substring (String function)\|SubString]]</var> when used with just the starting position and without a length. While it might be a little bit more efficient than <var>SubString</var>, it's mainly available for completeness.
	<li><var>TrimRight</var> functionality can be achieved by using the <var>[[Left (String function)\|Left]]</var> and <var>[[~~length~~ (String function)\|Length]]</var> functions but it is considerably more efficient and convenient.		<li><var>TrimRight</var> functionality can be achieved by using the <var>[[Left (String function)\|Left]]</var> and <var>[[Length (String function)\|Length]]</var> functions but it is considerably more efficient and convenient.
	</ul>		</ul>

	==Examples==		==Examples==
	The following		The following

Alex at 13:27, 5 February 2011

2011-02-05T13:27:48Z

← Older revision		Revision as of 13:27, 5 February 2011
Line 7:		Line 7:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%outString</th><td>Is the string that results from removing <var class="term">amount</var> bytes from the left or right of ~~the method~~ string ~~object~~.</td></tr>		<tr><th>%outString</th><td>Is the string that results from removing <var class="term">amount</var> bytes from the left or right of <var class="term">string</var>.</td></tr>
	<tr><th>string</th>		<tr><th>string</th>
	<td>The method string object from which bytes are removed.</td></tr>		<td>The method string object from which bytes are removed.</td></tr>
	<tr><th>amount</th>		<tr><th>amount</th>
	<td>The number of bytes to remove from the left or right of ~~the indicated~~ string.</td></tr>		<td>The number of bytes to remove from the left or right of <var class="term">string</var>.</td></tr>
	</table>		</table>
	==Usage notes==		==Usage notes==

Alex at 13:19, 5 February 2011

2011-02-05T13:19:48Z

← Older revision		Revision as of 13:19, 5 February 2011
Line 1:		Line 1:
	{{Template:String:TrimLeft and TrimRight subtitle}}		{{Template:String:TrimLeft and TrimRight subtitle}}

	These methods remove a specified number of bytes from the left or right end of a string.		These methods remove a specified number of bytes from the left or right end of a string.
	==Syntax==		==Syntax==
Line 6:		Line 7:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%outString</th><td>~~outString~~</td></tr>		<tr><th>%outString</th><td>Is the string that results from removing <var class="term">amount</var> bytes from the left or right of the method string object.</td></tr>
	<tr><th>string</th>		<tr><th>string</th>
	<td>~~String~~ object</td></tr>		<td>The method string object from which bytes are removed.</td></tr>
	<tr><th>amount</th>		<tr><th>amount</th>
	<td>~~Number object~~</td></tr>		<td>The number of bytes to remove from the left or right of the indicated string.</td></tr>
	</table>		</table>
	==Usage notes==		==Usage notes==
			<ul>
			<li>An <var class="term">amount</var> of 0 results in the output string being set equal to the method string object.
			<li>A negative <var class="term">amount</var> or an <var class="term">amount</var> greater than 2<sup>31</sup> results in request cancellation.
			<li>An <var class="term">amount</var> greater than or equal to the length of the method string object results in the output string being set to a null string.
			<li><var>TrimLeft</var> accomplishes the same thing as <var>[[Substring (String function)\|SubString]]</var> when used with just the starting position and without a length. While it might be a little bit more efficient than <var>SubString</var>, it's mainly available for completeness.
			<li><var>TrimRight</var> functionality can be achieved by using the <var>[[Left (String function)\|Left]]</var> and <var>[[length (String function)\|Length]]</var> functions but it is considerably more efficient and convenient.
			</ul>
	==Examples==		==Examples==
			The following
			<p class="code">begin
			%ls is longstring
			%ls = 'Life is good':trimRight(1)
			printtext {~} = '{%ls}'
			%ls = 'Life is good':trimLeft(3)
			printtext {~} = '{%ls}'
			end
			</p>
			outputs
			<p class="output">%ls = 'Life is goo'
			%ls = 'e is good'
			</p>
	==See also==		==See also==
	{{Template:String:TrimLeft footer}}		{{Template:String:TrimLeft footer}}

Alex at 12:53, 5 February 2011

2011-02-05T12:53:44Z

← Older revision		Revision as of 12:53, 5 February 2011
Line 1:		Line 1:
	{{Template:String:TrimLeft subtitle}}		{{Template:String:TrimLeft and TrimRight subtitle}}
			These methods remove a specified number of bytes from the left or right end of a string.
	==Syntax==		==Syntax==
	{{Template:String:TrimLeft syntax}}		{{Template:String:TrimLeft syntax}}
			{{Template:String:TrimRight syntax}}
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">

Alex: moved TrimLeft (String function) to TrimLeft and TrimRight (String functions)

2011-02-05T12:46:05Z

moved TrimLeft (String function) to TrimLeft and TrimRight (String functions)

← Older revision	Revision as of 12:46, 5 February 2011
(No difference)

Wiccan: Automatically generated page update

2011-02-05T12:45:30Z

Automatically generated page update

New page

{{Template:String:TrimLeft subtitle}}

==Syntax==
{{Template:String:TrimLeft syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%outString</th><td>outString</td></tr>
<tr><th>string</th>
<td>String object</td></tr>
<tr><th>amount</th>
<td>Number object</td></tr>
</table>
==Usage notes==
==Examples==
==See also==
{{Template:String:TrimLeft footer}}