OsGetNotecard

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m (some syntax modification (may be major or minor))
Line 2: Line 2:
 
|threat_level=VeryHigh
 
|threat_level=VeryHigh
 
|function_syntax=string osGetNotecard(string name)
 
|function_syntax=string osGetNotecard(string name)
|ossl_example=
+
|ossl_example=<source lang="lsl">
 +
// ----------------------------------------------------------------
 +
// Example / Sample Script to show function use.
 +
//
 +
// Script Title:    osGetNotecard.lsl
 +
// Script Author:
 +
// Threat Level:    VeryHigh
 +
// Script Source:  http://opensimulator.org/wiki/osGetNotecard
 +
//
 +
// Notes: See Script Source reference for more detailed information
 +
// This sample is full opensource and available to use as you see fit and desire.
 +
// Threat Levels only apply to OSSL & AA Functions
 +
// See http://opensimulator.org/wiki/Threat_level
 +
// ================================================================
 +
// Inworld Script Line:    string osGetNotecard(string name);
 +
//
 +
// Example of osGetNotecard(name)
 +
//
 +
default
 +
{
 +
    state_entry()
 +
    {
 +
        llSay(0,"Touch to see osGetNotecard read in a notecard and display the text retrieved");
 +
    }
 +
    touch_end(integer num)
 +
    {
 +
        // get the first notecard in inventory (default max is 255 lines and would not show in std chat)
 +
        // each Line Return is reflected in output
 +
        string name = llGetInventoryName(INVENTORY_NOTECARD,0);
 +
        if(name == "")
 +
        {
 +
            llSay(0,"There is no notecard in prim inventory.  Please place a notecard with some text in the prim to display it's contents");
 +
            return;
 +
        }
 +
        else
 +
        {
 +
            string text = osGetNotecard(name);
 +
            llOwnerSay("NoteCard Name is: "+name);
 +
            llSay(0,text);
 +
        }
 +
 
 +
    }
 +
}
 +
 
 +
</source>
 
|description=This function directly reads the entire contents of a notecard if it exists within the task inventory, and dumps it into a string. It skips the dataserver event, thereby reducing code complexity.  
 
|description=This function directly reads the entire contents of a notecard if it exists within the task inventory, and dumps it into a string. It skips the dataserver event, thereby reducing code complexity.  
 
|
 
|
 
}}
 
}}

Revision as of 10:05, 30 July 2011

string osGetNotecard(string name)
This function directly reads the entire contents of a notecard if it exists within the task inventory, and dumps it into a string. It skips the dataserver event, thereby reducing code complexity.
Threat Level VeryHigh
Permissions No permissions specified
Delay No function delay specified
Example(s)
// ----------------------------------------------------------------
// Example / Sample Script to show function use.
//
// Script Title:    osGetNotecard.lsl
// Script Author:
// Threat Level:    VeryHigh
// Script Source:   http://opensimulator.org/wiki/osGetNotecard
//
// Notes: See Script Source reference for more detailed information
// This sample is full opensource and available to use as you see fit and desire.
// Threat Levels only apply to OSSL & AA Functions
// See http://opensimulator.org/wiki/Threat_level
// ================================================================
// Inworld Script Line:    string osGetNotecard(string name);
//
// Example of osGetNotecard(name) 
// 
default
{
    state_entry()
    {
         llSay(0,"Touch to see osGetNotecard read in a notecard and display the text retrieved"); 
    }
    touch_end(integer num)
    {
        // get the first notecard in inventory (default max is 255 lines and would not show in std chat)
        // each Line Return is reflected in output
        string name = llGetInventoryName(INVENTORY_NOTECARD,0);
        if(name == "") 
        {
            llSay(0,"There is no notecard in prim inventory.  Please place a notecard with some text in the prim to display it's contents"); 
            return;
        }
        else
        {
            string text = osGetNotecard(name);
            llOwnerSay("NoteCard Name is: "+name);
            llSay(0,text);
        }
 
    }
}
Personal tools
General
About This Wiki