====== Strings ======


===== Literal strings =====

Arguments in ZeoScript are delimited by spaces. Hence, any string argument that contains a space will be split into separate strings. To prevent string splitting, you should surround your string in "quotation marks". Here is an example:

<code>
project.SaveProjectAs "C:\\temp\\this is a temp project name.proj"
</code>


===== String concatenation =====

Two strings may be concatenated together using the ''strcat'' function. More strings may be added by nesting calls to ''strcat'', as below:

<code>
// create a new string for name
string MyName

// allow user to edit name
EditUI &MyName "Please enter your name"

// add strings together ("Hello " + MyName + "!"), and echo to screen
echo <strcat "Hello " <strcat MyName "!">>
</code>

The output of this script is:

<file>
Hello Aaron!
</file>




===== String lengths =====

The length of a string may be determined using the ''strlen'' function, as demonstrated below: 

<code>
string s
int i

// initialise a string
set s "This text is 31 characters long"

// get the text length using 'strlen'
set i <strlen s>

// report the text length
echo i
</code>

The output of this script is:

<file>
31
</file>