LlDeleteSubString

From Second Life Wiki

Jump to: navigation, search

Contents

Description

Function: string llDeleteSubString( string src, integer start, integer end );
95 Function ID
0.0 Delay
10.0 Energy

Returns a string that is the result of removing characters from src from start to end.

• string src
• integer start start index
• integer end end index


start & end support negative indexes.
It removes both start and end as a matter of course.

Specification

Index Positive Negative
First 0 -length
Last length - 1 -1

Mentally first translate any negative indexes into positive indexes

  • If start <= end then the range operated on starts at start and ends at end. [start, end]
  • If start > end then the range operated on starts at 0 and goes to end and then starts again at start and goes to -1. [0, end] + [start, -1]

Positive indexes past the length (after the last index), or negative indexes past the beginning (before the first index) are valid. The effects are predictable, the entries are treated as if they were there but were removed just before output.

See negative indexes for more information.

Examples

 
default
{
    state_entry()
    {
        string ex = "abcdefghi";
        llDeleteSubString(ex, 4, 7); //Incorrect!
    }
}

 
default
{
    state_entry()
    {
        string ex = "abcdefghi";
        ex = llDeleteSubString(ex, 4, 7); //Correct
        llSay(0, ex); //Would say "abcdi"
    }
}
 

 
//-- special case
default
{
    state_entry()
    {
        string ex = "abcdefghi";
        llSay( 0, llDeleteSubString(ex, 4, 7) ); //Would say "abcdi"
        //-- acceptable if you do NOT want to change the contents of 'ex', only the output
    }
}
 

See Also

Functions

•  llGetSubString
•  llInsertString

Articles

•  Negative Index
•  CombinedLibrary: str_replace
Personal tools