Difference between revisions of "LlInsertString"
Jump to navigation
Jump to search
(should go under articles or in helpers; code needs to run flawlessly and when not flawless it needs to have the caveats clearly stated.) |
(add reference to llReplaceSubString) |
||
| (13 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function/negative_index|false| | {{LSL_Function | ||
|inject-3={{LSL_Function/negative_index|false|pos}} | |||
|func_id=96|func_sleep=0.0|func_energy=10.0 | |func_id=96|func_sleep=0.0|func_energy=10.0 | ||
|func=llInsertString|return_type=string | |func=llInsertString|return_type=string | ||
|p1_type=string|p1_name=dst | |p1_type=string|p1_name=dst|p1_desc=destination of insertion | ||
|p2_type=integer|p2_name=position | |p2_type=integer|p2_name=pos|p2_desc=position index for insert, first is 0 | ||
|p3_type=string|p3_name=src | |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={{LSLP|dst}} with {{LSLP|src}} inserted starting at {{LSLP|pos}}. | ||
|spec | |spec | ||
|caveats | |caveats | ||
|constants | |constants | ||
|examples= | |examples= | ||
< | <source lang="lsl2">llInsertString("input", 2, "put out")// returns "input output"</source> | ||
|helpers | |helpers=This function will allow you to use a negative number as the position: | ||
<source lang="lsl2">string insertString(string destination, integer position, string str) { | |||
if (position < 0) | |||
if ((position += llStringLength(destination)) < 0) | |||
position = 0; | |||
return llInsertString(destination, position, str); | |||
}</source> | |||
|also_functions={{LSL DefineRow||[[llDeleteSubString]]}} | |also_functions={{LSL DefineRow||[[llDeleteSubString]]}} | ||
{{LSL DefineRow||[[llGetSubString]]}} | {{LSL DefineRow||[[llGetSubString]]}} | ||
{{LSL DefineRow||[[llReplaceSubString]]|}} | |||
|also_events | |also_events | ||
|also_tests | |also_tests | ||
|also_articles={{LSL DefineRow||[[Library_Combined_Library#str_replace| | |also_articles={{LSL DefineRow||[[:Category:LSL Examples|Examples:]] [[Library_Combined_Library#str_replace|str_replace]]|Replace all instances of a string with another string in a target string}} | ||
{{LSL DefineRow||[[:Category:LSL Examples|Examples:]] [[SplitLine]]|Insert 'new line' escape codes at certain positions of a string}} | |||
|notes | |notes | ||
|helpers | |helpers | ||
Latest revision as of 12:30, 30 January 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llInsertString( string dst, integer pos, string src );| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns the 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
llInsertString("input", 2, "put out")// returns "input output"
Useful Snippets
This function will allow you to use a negative number as the position:
string insertString(string destination, integer position, string str) {
if (position < 0)
if ((position += llStringLength(destination)) < 0)
position = 0;
return llInsertString(destination, position, str);
}
See Also
Functions
| • | llDeleteSubString | |||
| • | llGetSubString | |||
| • | llReplaceSubString |
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
Signature |
|---|
function string llInsertString( string dst, integer pos, string src ); |