Difference between revisions of "LlLinksetDataRead"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
All Issues ~ Search JIRA for related Bugs
m |
m (Changed 'missing' to 'an empty string' due to someone in a popular help group not understanding the similarity...) |
||
| (5 intermediate revisions by 3 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= | |func=llLinksetDataReadProtected | ||
|p1_type=string|p1_name= | |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 | |return_text='''value''' corresponding to {{LSLP|name}} | ||
|func_footnote | |func_footnote | ||
|func_desc= | |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||[[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 21:31, 27 December 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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 );| ? | Function ID |
| 0 | Forced Delay |
| 10.0 | Energy |
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 );| ? | Function ID |
| 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.
Caveats
Examples
See Also
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function string llLinksetDataRead( string name ); function string llLinksetDataReadProtected( string name, string pass ); |