Kolmafia - User contributions [en]

Talk:String Handling Routines

2007-09-24T14:55:10Z

EEPiccolo: Revert

So wtf does group_string actually do? The linked "descriptive" post has an utterly unhelpful example. Has anyone ever used it for anything?

Groups a string into a map using a regular expression. To understand the function you must know.
1. What maps are and how they are used.
2. Understand what regular expressions are and how to create them.

Using the original post:

FUNCTION DEFINTION: string [int,int] group_string( string source, string regex )
EXAMPLE: string [int,int] test = group_string( "This is a test", "([a-z] ) " );

Example Breakdown:
'''string [int,int]''' Define a map. Two dimensional. The indices are integers. The data is stored as a string.
'''test''' Define the map with name '''test'''.
'''group_string''' Call the function.
'''"This is a Test"''' Feeding the function a sample string.
'''"([a-z] ) "''' Your regular expression.

Regular expressions deal with pattern matching. You want the function to find a particular pattern. The function then returns that pattern, or the stuff before it, or the stuff after it, or splits them appart, or squeezes them together. So what does this regular expression look for?
'''The Parenthesis ():''' Tell the function this is a group of characters.
'''[a-z]:''' Tell us they will be lower case letters.
''' :''' Tell us to look for one or more characters.
That space between the ) and " Tells us the pattern ends in a space.

Thus reading down the string.
T = Does not match [a-z] is a capital letter.
h = Matches [a-z]. Starting Group
i = Matches [a-z]
s = Matches [a-z]
= Matches space. First group found and is "his "
i = Matches [a-z]. Starting Group
s = Matches [a-z]
= Matches space. Second group found, and is "is "
a = Matches [a-z]. Starting Group
= Matches space. Third group found, and is "a "
t = Matches [a-z]. Starting Group
e = Matches [a-z]
s = Matches [a-z]
t = Matches [a-z]
End of line. No more matches. Stop.

Thus, trusting the post, the map would be:

test[0][0] => "his "
test[0][1] => "his"
test[1][0] => "is "
test[1][1] => "is"
test[2][0] => "a "
test[2][1] => "a"

I personally haven't used it. Would be used in parsing a page by hand.

Miscellaneous Functions

2007-09-24T14:54:17Z

EEPiccolo:

== Part 7 - 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’re careful and not an asshat, for raw URLs. 
See the [http://kolmafia.sourceforge.net/scripting.html CLI manual] for more details. 
Sample:[[%28ASHRM%29_Code_Samples#Sample_4:_Hedging|Hedging]]

void wait( int delay ) 
Does nothing for the desired number of 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 [[%28ASHRM%29_KoLMafia_Properties|properties]] page contains details on many of the keys that are available for access. 
Sample:[[%28ASHRM%29_Code_Samples#Sample_2:_Battlefield_gather|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

Talk:String Handling Routines

2007-09-23T18:13:16Z

EEPiccolo: revert

Talk:String Handling Routines

2007-09-22T13:32:13Z

EEPiccolo: revert

Main Page

2007-09-22T13:31:19Z

EEPiccolo: revert from spam

Welcome to the KoLmafia Wiki.

Please pardon our dust while we remodel. 
'''Progress level: [[Special:Statistics|{{NUMBEROFARTICLES}}]]'''

<table style="width:80%;margin-top: .7em;background-color:#F4DF3B;border:2px solid #8663A8">
<tr>
<td class="box_tgen" style="text-align:center;color:#000;font-size:90%;border:none;margin: 0;padding:.1em;">
'''Quick Links:''' [[Your Character]] || [[Item Management]] || [[Equipment]] || [[Skills and Effects]] || [[Adventuring]] || [[In-combat functions for consult scripting]] || [[Miscellaneous]] || [[String Handling Routines]] || [[Datatype Constants]] || [[Datatype Conversions]] || [[KoLmafia Properties]] || [[Code Samples]]</td>
</tr>
</table>

== Helpful Links ==

KoLMafia:

[http://kolmafia.sourceforge.net Download KoLMafia]

[http://kolmafia.sourceforge.net/manual.html KoLMafia Documentation]

[http://kolmafia.sourceforge.net/scripting.html CLI Scripting Manual]

[http://kolmafia.sourceforge.net/advanced.html ASH Scripting Manual]

[http://kolmafia.sourceforge.net/combat.html Custom Combat Scripting Manual]

[http://www.kolmafia.us The KoLMafia Script Repository]

[http://forums.kingdomofloathing.com/viewtopic.php?t=19779 The KoLMafia thread on the KoL Forums]

KoL:

[http://www.kingdomofloathing.com/ The Kingdom of Loathing]

[http://forums.kingdomofloathing.com/ KoL Forums]

Talk:String Handling Routines

2007-09-21T17:04:02Z

EEPiccolo: revert

So wtf does group_string actually do? The linked "descriptive" post has an utterly unhelpful example. Has anyone ever used it for anything?

Groups a string into a map using a regular expression. To understand the function you must know.
1. What maps are and how they are used.
2. Understand what regular expressions are and how to create them.

Using the original post:

FUNCTION DEFINTION: string [int,int] group_string( string source, string regex )
EXAMPLE: string [int,int] test = group_string( "This is a test", "([a-z]+) " );

Example Breakdown:
'''string [int,int]''' Define a map. Two dimensional. The indices are integers. The data is stored as a string.
'''test''' Define the map with name '''test'''.
'''group_string''' Call the function.
'''"This is a Test"''' Feeding the function a sample string.
'''"([a-z]+) "''' Your regular expression.

Regular expressions deal with pattern matching. You want the function to find a particular pattern. The function then returns that pattern, or the stuff before it, or the stuff after it, or splits them appart, or squeezes them together. So what does this regular expression look for?
'''The Parenthesis ():''' Tell the function this is a group of characters.
'''[a-z]:''' Tell us they will be lower case letters.
'''+:''' Tell us to look for one or more characters.
That space between the ) and " Tells us the pattern ends in a space.

Thus reading down the string.
T = Does not match [a-z] is a capital letter.
h = Matches [a-z]. Starting Group
i = Matches [a-z]
s = Matches [a-z]
= Matches space. First group found and is "his "
i = Matches [a-z]. Starting Group
s = Matches [a-z]
= Matches space. Second group found, and is "is "
a = Matches [a-z]. Starting Group
= Matches space. Third group found, and is "a "
t = Matches [a-z]. Starting Group
e = Matches [a-z]
s = Matches [a-z]
t = Matches [a-z]
End of line. No more matches. Stop.

Thus, trusting the post, the map would be:

test[0][0] => "his "
test[0][1] => "his"
test[1][0] => "is "
test[1][1] => "is"
test[2][0] => "a "
test[2][1] => "a"

I personally haven't used it. Would be used in parsing a page by hand.

Miscellaneous Functions

2007-09-21T16:29:30Z

EEPiccolo: Revert