Difference between revisions of "Print"
imported>Heeheehee m (Info about cecho and colorecho.) |
imported>Fredg1 m |
||
(10 intermediate revisions by 4 users not shown) | |||
Line 5: | Line 5: | ||
FunctionPage| | FunctionPage| | ||
name={{#var:name}}| | name={{#var:name}}| | ||
− | |||
function1={{Function| | function1={{Function| | ||
Line 23: | Line 22: | ||
parameter2={{Param|string|color}}| | parameter2={{Param|string|color}}| | ||
p1desc={{Pspan|message}} is the text to print| | p1desc={{Pspan|message}} is the text to print| | ||
− | p2desc={{Pspan|color}} is an | + | p2desc={{Pspan|color}} is an html color name or code| |
}}| | }}| | ||
+ | function_description=Print the specified text {{pspan|message}} to the CLI. If the optional {{pspan|color}} parameter is specified and a valid html color code or entity, it will print in that color. See the [http://www.w3.org/TR/CSS21/syndata.html#color-units CSS 2.1 color specification] for a description of valid color syntax and keywords.| | ||
− | + | code1={{CodeSample| | |
+ | title=Code Sample| | ||
+ | description=Prints stuff in color and black. Note that it prints black twice: first and last.| | ||
+ | code= | ||
+ | <syntaxhighlight> | ||
+ | print("This is black."); | ||
+ | foreach color in $strings[blue, green, olive, darkorange, magenta, black] | ||
+ | print("This is "+color+".", color); | ||
+ | </syntaxhighlight> | ||
+ | }}| | ||
− | |||
− | see_also={{SeeAlso|logprint|print_html}}| | + | see_also={{SeeAlso|dump|logprint|print_html|chat_notify}}| |
cli_equiv=The CLI commands "fprint," "echo" and "fecho" have similar functionality, minus the color option. However, "cecho" (also "colorecho") does have this option for color.| | cli_equiv=The CLI commands "fprint," "echo" and "fecho" have similar functionality, minus the color option. However, "cecho" (also "colorecho") does have this option for color.| | ||
− | special= Using an invalid color name or code can cause odd colors to be chosen.| | + | special=A list of common color commands that can be used: olive, yellow, orange, gray, fuchsia, red, white, silver, teal, navy, blue, maroon, purple. <br> More advance colors can be used by entering their Hexadecimal code as the string. <br>Using an invalid color name or code can cause odd colors to be chosen; see the [[Talk:Print|Talk Page]] for details. |
+ | <br />As of r8638, attempting to print a string beginning with a slash(/) will cause KoLmafia to print a blank line instead. To avoid this behavior, you must specify the second argument for the text color. Any color will do, and even a blank string (<code>""</code>) will work. | ||
+ | | | ||
}} | }} | ||
− | + | ||
+ | [[Category:Miscellaneous Functions]] |
Latest revision as of 23:20, 20 September 2020
Function Syntax
void print(string message ,string color )
- message is the text to print
- color is an html color name or code
Print the specified text message to the CLI. If the optional color parameter is specified and a valid html color code or entity, it will print in that color. See the CSS 2.1 color specification for a description of valid color syntax and keywords.
Code Sample
Prints stuff in color and black. Note that it prints black twice: first and last.
print("This is black.");
foreach color in $strings[blue, green, olive, darkorange, magenta, black]
print("This is "+color+".", color);
CLI Equivalent
The CLI commands "fprint," "echo" and "fecho" have similar functionality, minus the color option. However, "cecho" (also "colorecho") does have this option for color.
See Also
Special
A list of common color commands that can be used: olive, yellow, orange, gray, fuchsia, red, white, silver, teal, navy, blue, maroon, purple.
More advance colors can be used by entering their Hexadecimal code as the string.
Using an invalid color name or code can cause odd colors to be chosen; see the Talk Page for details.
As of r8638, attempting to print a string beginning with a slash(/) will cause KoLmafia to print a blank line instead. To avoid this behavior, you must specify the second argument for the text color. Any color will do, and even a blank string (""
) will work.