Difference between revisions of "LlInsertString"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
|||
| Line 4: | Line 4: | ||
|p2_type=integer|p2_name=pos|p2_desc=position index for insert, first is 0 | |p2_type=integer|p2_name=pos|p2_desc=position index for insert, first is 0 | ||
|p3_type=string|p3_name=src|p3_desc=source string to be inserted | |p3_type=string|p3_name=src|p3_desc=source string to be inserted | ||
|func_footnote | |func_footnote=I.e., unlike other somewhat similar string functions such as [[llGetSubString]] and [[llDeleteSubString]], you cannot use -1 for the counting with this function. You may use instead the function provided a bit further below. | ||
|func_desc | |func_desc | ||
|return_text='''dst''' with '''src''' inserted starting at '''pos'''. | |return_text='''dst''' with '''src''' inserted starting at '''pos'''. | ||
| Line 14: | Line 14: | ||
llInsertString("input", 2, "put out")// returns "input output" | llInsertString("input", 2, "put out")// returns "input output" | ||
</lsl> | </lsl> | ||
This function written by Strife Onizuka will allow you to use a negative number as the position: | |||
<lsl> | |||
string insertString(string destination, integer position, string str) { | |||
if (position < 0) | |||
position += llStringLength(destination); | |||
return llInsertString(destination, position, str); | |||
} | |||
</lsl> | |||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llDeleteSubString]]}} | |also_functions={{LSL DefineRow||[[llDeleteSubString]]}} | ||
Revision as of 21:00, 7 July 2008
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llInsertString( string dst, integer pos, string src );| 96 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a string dst with src inserted starting at pos.
| • string | dst | – | destination of insertion | |
| • integer | pos | – | position index for insert, first is 0 | |
| • string | src | – | source string to be inserted |
pos does not support negative indexes. I.e., unlike other somewhat similar string functions such as llGetSubString and llDeleteSubString, you cannot use -1 for the counting with this function. You may use instead the function provided a bit further below.
Caveats
- If pos is out of bounds the script continues to execute without an error message.
Examples
<lsl> llInsertString("input", 2, "put out")// returns "input output" </lsl>
This function written by Strife Onizuka will allow you to use a negative number as the position:
<lsl> string insertString(string destination, integer position, string str) {
if (position < 0)
position += llStringLength(destination);
return llInsertString(destination, position, str);
}
</lsl>See Also
Functions
| • | llDeleteSubString | |||
| • | llGetSubString |
Articles
| • | Examples: str_replace | – | Replace all instances of a string with another string in a target string | |
| • | Examples: SplitLine | – | Insert 'new line' escape codes at certain positions of a string |
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function string llInsertString( string dst, integer pos, string src ); |