Difference between revisions of "LlLinksetDataRead"

From Second Life Wiki
Jump to navigation Jump to search
m
m
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL Function/Headless
|default={{{default|}}}
|inject-2=
|summary=The '''llLinksetDataRead''' and '''llLinksetDataReadProtected''' functions return the '''value''' in the linkset's datastore for the provided {{LSLP|name}}. If {{LSLP|name}} is not found, these functions return an empty string.
|func=llLinksetDataRead|sort={{{sort|LinksetDataRead}}}
|head={{LSL Function/Head
|func_id=|func_sleep=0|func_energy=10.0
|func=llLinksetDataRead
|p1_type=string|p1_name=name|p1_desc=The key of the linkset '''name:value''' pair to be read.
|return_type=string
|return_text='''value''' corresponding to {{LSLP|name}}
|func_desc=Reads an unprotected '''name:value''' pair from the linkset's datastore.
|caveats=If the {{LSLP|name}} is an empty string, or the '''name:value''' pair was created with [[llLinksetDataWriteProtected]] this function returns an empty string.
}}{{LSL_Function/Head
|func_sleep=0.0|func_energy=10.0
|func_sleep=0.0|func_energy=10.0
|func=llLinksetDataRead
|func=llLinksetDataReadProtected
|p1_type=string|p1_name=key|p1_desc=The '''key''' of the '''key:value''' pair to be read.
|p1_type=string|p1_name=name|p1_desc=The '''key''' of the '''name:value''' pair to be read.
|p2_type=string|p2_name=pass|p2_desc=The pass phrase protecting the '''name:value''' pair.
|return_type=string
|return_type=string
|return_text='''value''' corresponding to {{LSLP|key}}
|return_text='''value''' corresponding to {{LSLP|name}}
|func_footnote
|func_footnote
|func_desc=The '''llLinksetDataRead''' function returns the '''value''' in the linkset's datastore for the provided {{LSLP|key}}. If {{LSLP|key}} is not found, this function returns an empty string.
|func_desc=Reads a protected '''name:value''' pair from the datastore.
|func_footnote
|func_footnote
|caveats=If the {{LSLP|pass}} parameter does not match, this function returns an empty string.
|spec
|spec
}}
|caveats
|caveats
|helpers
|helpers
Line 15: Line 31:
{{LSL DefineRow||[[llLinksetDataCountKeys]]|}}
{{LSL DefineRow||[[llLinksetDataCountKeys]]|}}
{{LSL DefineRow||[[llLinksetDataDelete]]|}}
{{LSL DefineRow||[[llLinksetDataDelete]]|}}
{{LSL DefineRow||[[llLinksetDataDeleteProtected]]|}}
{{LSL DefineRow||[[llLinksetDataDeleteFound]]|}}
{{LSL DefineRow||[[llLinksetDataFindKeys]]|}}
{{LSL DefineRow||[[llLinksetDataFindKeys]]|}}
{{LSL DefineRow||[[llLinksetDataListKeys]]|}}
{{LSL DefineRow||[[llLinksetDataListKeys]]|}}
{{LSL DefineRow||[[llLinksetDataReset]]|}}
{{LSL DefineRow||[[llLinksetDataReset]]|}}
{{LSL DefineRow||[[llLinksetDataWrite]]|}}
{{LSL DefineRow||[[llLinksetDataWrite]]|}}
{{LSL DefineRow||[[llLinksetDataWriteProtected]]|}}
|also_events
|also_events
|also_tests
|also_tests

Latest revision as of 10:56, 14 August 2024

Summary

Summary: llLinksetDataRead, llLinksetDataReadProtected

The llLinksetDataRead and llLinksetDataReadProtected functions return the value in the linkset's datastore for the provided name. If name is not found, these functions return an empty string.

llLinksetDataRead

Function: string llLinksetDataRead( string name );

Reads an unprotected name:value pair from the linkset's datastore.
Returns a string value corresponding to name

• string name The key of the linkset name:value pair to be read.
Caveats

If the name is an empty string, or the name:value pair was created with llLinksetDataWriteProtected this function returns an empty string.

llLinksetDataReadProtected

Function: string llLinksetDataReadProtected( string name, string pass );
0.0 Forced Delay
10.0 Energy

Reads a protected name:value pair from the datastore.
Returns a string value corresponding to name

• string name The key of the linkset name:value pair to be read.The key of the name:value pair to be read.
• string pass The pass phrase protecting the name:value pair.
Caveats

If the pass parameter does not match, this function returns an empty string.

Examples

Deep Notes

Signature

function string llLinksetDataRead( string name );
function string llLinksetDataReadProtected( string name, string pass );