# $EPIC: cparse.txt,v 1.5 2010/01/10 01:08:22 jnelson Exp $
$cparse(<text>)
$cparse(“<text>” <arguments>…)
In the first form, <text> is a string that can contain embeded color directives. In the second form, <text> is a dword that can contain embedded color directives *and* references to $* which are satisfied by the following <arguments>. Don't forget to double up your $'s in this second format when refering to $*.
This function parses <text> according to the following table:
Color Code(s) | Text | Text | Background |
---|---|---|---|
%k %K %0 | black | bold black | black |
%r %R %1 | red | bold red | red |
%g %G %2 | green | bold green | green |
%y %Y %3 | yellow | bold yellow | yellow |
%b %B %4 | blue | bold blue | blue |
%m %M %5 | magenta | bold magenta | magenta |
%p %P | magenta (purple) | magenta (purple) | |
%c %C %6 | cyan | bold cyan | cyan |
%w %W %7 | while | bold white | white |
These codes have special meanings
Color Code | Meaning |
---|---|
%F | flashing |
%n | Turn all colors off |
%N | Don't reset colors at end of string |
%% | Insert a literal % |
This is a convenient way add color to scripts without actually using the control-c character.
<text> parsed according to the rules in the above table
$cparse(bl%Bah)
returns
bl^C4ah
where ^C4 is the control-c color code for blue.
$cparse("This is a $$0 test" cparse)
returns
This is a cparse test
Remember that $'s are expanded before a function is called, so you have to double up the $'s to make it work properly.