Difference between revisions of "LlGetNotecardLine"

From Second Life Wiki
Jump to navigation Jump to search
Line 5: Line 5:
|return_type=key
|return_type=key
|p1_type=string|p1_name=name
|p1_type=string|p1_name=name
|p2_type=integer|p2_name=line|p2_desc=Line number of a notecard.
|p2_type=integer|p2_name=line|p2_desc=Line number of a notecard (the index starts at zero).
|func_desc=Requests the line '''line''' of the notecard '''name''' from the dataserver.
|func_desc=Requests the line '''line''' of the notecard '''name''' from the dataserver.
|return_text=that is the handle for a {{LSLG|dataserver}} event responce.
|return_text=that is the handle for a {{LSLG|dataserver}} event responce.
|func_footnote=If '''line''' is passed the end of the notecard {{LSLG|EOF}} is returned by the {{LSLG|dataserver}}. If the return is a {{LSLG|NULL_KEY}} then notecard could not be found in inventory???
|func_footnote=If '''line''' is passed the end of the notecard {{LSLG|EOF}} is returned by the {{LSLG|dataserver}}. If the return is a {{LSLG|NULL_KEY}} then notecard could not be found in inventory???
|spec
|spec
|caveats=* If the notecard cannot be found in inventory and it is not a UUID then an error will be shouted on {{LSLG|DEBUG_CHANNEL}}???
|caveats
|constants
|constants
|examples
|examples
|helpers
|helpers
|also_functions=* {{LSLG|llGetNumberOfNotecardLines}}
|also_functions={{LSL DefineRow||[[llGetNumberOfNotecardLines]]|}}
|also_events=* {{LSLG|dataserver}}
|also_events={{LSL DefineRow||[[dataserver]]|}}
|also_articles
|also_articles
|also_tests
|notes
|notes
|permission
|permission

Revision as of 22:19, 22 February 2007

Summary

Function: key llGetNotecardLine( string name, integer line );
0.1 Forced Delay
10.0 Energy

Requests the line line of the notecard name from the dataserver.
Returns a key that is the handle for a dataserver event responce.

• string name a notecard in the inventory of the prim this script is in or a UUID of a notecard
• integer line Line number of a notecard (the index starts at zero).

If line is passed the end of the notecard EOF is returned by the dataserver. If the return is a NULL_KEY then notecard could not be found in inventory???

Caveats

  • This function causes the script to sleep for 0.1 seconds.
  • If name is missing from the prim's inventory and it is not a UUID or it is not a notecard then an error is shouted on DEBUG_CHANNEL.
  • If name is a UUID then there are no new asset permissions consequences for the object.
    • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.

Examples

See Also

Events

•  dataserver

Functions

•  llGetNumberOfNotecardLines

Deep Notes

Signature

function key llGetNotecardLine( string name, integer line );