left

val = left(string, length)

Returns a specified number of characters from the left side of a string.

Parameters

string

String from which the leftmost characters are returned. If not string, converted to string.

length

Number of characrers to return. If not integer, converted to integer.

Remarks

If length less than 1, empty string is returned.

If length greater than or equal to the number of characters in string, the entire string is returned.

Example

a = left("Hello", 3)	' Returns "Hel".
a = left("Hello", 50)	' Returns "Hello".
a = left("Hello", -50)	' Returns "".