UnicodeTrimLeft and UnicodeTrimRight (Unicode functions): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:Unicode:UnicodeTrimLeft and UnicodeTrimRight subtitle}} | {{Template:Unicode:UnicodeTrimLeft and UnicodeTrimRight subtitle}} | ||
These methods remove a specified number of characters from the left or right end of a string. | |||
==Syntax== | ==Syntax== | ||
{{Template:Unicode:UnicodeTrimLeft syntax}} | {{Template:Unicode:UnicodeTrimLeft syntax}} | ||
| Line 6: | Line 7: | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%outUnicode</th><td> | <tr><th>%outUnicode</th><td>Is the unicode string that results from removing <var class="term">amount</var> characters from the left or right of <var class="term">unicode</var>.</td></tr> | ||
<tr><th>unicode</th> | <tr><th>unicode</th> | ||
<td> | <td>The method unicode object from which characters are removed.</td></tr> | ||
<tr><th>amount</th> | <tr><th>amount</th> | ||
<td> | <td>The number of characters to remove from the left or right of <var class="term">unicode</var>.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | |||
<li>An <var class="term">amount</var> of 0 results in the output unicode string being set equal to the value of <var class="term">unicode</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>An <var class="term">amount</var> greater than or equal to the length of <var class="term">unicode</var> results in the output string being set to a null string. | |||
<li><var>UnicodeTrimLeft</var> accomplishes the same thing as <var>[[UnicodeSubstring (Unicode function)|UnicodeSubString]]</var> when used with just the starting position and without a length. While it might be a little bit more efficient than <var>UnicodeSubString</var>, it's mainly available for completeness. | |||
<li><var>UnicodeTrimRight</var> functionality can be achieved by using the <var>[[UnicodeLeft (Unicode function)|UnicodeLeft]]</var> and <var>[[UnicodeLength (Unicode function)|UnicodeLength]]</var> functions but it is considerably more efficient and convenient. | |||
</ul> | |||
==Examples== | ==Examples== | ||
==See also== | ==See also== | ||
{{Template:Unicode:UnicodeTrimLeft footer}} | {{Template:Unicode:UnicodeTrimLeft footer}} | ||
Revision as of 13:36, 5 February 2011
Trim characters from left or right of string (Unicode class)
[Introduced in Sirius Mods 7.9]
These methods remove a specified number of characters from the left or right end of a string.
Syntax
%outUnicode = unicode:UnicodeTrimLeft( amount)
%outUnicode = unicode:UnicodeTrimRight( amount)
Syntax terms
| %outUnicode | Is the unicode string that results from removing amount characters from the left or right of unicode. |
|---|---|
| unicode | The method unicode object from which characters are removed. |
| amount | The number of characters to remove from the left or right of unicode. |
Usage notes
- An amount of 0 results in the output unicode string being set equal to the value of unicode.
- A negative amount or an amount greater than 231 results in request cancellation.
- An amount greater than or equal to the length of unicode results in the output string being set to a null string.
- UnicodeTrimLeft accomplishes the same thing as UnicodeSubString when used with just the starting position and without a length. While it might be a little bit more efficient than UnicodeSubString, it's mainly available for completeness.
- UnicodeTrimRight functionality can be achieved by using the UnicodeLeft and UnicodeLength functions but it is considerably more efficient and convenient.