llReplaceSubString

From Second Life Wiki
Revision as of 09:19, 30 March 2023 by Maestro Linden (talk | contribs) (Got rid of some example-breaking extra parentheses)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Function: string llReplaceSubString( string src, string pattern, string replacement_pattern, integer count );
0.0 Forced Delay
10.0 Energy

Returns a string that is the result of replacing the first count matching instances pattern in src with replacement_pattern.

• string src
• string pattern
• string replacement_pattern
• integer count

If count = 0, all matching substrings are replaced. If count > 0, substrings are replaced starting from the left/beginning of src. If count < 0, substrings are replaced starting from the right/end of src.

Examples

default
{
    state_entry()
    {
        string ex = "red foxes, red hens, red turnips";
        // Replace first 2 matches, starting from the left side
        ex = llReplaceSubString(ex, "red", "blue", 2);
        llSay(0, ex); // Should say "blue foxes, blue hens, red turnips"
    }
}
default
{
    state_entry()
    {
        string ex = "red foxes, red hens, red turnips";
        // Replace first match, starting from the right side
        ex = llReplaceSubString(ex, "red", "green", -1);
        llSay(0, ex); // Should say "red foxes, red hens, green turnips"
    }
}
default
{
    state_entry()
    {
        string ex = "red foxes, red hens, red turnips";
        // Replace all matches
        ex = llReplaceSubString(ex, "red", "yellow", 0);
        llSay(0, ex); // Should say "yellow foxes, yellow hens, yellow turnips"
    }
}

See Also

Deep Notes

Signature

function string llReplaceSubString( string src, string pattern, string replacement_pattern, integer count );