Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+# $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 [[what is a word|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.

EPIC

Site Tools

Differences

Page Tools