Left (String function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
|||
| Line 3: | Line 3: | ||
Left is available as of version 7.2 of the [[Sirius Mods]]. | Left is available as of version 7.2 of the [[Sirius Mods]]. | ||
===Left syntax=== | ===Left syntax=== | ||
%outStr = string:left(length, [Pad=char]) | %outStr = string:left(length, [Pad=char]) | ||
===Syntax Terms=== | ====Syntax Terms==== | ||
<dl> | <dl> | ||
<dt>%outStr | <dt>%outStr | ||
| Line 21: | Line 21: | ||
''char'' defaults to a blank. If set to null, no padding is applied. | ''char'' defaults to a blank. If set to null, no padding is applied. | ||
Pad is a name-required parameter. | Pad is a name-required parameter. | ||
</dl> | </dl> | ||
===Usage Notes=== | ===Usage Notes=== | ||
*The ''length'' value must be a non-negative number. A negative number results in request cancellation. | *The ''length'' value must be a non-negative number. A negative number results in request cancellation. | ||
*The pad parameter value must be either null or a single character. A longer value results in request cancellation in [[Sirius Mods]] version 7.2 and in a compilation error in [[Sirius Mods]] 7.3 and higher. | *The pad parameter value must be either null or a single character. A longer value results in request cancellation in [[Sirius Mods]] version 7.2 and in a compilation error in [[Sirius Mods]] 7.3 and higher. | ||
*The Left method is identical to the [[ | *The Left method is identical to the [[Substring (String function)|Substring]] method with a 1 for the first argument. | ||
===Examples=== | ===Examples=== | ||
The following statement places the left-most 5 bytes of %x into %y. | The following statement places the left-most 5 bytes of %x into %y. | ||
If %x is shorter than 6 bytes, then all of %x is copied into %y: | If %x is shorter than 6 bytes, then all of %x is copied into %y: | ||
%y = %x:left(5) | %y = %x:left(5) | ||
Revision as of 22:31, 21 October 2010
This intrinsic function returns the left-most characters of the method object string, possibly padding it on the right.
Left is available as of version 7.2 of the Sirius Mods.
Left syntax
%outStr = string:left(length, [Pad=char])
Syntax Terms
- %outStr
- A variable to receive the string result of the Left method.
- string
- The string to which the method is applied.
- length
- The number of the left-most bytes to return. If the method object is shorter than the requested number of bytes, it is either padded to the requested length or the entire method object string is returned with no padding, depending on the value of the Pad parameter.
- Pad=char
- The character used to pad the method object string on the right if it is shorter than the requested length. char defaults to a blank. If set to null, no padding is applied. Pad is a name-required parameter.
Usage Notes
- The length value must be a non-negative number. A negative number results in request cancellation.
- The pad parameter value must be either null or a single character. A longer value results in request cancellation in Sirius Mods version 7.2 and in a compilation error in Sirius Mods 7.3 and higher.
- The Left method is identical to the Substring method with a 1 for the first argument.
Examples
The following statement places the left-most 5 bytes of %x into %y. If %x is shorter than 6 bytes, then all of %x is copied into %y:
%y = %x:left(5)
The following statement displays 'Wheeeee':
printText {'Wh':left(7, pad='e')}