====== strsub ======

===== Description =====

Extract a substring of text from a string. 

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

<code>
string strsub <string:Text> <int:StartAt> <int:nChars>
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //Text//  |  string  | A text string. |
|  //StartAt// |  int  | The position in the string (zero-based) from which to begin extracting the substring. |
|  //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 <strsub "A B C D 1 2 3 4" 4 7>
</code>

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

<file>
C D 1 2
</file>

===== Comments =====

None.

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

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