llParseStringKeepNulls

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

ParseStringKeepNulls

llParseStringKeepNulls

Summary

Function: list llParseStringKeepNulls( string src, list separators, list spacers );

285	Function ID
0.0	Forced Delay
10.0	Energy

Returns a list that is src broken into a list, discarding separators, keeping spacers, keeping any null values generated.

• string	src	–	source string
• list	separators	–	separators to be discarded
• list	spacers	–	spacers to be kept

Caveats

The behaviour is identical to that for llParseString2List, except blank strings found in the list are kept. This is useful when, if you lost them, the order of things in the list would change, and that would impact what you expect to find, where.

llGetListLength(llParseListKeepNulls("", ["]_["], [])) will equal 1, even though you might think the list is empty (it actually has 1 value in it, even if that value happens to be empty.)

• Only the first 8 separators and first 8 spacers will be used any extras will be ignored.
• All separators and spacers must be strings, all other types will be ignored.
• Separators take precedent over spacers. The string is parsed from start to finish, each position is compared against the separators then spacers before moving onto the next position.
• Duplicates are ignored.
• All entries in the return are typed as string. Use explicit typecasting on llList2String to convert the values into other types. Do not rely upon the implicit typecasting of the other llList2* functions (as they typically return a default value).

All Issues ~ Search JIRA for related Bugs

Examples

default
{
    state_entry()
    {
        // This will say:
        // <A><crazy><fox><.><Saw><the><moon><.><.>
        string my_string = "A crazy fox.  Saw the moon..";
        list my_list = llParseString2List(my_string,[" "],["."]);
        llOwnerSay("<" + llDumpList2String(my_list,"><") + ">");
        
        // This will say:
        //  <A><crazy><fox><.><><><Saw><the><moon><.><><.><>
        my_list = llParseStringKeepNulls(my_string,[" "],["."]);
        llOwnerSay("<" + llDumpList2String(my_list,"><") + ">");
    }
}

Useful Snippets

Replacement functions without or very large separator/spacer count limits

•	ParseString2List	–	Functions exactly the same as llParseString2List and llParseStringKeepNulls.
•	separateWords	–	Functions exactly the same as llParseString2List unless you violate the preconditions. Also correct at a glance.

See Also

Functions

• llParseString2List
• llDumpList2String
• llCSV2List
• llList2CSV

Deep Notes

Search JIRA for related Issues

Signature
function list llParseStringKeepNulls( string src, list separators, list spacers );