LlLinksetDataListKeys: Difference between revisions

From Second Life Wiki
Jump to navigation Jump to search
Nelson Jenkins (talk | contribs)
m added text re: ordering and re: count - start exceeding total keys
Madi Melodious (talk | contribs)
No edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 10: Line 10:
|func_footnote
|func_footnote
|spec
|spec
|examples=
The following code will list all the keys in a object. Only 1024 characters will be displayed due to limitations of [[llSay]].
<syntaxhighlight lang="lsl2">
// Retrieving too many entries from LinksetData can trigger a stack or heap error if the number of entries exceeds the available memory.  Use with caution.
default
{
    state_entry()
    {
        llSay(0, llDumpList2String(llLinksetDataListKeys(0, 0), "\n"));
    }
}
</syntaxhighlight>
|caveats
|caveats
|helpers
|helpers
Line 16: Line 30:
{{LSL DefineRow||[[llLinksetDataCountKeys]]|}}
{{LSL DefineRow||[[llLinksetDataCountKeys]]|}}
{{LSL DefineRow||[[llLinksetDataDelete]]|}}
{{LSL DefineRow||[[llLinksetDataDelete]]|}}
{{LSL DefineRow||[[llLinksetDataDeleteFound]]|}}
{{LSL DefineRow||[[llLinksetDataFindKeys]]|}}
{{LSL DefineRow||[[llLinksetDataFindKeys]]|}}
{{LSL DefineRow||[[llLinksetDataRead]]|}}
{{LSL DefineRow||[[llLinksetDataRead]]|}}

Latest revision as of 14:30, 3 August 2025

Summary

Function: list llLinksetDataListKeys( integer start, integer count );
0.0 Forced Delay
10.0 Energy

The llLinksetDataListKeys function returns a list of up to count keys in the datastore, starting at the one indicated by start. If count is less than 1, then all keys between start and the end are returned. If count minus start exceeds the total number of keys, the returned list will be shorter than count, down to a zero-length list if start equals or exceeds the total number of keys.
Returns a list of the keys in the datastore, ordered alphabetically.

• integer start The first key to return.
• integer count The number of keys to return.

Examples

The following code will list all the keys in a object. Only 1024 characters will be displayed due to limitations of llSay.

// Retrieving too many entries from LinksetData can trigger a stack or heap error if the number of entries exceeds the available memory.  Use with caution.

default
{
    state_entry()
    {
        llSay(0, llDumpList2String(llLinksetDataListKeys(0, 0), "\n"));
    }
}

Deep Notes

Signature

function list llLinksetDataListKeys( integer start, integer count );