Difference between revisions of "LlReplaceSubString"

From Second Life Wiki
Jump to navigation Jump to search
(Initial edit. This function is coming soon.)
 
m
Line 8: Line 8:
|p3_type=string|p3_name=replacement_pattern
|p3_type=string|p3_name=replacement_pattern
|p4_type=integer|p4_name=count
|p4_type=integer|p4_name=count
|func_footnote=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'''.
|func_footnote=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'''.
|func_desc
|func_desc
|return_text=that is the result of replacing the first '''count''' matching instances '''pattern''' in '''src''' with '''replacement_pattern'''.
|return_text=that is the result of replacing the first '''count''' matching instances '''pattern''' in '''src''' with '''replacement_pattern'''.

Revision as of 13:33, 30 January 2023

Summary

Function: string llReplaceSubString( string src, string pattern, string replacement_pattern, integer count );

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

Search JIRA for related Issues

Signature

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