LlLinksetDataRead

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.

Function: string llLinksetDataRead( string name );


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.

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.

Caveats

While LSL scripts use UTF-16 encoding for strings resulting in 2 bytes per character for codepoints up to U+FFFF or 4 bytes otherwise, linkset data uses UTF-8 for a more varying encoding size (1 byte up to codepoint U+7F, 2 bytes up to U+7FF, 3 bytes up to U+FFFF and 4 bytes otherwise). Although a niche concern, this can result in strings not having an immediately obvious size and in very constrained situations, possibly not fit in script memory/linkset data.

Examples

Deep Notes

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

LlLinksetDataRead

Contents

Summary