native

replace_stringex

Syntax

native replace_stringex(text[], maxlength, const search[], const replace[], searchLen = -1, replaceLen = -1, bool:caseSensitive = true);

Description

Given a string, replaces the first occurrence of a search string with a
replacement string.

Parameters

text String to perform search and replacements on.
maxlength Maximum length of the string buffer.
search String to search for.
replace String to replace the search string with.
searchLen If higher than -1, its value will be used instead of
a strlen() call on the search parameter.
replaceLen If higher than -1, its value will be used instead of
a strlen() call on the replace parameter.
caseSensitive If true (default), search is case sensitive.

Note

Similar to replace() native, but implemented with more options and
with different algorithm. This native doesn't error on bad
buffer size and will smartly cut off the string in a way
that pushes old data out.

Note

Only available in 1.8.3 and above.

Note

This supports multi-byte characters (UTF-8) on case insensitive comparison.

Return

Index into the buffer (relative to the start) from where
the last replacement ended, or -1 if no replacements were
made.