Difference between revisions of "Character escape codes"
From Zenitel Wiki
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{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: | 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 | + | * 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. | * 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. | 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 | + | In the AlphaCom the character backslash (\) is used as escape character. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Escape sequences: | Escape sequences: | ||
| Line 18: | Line 14: | ||
! style="background:#ffdead;" width="70" | Result | ! style="background:#ffdead;" width="70" | Result | ||
! style="background:#ffdead;" width="30" | Hex code | ! 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| , || 2C || Comma | ||
| Line 50: | Line 46: | ||
| align=center|\l || || 80 || Extended NUL ('\x80') | | align=center|\l || || 80 || Extended NUL ('\x80') | ||
|- | |- | ||
| − | | align=center|\! || align=center| || || | + | | align=center|\! || align=center| || || Ignore rest of string |
|- | |- | ||
| align=center|\xhh || align=center| || || 'hh' is the ASCII character code as 2 hex digits. Note that you must use 2 digits. | | align=center|\xhh || align=center| || || 'hh' is the ASCII character code as 2 hex digits. Note that you must use 2 digits. | ||
Latest revision as of 15: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.