====== strlen ======

===== Description =====

Get the length of a string in characters.

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

<code>
int strlen <string:str>
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //str//  |  string  | A string, the length of which is to be determined. |

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

An integer containing the length of //str//, in characters. 

===== Example =====

<code>
// create a new integer
int i

// set integer value to be length of a string using strlen
set i <zs:strlen "This text is 31 characters long">

// echo result to event log
echo i
</code>

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

<file>
31
</file>

===== Comments =====

None.


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

  * [[plugins:general:zeoscript:reference:functions:strcat]]