Difference between revisions of "Character escape codes"
From Zenitel Wiki
| (13 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | Escape sequences use an escape character to change the meaning of the characters which follow it. | + | {{AI}} |
| + | Escape sequences use an escape character to change the meaning of the characters which follow it. Escape sequences can be used for two purposes: | ||
| + | * to use non-printable characters in [[Event_Handler#Built-In_Action_Commands|action strings]], e.g. in strings on [[EDO]] port and [[MPP]] commands | ||
| + | * quoting: ignore special meaning of a character in eventhandler parser. | ||
| + | |||
| + | The escape sequences are substituted when the eventhandler reads the action string. In the case of Data Protocol Commands ( @ $ ), the escape sequences are substituted ''before'' the messages are sent to the Data Protocol Router / Handler. | ||
| + | |||
| + | In the AlphaCom the character backslash (\) is used as escape character. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Escape sequences: | Escape sequences: | ||
{| border="1" | {| border="1" | ||
| − | |||
! style="background:#ffdead;" width="70" | Escape sequence | ! style="background:#ffdead;" width="70" | Escape sequence | ||
! style="background:#ffdead;" width="70" | Result | ! style="background:#ffdead;" width="70" | Result | ||
| − | ! style="background:#ffdead;" width="30" | Hex | + | ! style="background:#ffdead;" width="30" | Hex code |
| − | ! style="background:#ffdead;" width=" | + | ! style="background:#ffdead;" width="550" | Description |
| + | |- | ||
| + | | align=center|\, || align=center| , || 2C || Comma | ||
|- | |- | ||
| − | + | | align=center|\( || align=center| ( || 28 || Opening parenthese | |
|- | |- | ||
| − | + | | align=center|\) || align=center| ) || 29 || Closing parenthese | |
|- | |- | ||
| − | + | | align=center|\" || align=center| " || 22 || Double quote | |
|- | |- | ||
| − | + | | align=center|\; || align=center| ; || 3B || Semicolon | |
|- | |- | ||
| − | | align=center| | + | | align=center|\\ || align=center|\ || 5C || Backslash |
|- | |- | ||
| − | | align=center| \ || align=center| | + | | align=center|\% || align=center|% || 25 || Percent |
|- | |- | ||
| − | | align=center| | + | | align=center|\t || align=center|TAB || 09 || ASCII TAB (Horisontal tab) |
|- | |- | ||
| − | | align=center| | + | | align=center|\s || align=center|SP || 20 || Space |
|- | |- | ||
| − | | align=center| | + | | align=center|\r || align=center|CR || 0D || Carriage return |
|- | |- | ||
| − | | align=center| | + | | align=center|\n || align=center|LF || 0A || Line feed |
|- | |- | ||
| − | | align=center| | + | | align=center|\a || align=center|BEL || 07 || Bell (Alert) |
|- | |- | ||
| − | | align=center| | + | | align=center|\b || align=center|BS || 08 || Backspace |
|- | |- | ||
| − | | align=center| | + | | align=center|\0 || align=center|NUL || 00 || ASCII NUL |
|- | |- | ||
| − | + | | align=center|\l || || 80 || Extended NUL ('\x80') | |
|- | |- | ||
| − | + | | align=center|\! || align=center| || || Ignore rest of string | |
|- | |- | ||
| − | | align=center| | + | | align=center|\xhh || align=center| || || 'hh' is the ASCII character code as 2 hex digits. Note that you must use 2 digits. |
|- | |- | ||
| − | | align=center| | + | | align=center|\#hh || align=center| || || 'hh' is the ASCII character code as 2 hex digits. Note that you must use 2 digits. |
|- | |- | ||
|} | |} | ||
| Line 53: | Line 56: | ||
<br> | <br> | ||
| − | By using the escape sequence '\xhh' all sorts of ASCII characters can be | + | By using the escape sequence '\xhh' all sorts of ASCII characters can be generated. |
<br><br> | <br><br> | ||
| − | + | ||
| − | |||
| − | |||
| − | |||
[[Category:Event Handler]] | [[Category:Event Handler]] | ||
Latest revision as of 14:13, 25 August 2020
Escape sequences use an escape character to change the meaning of the characters which follow it. Escape sequences can be used for two purposes:
- to use non-printable characters in action strings, e.g. in strings on EDO port and MPP commands
- quoting: ignore special meaning of a character in eventhandler parser.
The escape sequences are substituted when the eventhandler reads the action string. In the case of Data Protocol Commands ( @ $ ), the escape sequences are substituted before the messages are sent to the Data Protocol Router / Handler.
In the AlphaCom the character backslash (\) is used as escape character.
Escape sequences:
| Escape sequence | Result | Hex code | Description |
|---|---|---|---|
| \, | , | 2C | Comma |
| \( | ( | 28 | Opening parenthese |
| \) | ) | 29 | Closing parenthese |
| \" | " | 22 | Double quote |
| \; | ; | 3B | Semicolon |
| \\ | \ | 5C | Backslash |
| \% | % | 25 | Percent |
| \t | TAB | 09 | ASCII TAB (Horisontal tab) |
| \s | SP | 20 | Space |
| \r | CR | 0D | Carriage return |
| \n | LF | 0A | Line feed |
| \a | BEL | 07 | Bell (Alert) |
| \b | BS | 08 | Backspace |
| \0 | NUL | 00 | ASCII NUL |
| \l | 80 | Extended NUL ('\x80') | |
| \! | Ignore rest of string | ||
| \xhh | 'hh' is the ASCII character code as 2 hex digits. Note that you must use 2 digits. | ||
| \#hh | 'hh' is the ASCII character code as 2 hex digits. Note that you must use 2 digits. |
By using the escape sequence '\xhh' all sorts of ASCII characters can be generated.