====== strleft ======

===== Description =====

Extract a substring of text from the start of a string (the 'left'). 

===== Function prototype =====

<code>
string strleft <string:Text> <int:nChars>
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //Text//  |  string  | A text string. |
|  //nChars//  |  int  | The number of characters to extract from the //Text// argument. |

===== Return value =====

A string containing the desired range of the //Text// string.

===== Example =====

<code>
echo <strleft "A B C D 1 2 3 4" 5>
</code>

... the output of which is written to the event log by [[plugins:general:zeoscript:reference:functions:echo]] as:

<file>
A B C
</file>

===== Comments =====

None.

===== See also =====

  * [[plugins:general:zeoscript:reference:functions:strsub]]
  * [[plugins:general:zeoscript:reference:functions:strright]]