llParseStringKeepNulls

From Second Life Wiki
Revision as of 19:43, 27 September 2007 by Ppaatt Lynagh (talk | contribs) ((add Separate Words to the list of helpers - although that markup looks wrong to me, these are not LSL functions, these are Script Library))
Jump to navigation Jump to search

Summary

Function: list llParseStringKeepNulls( string src, list separators, list spacers );
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

separators and spacers must be lists of strings, maximum of 8 each.

Caveats

  • Every element in the list will be a string, no matter what you think it should be. Cast the results of llList2String to get what you want.
    • integer my_int = (integer)llList2String(my_list,i);
      • llList2String is used here, as llList2Integer can only handle integers in simple notation, ie. will not handle hexadecimal integers or scientific notation.

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

•  ParseString2List Functions the same as llParseString2List and llParseStringKeepNulls but without limitations.
•  separateWords Functions the same as llParseString2List but without limitations, also readably correct at a glance.

Deep Notes

Signature

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