Difference between revisions of "LlDumpList2String"

From Second Life Wiki
Jump to navigation Jump to search
m (The syntax highlighter is your friend.)
Line 2: Line 2:
|func_id=245|func_sleep=0.0|func_energy=10.0
|func_id=245|func_sleep=0.0|func_energy=10.0
|func=llDumpList2String|return_type=string|p1_type=list|p1_name=src|p2_type=string|p2_name=separator
|func=llDumpList2String|return_type=string|p1_type=list|p1_name=src|p2_type=string|p2_name=separator
|func_footnote
|func_footnote=Use [[llParseString2List]] or [[llParseStringKeepNulls]] to undo the process.
 
Unlike [[llList2CSV]] , which dumps a list to a comma-separated formatted string with no choice over the separator, llDumpList2String gives you more control. This can be useful if you don't trust commas as a separator because you might be working with data supplied to the script by a user who uses, say, commas as part of a street address.
|func_desc
|func_desc
|return_text=that is the list '''src''' converted to a string with '''separator''' between the entries.
|return_text=that is the list '''src''' converted to a string with '''separator''' between the entries.
|spec=Unlike [[llList2CSV]] , which dumps a list to a comma-separated formatted string with no choice over the separator, llDumpList2String gives you more control. This can be useful if you don't trust commas as a separator because you might be working with data supplied to the script by a user who uses, say, commas as part of a street address.
|spec
|notes
|caveats
|caveats
|constants
|constants
|examples=
|examples=
<lsl>list mylist = ["a", "b", "c", "d"];
string tmp = llDumpList2String(mylist, " ** ");
//tmp now equals: "a**b**c**d"</lsl>


<lsl>list mylist = [<10,5,7>, 100, "c", "d"];
string tmp = llDumpList2String(mylist, "**");
//tmp now equals: "<10,5,7>**100**c**d"</lsl>


list mylist = ["a", "b", "c", "d"];<br />
<lsl>default{
string tmp = llDumpList2String(mylist, " ** ");<br />
//tmp now equals: "a**b**c**d"<br />
 
list mylist = [<10,5,7>, 100, "c", "d"];<br />
string tmp = llDumpList2String(mylist, "**");<br />
//tmp now equals: "<10,5,7>**100**c**d"<br />
 
<lsl>
default{
     state_entry(){
     state_entry(){
         list my_list = [1, 2.0, "a string", llGetOwner()];
         list my_list = [1, 2.0, "a string", llGetOwner()];
Line 35: Line 34:
|also_tests
|also_tests
|also_articles=*{{LSLG|Typecast}}
|also_articles=*{{LSLG|Typecast}}
|notes=Use {{LSLG|llParseString2List}} or {{LSLG|llParseStringKeepNulls}} to undo the process.
|notes
|permission
|permission
|negative_index
|negative_index

Revision as of 04:41, 8 July 2008

Summary

Function: string llDumpList2String( list src, string separator );
0.0 Forced Delay
10.0 Energy

Returns a string that is the list src converted to a string with separator between the entries.

• list src
• string separator

Use llParseString2List or llParseStringKeepNulls to undo the process.

Unlike llList2CSV , which dumps a list to a comma-separated formatted string with no choice over the separator, llDumpList2String gives you more control. This can be useful if you don't trust commas as a separator because you might be working with data supplied to the script by a user who uses, say, commas as part of a street address.

Examples

<lsl>list mylist = ["a", "b", "c", "d"]; string tmp = llDumpList2String(mylist, " ** "); //tmp now equals: "a**b**c**d"</lsl>

<lsl>list mylist = [<10,5,7>, 100, "c", "d"]; string tmp = llDumpList2String(mylist, "**"); //tmp now equals: "<10,5,7>**100**c**d"</lsl>

<lsl>default{ 

   state_entry(){
       list my_list = [1, 2.0, "a string", llGetOwner()];
       llOwnerSay("<" + llDumpList2String(my_list,"><") + ">");        
   }
}</lsl>

Deep Notes

Signature

function string llDumpList2String( list src, string separator );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlDumpList2String&oldid=76985"