Miscellaneous Functions

Part 7 - Miscellaneous

Mostly internal stuff. Some good for everyone, some only for ASH wizards.

void print( string output )
void print( string output, string color )
Prints output to the CLI buffer and displays it in the status line of the main Adventuring window. If color is specified any HTML in output is escaped and the string is wrapped in a font tag before being printed.

boolean cli_execute( string command )
Executes the given command as if it were entered into the graphical CLI window. This can be used for CLI commands or, if you’re careful and not an asshat, for raw URLs.
See the CLI manual for more details.
Sample:Hedging

void wait( int delay )
Sleeps for delay seconds.

string get_property( string key )
boolean set_property( string key, string value )
Gets or sets a stored property from your character’s .kcs file.
The KoLmafia properties page contains details on many of the keys that are available for access.
Sample:Battlefield_gather

boolean file_to_map( string file_to_load, map map_to_fill )
boolean map_to_file( map map_to_save, string file_to_write )
Loads and saves maps as tab-delimited text files.

int random( int range )
Generates a random integer between 0 and (range-1) inclusive.

int round( float ratio )
int floor( float ratio )
int ceil( float ratio )
int truncate( float ratio )
Returns an integer near the given real number. Respectively, it returns the nearest, next lowest, next highest, and decimal-stripped integer.

int count( map )
Returns the number of defined keys for the aggregate.

void clear( map )
Remove all keys from a map.

void disable( string function_name )
void enable( string function_name )
For debugging purposes disables or enables the indicated function

float square_root( float value )
returns the square root of the passed value

string today_to_string()
Returns today’s (real-world) date in the form yyyymmdd. It is based on your computer’s system date