llGetNumberOfNotecardLines

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

GetNumberOfNotecardLines

llGetNumberOfNotecardLines

Summary

Function: key llGetNumberOfNotecardLines( string name );

0.1	Forced Delay
10.0	Energy

Requests the number of lines in notecard name via the dataserver event (cast dataserver value to integer)
Returns the handle (a key) for a dataserver event response.

• string

name

–

a notecard in the inventory of the prim this script is in or a UUID of a notecard

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.
• If name is a new empty notecard (never saved) then an error "Couldn't find notecard ~NAME~" (~NAME~ being the value of name) will be shouted on the DEBUG_CHANNEL. This is because until a notecard is saved for the first time, it does not exist as an asset only as an inventory placeholder.
  • If the notecard is full-perms you can check for this with llGetInventoryKey which will return NULL_KEY in this case. However if notecard is not full-perms, there is no way to avoid the error message.
• If notecard contains embedded inventory items (such as textures and landmarks), invalid data will be returned.

Examples

<lsl> // Ascertain the number of lines in a notecard in the prim's contents

string gNotecard = "Config"; // Name of notecard to be examined key gLineRequestID; // Identity of expected dataserver event integer gLineCounter; // The number of lines in the NC, as determined by this script

default {

   state_entry()
   {
       // Ask how many lines are in the notecard.
       // The answer will arrive via a dataserver event
       gLineRequestID = llGetNumberOfNotecardLines(gNotecard);
   }
   
   dataserver(key requested, string data)
   {
       if (requested == gLineRequestID)
       {
           llOwnerSay( "The notecard '" + gNotecard + "' contains " + data + " lines" );
           // cast the data string to an integer if you need to access the counter later
           gLineCounter = (integer) data;
       }        
   }

} </lsl> <lsl> // Check for a valid existant notecard, and read it into a list // On touch, say the total number of lines, number of lines containing data, and say each line // Omei Qunhua 7-Jan-2013

string gNotecard = "Config"; // Name of notecard to be examined key gLineRequestID; // Identity of expected line count dataserver event key gReadRequestID; // Identity of expected data read dataserver event integer gLineTotal; // The number of lines in the NC, as determined by this script integer gLineIndex; // Index for data read requests list gDataLines; // List containing all data lines from notecard, excluding blank and comment lines string gStatus; // Will contain EOF when notecard reading has finished

default {

   state_entry()
   {
       if (llGetInventoryKey(gNotecard) )         // Test if notecard exists and has been saved (returned key will be NULL_KEY otherwise)
           gLineRequestID = llGetNumberOfNotecardLines(gNotecard);       // Kick off a request for the total number of lines that the notecard contains
       else
           llOwnerSay("Notecard '" + gNotecard + "' does not exist or has no saved data");
   }
   changed(integer change)
   {
       if (change & CHANGED_INVENTORY)
           llResetScript();
   }
   dataserver(key requested, string data)
   {
       if (requested == gLineRequestID)
       {
           gLineTotal = (integer) data;           // Cast the data string to an integer to get the number of lines
           gReadRequestID = llGetNotecardLine(gNotecard, gLineIndex);      // Request a read of the first notecard line
           return;
       }
       if (requested != gReadRequestID)
           return;
       if ( (gStatus = data) == EOF)              // Save and test the current data (so that other code can tell when we've finished too)
           return;

       // A notecard line has been read. Kick off the process of fetching the next line, while we process this line
       gReadRequestID = llGetNotecardLine(gNotecard, ++gLineIndex);

       data = llStringTrim(data, STRING_TRIM);    // chop off any leading or trailing blanks

if (data == ""

See Also

Events

•

dataserver

Functions

•

llGetNotecardLine

Deep Notes

Signature
function key llGetNumberOfNotecardLines( string name );