Replace first

From Kolmafia
Revision as of 05:51, 11 May 2010 by imported>Bale (Created page with '{{ #vardefine:name|replace_first}}{{ #vardefine:return_type|string}}{{ FunctionPage| name={{#var:name}}| function_category=String Handling Routines| function1={{Function| name=…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Function Syntax

string replace_first(matcher pattern ,string replacement )

  • pattern is the regular expression to use
  • replacement is used to replace a match of the pattern

This function first resets the matcher pattern. It then scans the input sequence looking a match of the pattern. Characters that are not part of any match are appended directly to the result string with the first match replaced by the replacement string.

Simple Example

For example:

string input = "zzzdogzzzdogzzz";
matcher test_match = create_matcher("dog", input);
string result = replace_all(test_match, "cat");
print(result);

Will result in the following being printed:

zzzcatzzzdogzzz


See Also

replace_all()