String Handling Routines: Difference between revisions

From Kolmafia
Jump to navigation Jump to search
imported>StDoodle
mNo edit summary
imported>Grotfang
mNo edit summary
Line 6: Line 6:
{{Flink|int [item]|extract_items|desc=Parses a string for items and their amounts (handles plural & singular forms) and returns the results as a map.}}
{{Flink|int [item]|extract_items|desc=Parses a string for items and their amounts (handles plural & singular forms) and returns the results as a map.}}
{{Flink|int|length|string|desc=Returns the number of characters in the specified string.}}
{{Flink|int|length|string|desc=Returns the number of characters in the specified string.}}
{{Flink|int|index_off|string|string|{{opt|int}}|desc=Returns the position of the second string in the first (or -1 if not found), optionally starting from a given position.}}
{{Flink|int|index_of|string|string|{{opt|int}}|desc=Returns the position of the second string in the first (or -1 if not found), optionally starting from a given position.}}
{{Flink|int|last_index_of|string|string|desc=Returns the last index of the second string in the first.}}
{{Flink|int|last_index_of|string|string|desc=Returns the last index of the second string in the first.}}
{{Flink|string|substring|string|int|{{opt|int}}|desc=Returns the substring of the specified string, starting from a specified position, and optionally ending at a specified position (defaults to remainder of string).}}
{{Flink|string|substring|string|int|{{opt|int}}|desc=Returns the substring of the specified string, starting from a specified position, and optionally ending at a specified position (defaults to remainder of string).}}

Revision as of 14:40, 10 March 2010

string today_to_string()

Returns the current day in ISO format (based on your computer's settings).

string visit_url( string )

Visits the specified address and returns the page source (see page for details).

string to_url( location )

Returns the url which is accessed to visit the specified location.

boolean contains_text( string, string )

Returns true if the second string is found as a substring of the first.

int extract_meat( string )

Returns the number of meat embedded in a string.

int [item] extract_items()

Parses a string for items and their amounts (handles plural & singular forms) and returns the results as a map.

int length( string )

Returns the number of characters in the specified string.

int index_of( string, string, [int] )

Returns the position of the second string in the first (or -1 if not found), optionally starting from a given position.

int last_index_of( string, string )

Returns the last index of the second string in the first.

string substring( string, int, [int] )

Returns the substring of the specified string, starting from a specified position, and optionally ending at a specified position (defaults to remainder of string).

string replace_string( string, string, string )

Replaces all text in the first string that matches the second with the third.

string url_encode( string )

Converts a string into a URL formatted string.

string url_decode( string )

Converts a URL formatted string into regular text.

string [int] split_string( string, [rstring] )

Splits apart the first string at line-breaks or using an optionally supplied delimeter and returns an integer-keyed map of the result.

string [int,int] group_string( string, string )

This does... something regex-y. I dunno. [1]

string [int] session_logs( [string], int )

Gives access to sessions logs. And stuff. [2]

buffer append( buffer, string )

Appends the string to the end of the buffer.

buffer append_tail( matcher, buffer )

Appends the text returned by a matcher to the end of the buffer.