UnicodeLeft (Unicode function)

The left-most characters of the string (Unicode class)

UnicodeLeft returns the left-most characters of the method object string, possibly padding it on the right.

Syntax

%outUnicode = unicode:UnicodeLeft( number, [Pad= c])

%outUnicode	A `Unicode` variable to receive the result of the `UnicodeLeft` method.
unicode	A `Unicode` string.
number	The number of the left-most characters to return. If `unicode` is shorter than the requested number of characters, it is either padded to the requested length or returned with no padding, depending on the value of the `pad` parameter.
pad	A single character used to pad `unicode`, on the right, if it is shorter than the requested `number`. `pad` defaults to a null string (`''`) which means no padding is done. Pad is a name-required parameter.

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 a compilation error.
UnicodeLeft is identical to the UnicodeSubstring) with a 1 for the first argument.
UnicodeLeft is analogous to the Left String intrinsic method.
UnicodeLeft is available as of "Sirius Mods" Version 7.5.

The following statement displays Model 2:
%u is unicode initial('Model 204™':U) printText {%u:unicodeLeft(7)}
The following statement displays Model 204!!!:
%u is unicode initial('Model 204') printText {%u:unicodeLeft(12, pad='!')}
The following statement gets a character translation exception because the Unicode character ™ (trademark) has no Ebcdic equivalent:
%u is unicode initial('Model 204™':U) printText {%u:unicodeLeft(10)}

Float class String class Unicode class	List of Float methods List of String methods List of Unicode methods List of Intrinsic methods	Float methods syntax String methods syntax Unicode methods syntax
Notation conventions for methods