UnicodeUnspace (Unicode function): Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
Line 1: | Line 1: | ||
{{Template:Unicode:UnicodeUnspace subtitle}} | {{Template:Unicode:UnicodeUnspace subtitle}} | ||
The <var>UnicodeUnspace</var> [[Intrinsic classes|intrinsic]] function removes the whitespace characters from the <var>[[Unicode class|Unicode]]</var> string method object and it returns the resulting string. Options are available to:<ul><li> | The <var>UnicodeUnspace</var> [[Intrinsic classes|intrinsic]] function removes the whitespace characters from the <var>[[Unicode class|Unicode]]</var> string method object, and it returns the resulting string. Options are available to: | ||
Define which character or characters are to be interpreted as whitespace<li>Remove leading whitespace, trailing whitespace, both or neither | <ul> | ||
<li>Define which character or characters are to be interpreted as whitespace | |||
<li>Remove leading whitespace, trailing whitespace, both or neither | |||
<li>Collapse to a single whitespace character any sequences of non-leading, non-trailing whitespace | |||
</ul> | |||
==Syntax== | ==Syntax== | ||
Line 15: | Line 19: | ||
<tr><th><var>Spaces</var></th> | <tr><th><var>Spaces</var></th> | ||
<td><var | <td><var>Spaces</var> is an optional, [[Notation conventions for methods#Named parameters|name required]], parameter that is a <var>Unicode</var> string that specifies the set of characters considered to be whitespace. The default set is the blank space (<code>' '</code>) character. If you specify multiple <var>Spaces</var> characters, the first character is the replacement space character: a single one of these is substituted for each sequence (which may be one) of non-leading, non-trailing <var>Spaces</var> characters in the method object string.</td></tr> | ||
<tr><th><var>Leading</var></th> | <tr><th><var>Leading</var></th> | ||
<td><var | <td><var>Leading</var> is an optional, name required, parameter that is a <var>[[Enumerations#Using_Boolean_enumerations|Boolean Enumeration]]</var> value that specifies whether to strip all leading whitespace characters. The default is <var>True</var>, strip leading whitespace.</td></tr> | ||
<tr><th><var>Trailing</var></th> | <tr><th><var>Trailing</var></th> | ||
<td><var | <td><var>Trailing</var> is an optional, name required, parameter that is a <var>Boolean</var> enumeration value that specifies whether to strip all trailing whitespace characters. The default is <var>True</var>, strip trailing whitespace.</td></tr> | ||
<tr><th><var>Compress</var></th> | <tr><th><var>Compress</var></th> | ||
<td><var | <td><var>Compress</var> is an optional, name required, parameter that is a <var>Boolean</var> enumeration value that specifies whether to collapse each sequence of spaces to a single space. The default is <var>True</var>, collapse such sequences.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li>Duplicate <var | <li>Duplicate <var>Spaces</var> characters are tolerated and do not affect the result. | ||
</ul> | </ul> | ||
Revision as of 21:26, 30 July 2012
Remove whitespace characters from the string (Unicode class)
[Introduced in Sirius Mods 8.0]
The UnicodeUnspace intrinsic function removes the whitespace characters from the Unicode string method object, and it returns the resulting string. Options are available to:
- Define which character or characters are to be interpreted as whitespace
- Remove leading whitespace, trailing whitespace, both or neither
- Collapse to a single whitespace character any sequences of non-leading, non-trailing whitespace
Syntax
%outUnicode = unicode:UnicodeUnspace[( [Spaces= string], [Leading= boolean], - [Trailing= boolean], - [Compress= boolean])]
Syntax terms
%outUnicode | A Unicode variable to receive the result of the UnicodeUnspace function. |
---|---|
unicode | The method object Unicode string. |
Spaces | Spaces is an optional, name required, parameter that is a Unicode string that specifies the set of characters considered to be whitespace. The default set is the blank space (' ' ) character. If you specify multiple Spaces characters, the first character is the replacement space character: a single one of these is substituted for each sequence (which may be one) of non-leading, non-trailing Spaces characters in the method object string. |
Leading | Leading is an optional, name required, parameter that is a Boolean Enumeration value that specifies whether to strip all leading whitespace characters. The default is True, strip leading whitespace. |
Trailing | Trailing is an optional, name required, parameter that is a Boolean enumeration value that specifies whether to strip all trailing whitespace characters. The default is True, strip trailing whitespace. |
Compress | Compress is an optional, name required, parameter that is a Boolean enumeration value that specifies whether to collapse each sequence of spaces to a single space. The default is True, collapse such sequences. |
Usage notes
- Duplicate Spaces characters are tolerated and do not affect the result.