If no match is found returns the input string itself.
replaceFirst
fn
R replaceFirst(R, C, RegEx)(R input, RegEx re, const(C)[] format) if (isSomeString!R && is(C : dchar) && isRegexFor!(RegEx, R))Construct a new string from input by replacing the first match with a string generated from it according to the format specifier.
To replace all matches use replaceAll.
Parameters
input | string to search |
re | compiled regular expression to use |
format | _format string to generate replacements from, see Replace _format string, the _format string. |
Returns
A string of the same type with the first match (if any) replaced.
fn
R replaceFirst(alias fun, R, RegEx)(R input, RegEx re) if (isSomeString!R && isRegexFor!(RegEx, R))This is a general replacement tool that construct a new string by replacing matches of pattern re in the input. Unlike the other overload there is no format string instead captures are passed to to a user-defined functor fun that returns a new string to use as replacement.
This version replaces the first match in input, see replaceAll to replace the all of the matches.
Returns
A new string of the same type as
input with all matches
replaced by return values of fun. If no matches found returns the input itself.