Infixed constants that return ANSI escape sequences
ANSI Constants is a murex convention of passing ANSI escape sequences into strings. It uses the {} notation with the constant name placed in between two curly braces. eg {GREEN}.
Rather than duplicate the constants from source, and risk the documentation and implementation drifting, this document will embed the source directly below.
package ansi
var constants = map[string][]byte{
// ascii control codes
"^@": {0},
"^A": {1},
"^B": {2},
"^C": {3},
"^D": {4},
"^E": {5},
"^F": {6},
"^G": {7},
"^H": {8},
"^I": {9},
"^J": {10},
"^K": {11},
"^L": {12},
"^M": {13},
"^N": {14},
"^O": {15},
"^P": {16},
"^Q": {17},
"^R": {18},
"^S": {19},
"^T": {20},
"^U": {21},
"^V": {22},
"^W": {23},
"^X": {24},
"^Y": {25},
"^Z": {26},
"^[": {27},
`^/`: {28},
"^]": {29},
"^^": {30},
"^_": {31},
"^?": {127},
// ascii human readable
"EOF": {4},
"EOT": {4},
"BELL": {7},
"BS-ISO": {8},
"LF": {10},
"CR": {13},
"CRLF": {13, 10},
"ESC": {27},
"ESCAPE": {27},
"BS-ASCII": {127},
// ansi escape sequences
"CURSOR-UP": {27, 91, 65},
"CURSOR-DOWN": {27, 91, 66},
"CURSOR-FORWARDS": {27, 91, 67},
"CURSOR-BACKWARDS": {27, 91, 68},
"CURSOR-HOME": {27, 91, 72},
"CURSOR-HOME-VT100": {27, 91, 49, 126},
"CURSOR-END": {27, 91, 70},
"CURSOR-END-VT100": {27, 91, 52, 126},
"INS": {27, 91, 50, 126},
"INSERT": {27, 91, 50, 126},
"DEL": {27, 91, 51, 126},
"DELETE": {27, 91, 51, 126},
// function keys
"F1-VT100": {27, 79, 80},
"F2-VT100": {27, 79, 81},
"F3-VT100": {27, 79, 82},
"F4-VT100": {27, 79, 83},
"F1": {27, 91, 49, 49, 126},
"F2": {27, 91, 49, 50, 126},
"F3": {27, 91, 49, 51, 126},
"F4": {27, 91, 49, 52, 126},
"F5": {27, 91, 49, 53, 126},
"F6": {27, 91, 49, 55, 126},
"F7": {27, 91, 49, 56, 126},
"F8": {27, 91, 49, 57, 126},
"F9": {27, 91, 50, 48, 126},
"F10": {27, 91, 50, 49, 126},
"F11": {27, 91, 50, 51, 126},
"F12": {27, 91, 50, 52, 126},
// alt-num
"ALT-0": {27, 48},
"ALT-1": {27, 49},
"ALT-2": {27, 50},
"ALT-3": {27, 51},
"ALT-4": {27, 52},
"ALT-5": {27, 53},
"ALT-6": {27, 54},
"ALT-7": {27, 55},
"ALT-8": {27, 56},
"ALT-9": {27, 57},
}
var sgr = map[string][]byte{
// text effects
"RESET": {27, 91, 48, 109},
"BOLD": {27, 91, 49, 109},
"ITALIC": {27, 91, 51, 109}, // Not commonly supported in terminals
"UNDERSCORE": {27, 91, 52, 109},
"UNDERLINE": {27, 91, 52, 109},
"UNDEROFF": {27, 91, '2', '4', 109},
"BLINK": {27, 91, 53, 109},
"INVERT": {27, 91, 55, 109},
"ALT-FONT-1": {27, 91, 49, 49, 109}, // Not commonly supported in terminals
"ALT-FONT-2": {27, 91, 49, 50, 109}, // Not commonly supported in terminals
"ALT-FONT-3": {27, 91, 49, 51, 109}, // Not commonly supported in terminals
"ALT-FONT-4": {27, 91, 49, 52, 109}, // Not commonly supported in terminals
"ALT-FONT-5": {27, 91, 49, 53, 109}, // Not commonly supported in terminals
"ALT-FONT-6": {27, 91, 49, 54, 109}, // Not commonly supported in terminals
"ALT-FONT-7": {27, 91, 49, 55, 109}, // Not commonly supported in terminals
"ALT-FONT-8": {27, 91, 49, 56, 109}, // Not commonly supported in terminals
"ALT-FONT-9": {27, 91, 49, 57, 109}, // Not commonly supported in terminals
"FRAKTUR": {27, 91, 50, 48, 109}, // Not commonly supported in terminals
// text colours
"BLACK": {27, 91, 51, 48, 109},
"RED": {27, 91, 51, 49, 109},
"GREEN": {27, 91, 51, 50, 109},
"YELLOW": {27, 91, 51, 51, 109},
"BLUE": {27, 91, 51, 52, 109},
"MAGENTA": {27, 91, 51, 53, 109},
"CYAN": {27, 91, 51, 54, 109},
"WHITE": {27, 91, 51, 55, 109},
"BLACK-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"RED-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"GREEN-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"YELLOW-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"BLUE-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"MAGENTA-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"CYAN-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
"WHITE-BRIGHT": {27, 91, 49, 59, 51, 48, 109},
// background colours
"BG-BLACK": {27, 91, 52, 48, 109},
"BG-RED": {27, 91, 52, 49, 109},
"BG-GREEN": {27, 91, 52, 50, 109},
"BG-YELLOW": {27, 91, 52, 51, 109},
"BG-BLUE": {27, 91, 52, 52, 109},
"BG-MAGENTA": {27, 91, 52, 53, 109},
"BG-CYAN": {27, 91, 52, 54, 109},
"BG-WHITE": {27, 91, 52, 55, 109},
"BG-BLACK-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-RED-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-GREEN-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-YELLOW-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-BLUE-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-MAGENTA-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-CYAN-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
"BG-WHITE-BRIGHT": {27, 91, 49, 59, 52, 48, 109},
}Each line will look something a little like
"GREEN": {27, 91, 51, 50, 109},The part within quotes is the constant name, and the part that follows is the sequence of bytes that are infixed.
So the example above will replace {GREEN} from within a string with the byte values of 27, 91, 51, 50 and 109 (in that order).
If a constant does not exist in the above code, then the infix string is left unedited.
# Green spelt correctly
» out: "{GREEN}PASSED{RESET}"
PASSED
# Green spelt incorrectly (ie so that it doesn't exist as a valid constant)
» out: "{GREEEEN}PASSED{RESET}"
{GREEEEN}PASSEDThese sequences are enabled by default. To disable run the following:
» config: set shell color falseYou will need to add this to your murex profile, ~/.murex_profile to make it persistent.
( (brace quote): Write a string to the STDOUT without new lineerr: Print a line to the STDERRout: Print a string to the STDOUT with a trailing new line charactertout: Print a string to the STDOUT and set it’s data-typeThis site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.
Last built on Mon Feb 13 09:18:06 UTC 2023 against commit f339958f33995895c1d997efcdbb8408d2c8d45f8b5f934.
Current version is which has been verified against 13950 tests cases.