TrimLeft and TrimRight (String functions): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(3 intermediate revisions by 2 users not shown)
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 7: Line 6:
===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==
<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 than doing so.
</ul>
</ul>
==Examples==
==Examples==
The following
The following code:
<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>
outputs
outputs:
<p class="output">%ls = 'Life is goo'
<p class="output">%ls = 'Life is goo'
%ls = 'e is good'
%ls = 'e is good'
</p>
</p>
==See also==
==See also==
{{Template:String:TrimLeft footer}}
{{Template:String:TrimLeft footer}}

Latest revision as of 22:38, 3 September 2015

Trim bytes from left or right of string (String class)

[Introduced in Sirius Mods 7.9]

These methods remove a specified number of bytes from the left or right end of a string.

Syntax

%outString = string:TrimLeft( amount)

%outString = string:TrimRight( amount)

Syntax terms

%outStringIs the string that results from removing amount bytes from the left or right of string.
string The method string object from which bytes are removed.
amount The number of bytes to remove from the left or right of string.

Usage notes

  • An amount of 0 results in the output string being set equal to the value of string.
  • A negative amount or an amount greater than 231 results in request cancellation.
  • An amount greater than or equal to the length of string results in the output string being set to a null string.
  • TrimLeft accomplishes the same thing as SubString when used with just the starting position and without a length. While it might be a little bit more efficient than SubString, it's mainly available for completeness.
  • TrimRight functionality can be achieved by using the Left and Length functions but it is considerably more efficient and convenient than doing so.

Examples

The following code:

begin %ls is longstring %ls = 'Life is good':trimRight(1) printText {~} = '{%ls}' %ls = 'Life is good':trimLeft(3) printtext {~} = '{%ls}' end

outputs:

%ls = 'Life is goo' %ls = 'e is good'

See also