Description

Extracts the first (left-most) "count" characters from "string". If "count" is greater than the length of string, the entire string is returned.

Functional area

String

Command syntax

Syntax

strLeft "string" count

Arguments

Name	Type	Required	Comments
`string`	string	yes	String to extract sub-string from.
`count`	integer	yes	The number of characters to extract from string, counting from the left.

Flags

None

Return value

string

Returns the sub-string from "string".

Examples

// Extract some substrings
string $str = "This is some text";
string $subStr;
 
// Extract the first 7 characters
$subStr = `strLeft $str 7`;
print $subStr; 
// Should be "This is"
 
// Extract the first 17 characters
$subStr = `strLeft $str 17`;
print $subStr; 
// Should be same as $str