The String type represents words and other characters strung together into a single String. Strings are how Waltz represents text. A String can contain any character (although some characters may accidentally end the declaration of a String early without being properly escaped.)
There is no need to explicitly construct a String, nor is there an explicit constructor. Assigning a literal string value is enough to create a String. A string literal is zero or more characters enclosed in double (
") or single (
') quotation marks. A string must be delimited by quotation marks of the same type; that is, either both single quotation marks or both double quotation marks. The following are all examples of Strings:
"Man's best friend!"
In addition to ordinary characters, you can also include special characters in Strings, as shown in the following example:
'one line \n another line'
The following table lists the special characters that you can use in Strings.
||Apostrophe or single quote|
||The character with the Latin-1 encoding specified by up to three octal digits |
||The character with the Latin-1 encoding specified by the two hexadecimal digits |
||The Unicode character specified by the four hexadecimal digits |
||Unicode code point escapes. For example |
Any sequence of characters is permitted in a String, although, as mentioned in Constructing, some characters requires special escape characters.
The String type exists in both Waltz's native context as well as in its Script Expressions. Strings are freely converted with no change in content except to properly escape a double quote mark used instead a string declared with single quote marks. This process is transparent and requires no special handling.
|Primitives||Boolean · Number · String|
|Objects||Color · Dimension · DmxMultiverse · DmxUniverse · LocalInterface · Material · Point · RemoteAddress/IP · Scene · Time · Touch|
|Node Specific||NdiSource · WoControlCue · WoHitTestResult · WoTimeline|
|Collections||List · List of Lists · Map · Varargs|
|Special||Any · Consumer · Expression · Null · Void|