Crestron SW-SIMPL Installation & Operating Manual page 63

Crestron SIMPL™ Windows
Installation & Operations Guide – DOC. 5728C
A List of the Format Specifiers and the Corresponding Range
Format (specifier)
decimal (d) 0d - 65535d
percentage (%) 0% - 100%
0s - 582s (single precision)
0s - 19,000,000s (double
seconds (s)
precision)
hexadecimal (h) 0h - FFFFh
0t - 65535t
ticks (t)
(1 tick = 1/112.5 second)
Legal String Syntax
Strings can consist of a list of printable characters. An example of a string is:
Hello, World!
A string may be enclosed in quotes ( many macro fles imported from the DOS
Workshop have quotes around the strings), such as:
"Hello, World!"
If there are quotes at the start and end of the string, the quotes are removed when the
file is compiled. Quotes anywhere else within a string are retained.
Sometimes it is necessary for a string to contain ASCII characters that are not
printable. In order to encode any arbitary hex value, the notation \xZZ is ued, where \
signifies that the characters to follow have special meaning (i.e., do not print them
literally). The x means that the following two charaters are a hex constant and ZZ is
the hex value. For example, to encode the values Hex 05, Hex 06, it would look like
this:
\x05\x06
For example, it may be necessary to put an STX at the start of the string and an ETX
at the end. On any ASCII chart, STX corresponds to Hex 02 and ETX corresponds to
Hex 03. So to write the string for STX Hello, World! ETX, it would look like this:
\x02Hello, World!\x03
There are several other of these "escape" sequences that SIMPL Windows
understands when working with strings:
Escape Sequence
\a
\b
\f
\n
\r
\t
\v
\xZZ
\\
Note that \\ has special meaning, which is to print the \ character itself. For example,
to actually print the string \x05\x06 (8 characters), the string would be:
\\x05\\x06
Range
Meaning (in Hex)
\x07 (BEL)
\x08 (Backspace)
\x0C (FormFeed)
\x0D\x0A (Carriage Return/Linefeed)
\x0D (Carriage Return)
\x09 (Horizontal Tab)
\x0B (Vertical Tab)
Arbitrary Hex Value (shown above)
\x5C (Backslash Character)
Crestron SIMPL Windows • 53
Software