Difference between revisions of "Miscellaneous Functions"

From Kolmafia
Jump to navigation Jump to search
(map_to_file, and file_to_map have boolean return, not void)
Line 6: Line 6:
  
 
<p><strong>boolean cli_execute( string command )</strong><br />
 
<p><strong>boolean cli_execute( string command )</strong><br />
Executes the given command as if it were entered into the graphical CLI window. This can be used for CLI commands or, if you&#8217;re careful and not an asshat, for raw URLs.<br />
+
Executes the given command as if it were entered into the graphical CLI window. This can be used for CLI commands or, if you
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for more details.<br />
 
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]</p>
 
 
 
<p><strong>void wait( int delay )</strong><br />
 
Does nothing for the desired number of seconds.</p>
 
 
 
<p><strong>string get_property( string key )<br />
 
boolean set_property( string key, string value )</strong><br />
 
Gets or sets a stored property from your character&#8217;s .kcs file.<br />
 
The KoLmafia [[%28ASHRM%29_KoLMafia_Properties|properties]] page contains details on many of the keys that are available for access.<br />
 
<em>Sample</em>:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|Battlefield_gather]]</p>
 
 
 
<p><strong>boolean file_to_map( string file_to_load, map map_to_fill )<br />
 
boolean map_to_file( map map_to_save, string file_to_write )</strong><br />
 
Loads and saves maps as tab-delimited text files.</p>
 
 
 
<p><strong>int random( int range )</strong><br />
 
Generates a random integer between 0 and (range-1) inclusive.</p>
 
 
 
<p><strong>int round( float ratio )<br />
 
int floor( float ratio )<br />
 
int ceil( float ratio )<br />
 
int truncate( float ratio )</strong><br />
 
Returns an integer near the given real number.  Respectively, it returns the nearest, next lowest, next highest, and decimal-stripped integer.</p>
 
 
 
<p><strong>int count( map )</strong><br />
 
Returns the number of defined keys for the aggregate.</p>
 
 
 
<p><strong>void clear( map )</strong><br />
 
Remove all keys from a map. </p>
 
 
 
<p><strong>void disable( string function_name )<br />
 
void enable( string function_name )</strong><br />
 
For debugging purposes disables or enables the indicated function</p>
 
 
 
<p><strong>float square_root( float value )</strong><br />
 
returns the square root of the passed value</p>
 
 
 
<p><strong>string today_to_string()</strong><br />
 
Returns today&#8217;s (real-world) date in the form yyyymmdd.  It is based on your computer&#8217;s system date</p>
 

Revision as of 01:13, 10 June 2007

Part 6 - Miscellaneous

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

void print( string helloworld )
Prints the given string to the graphical CLI window and to the status line of the main Adventuring window

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