Strings - nitrologic/monkey2 GitHub Wiki

@manpage Strings

Strings

A String is an immutable sequence of 16 bit characters that is usually used to represent text.

String literals are sequences of characters enclosed in "``" (quotation marks). String literals may also include escape sequences, special sequences of characters used to represent unprintable characters.

You can use the following escape sequences in string literals:

Escape sequence	Character code
~q	34 (quotation mark ")
~n	10 (newline)
~r	13 (return)
~t	9 (tab)
~z	0 (null)
~~	126 (tilde ~)

For example, to include literal quotation marks in a string:

Local test:="~qHello World~q" 

Strings can also be declared across multiple lines:

Const multiLine:="
Multi Line String
"

In this case, each newline inside the quote marks is simply included in the string, so the above example string actually contains 2 'hidden' newlines.

String variables are declared using the type name String, for example:

Local test:String="Hello World"

You can index a string using the `[]' operator:

Local str:="Hello World"
For Local i:=0 Until str.Length
	Print str[i]
Next

Indexing a string will return the character code at a given string index as an int.

You can iterate through the characters in a string using Eachin:

For Local chr:=Eachin "Hello World"
	Print chr
Next

Strings have a number of useful methods including types.String.Slice, types.String.Find and types.String.Split. For more information on strings, please see the types.String API reference.