llReplaceSubString

From Second Life Wiki
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

<source lang="lsl2"> 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"
   }

}</source> <source lang="lsl2"> 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"
   }

}</source> <source lang="lsl2"> 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"
   }
}</source>

See Also

Deep Notes

Signature

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