OsGetNotecard
From OpenSimulator
(Difference between revisions)
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 |
Extra 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); } } } |