Sidebar
cparse
Table of Contents
# $EPIC: cparse.txt,v 1.5 2010/01/10 01:08:22 jnelson Exp $
Synopsis
$cparse(<text>)
$cparse(“<text>” <arguments>…)
Technical:
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 % |
Practical:
This is a convenient way add color to scripts without actually using the control-c character.
Returns:
<text> parsed according to the rules in the above table
Examples:
$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.
cparse.txt · Last modified: 2010/01/10 01:08 (external edit)