2020年7月6日 (一) 08:36 Wzc

2020-07-06T08:36:04Z

2020年7月6日 (一) 08:33 Wzc

2020-07-06T08:33:57Z

Wzc：创建页面，内容为“{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}} {{函数详情 |函数名 =Function: key llGetNotecardLine( string name, integer line ); |参数…”

2020-07-06T08:31:52Z

创建页面，内容为“{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}} {{函数详情 |函数名 =Function: key llGetNotecardLine( string name, integer line ); |参数…”

新页面

{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}}

{{函数详情
|函数名 =Function: key llGetNotecardLine( string name, integer line );
|参数= 参数：
•字符串名称（string name）–此脚本所在的prim目录中的记事本或记事本卡的UUID

•整数行（ integer line ）–记事本卡中的行号（索引从零开始）。

行不支持负索引。

如果行超过了notecard的结尾，则数据服务器将返回EOF。

|返回值= 返回值：从数据服务器请求notecard名称的行。
返回数据服务器事件响应的句柄（键）。

|注意事项=
•此函数使脚本休眠0.1秒。

•如果行超出边界，脚本将继续执行而不显示错误消息。

•如果prim的清单中缺少name，并且它不是UUID或不是notecard，那么DEBUG峎CHANNEL上会发出一个错误。

•如果name是一个UUID，则对象没有新的资产权限后果。

•生成的对象不会产生新的使用限制，如果资产被放在prims库存中，可能会出现这种情况。

•如果name是一个新的空记事本卡（从未保存过），那么DEBUG频道上将出现错误“找不到notecard~name~”（~name~是name的值）。这是因为在第一次保存记事本卡之前，它并不是仅作为库存占位符作为资产存在的。

•如果notecard是full perms，您可以使用llGetInventoryKey来检查它，在这种情况下，它将返回NULL_KEY。但是，如果notecard不是完全烫发，则无法避免错误消息。

•如果notecard包含嵌入的库存项（如纹理和地标），则无论请求的行是什么，都将返回EOF。

•如果请求的行超过255个字节，数据服务器将返回该行的前255个字节。

'''Notes'''
记事本读卡可以是no modify，也可以是no modify/no copy。

|示例=
示例1
<pre>
key notecardQueryId;
string notecardName = "name of notecard as in object's contents";

// script-wise, the first notecard line is line 0, the second line is line 1, etc.
integer notecardLine;

say(string inputString)
{
llOwnerSay(inputString);
}

default
{
state_entry()
{
// Check the notecard exists, and has been saved
if (llGetInventoryKey(notecardName) == NULL_KEY)
{
llOwnerSay( "Notecard '" + notecardName + "' missing or unwritten");
return;
}
// say("reading notecard named '" + notecardName + "'.");
notecardQueryId = llGetNotecardLine(notecardName, notecardLine);
}

dataserver(key query_id, string data)
{
if (query_id == notecardQueryId)
{
if (data == EOF)
say("Done reading notecard, read " + (string) notecardLine + " notecard lines.");
else
{
// bump line number for reporting purposes and in preparation for reading next line
++notecardLine;
say( "Line: " + (string) notecardLine + " " + data);
notecardQueryId = llGetNotecardLine(notecardName, notecardLine);
}
}
}
}

== Useful Snippets ==
/////
// Generic Multi Notecard reader by Brangus Weir
// Given freely and published on wiki.secondlife.com
//
// This script will read three note cards and store the results into three lists.
// It can be modified and extended to as many (or few) cards as you'd like to read.
//

list gOneCard; // All the lines from from the first card
list gTwoCard; // All the lines from from the second card
list gThreeCard; // All the lines from from the third card

string gsCardOneName = "One"; //Set these to the name of the invetory item.
string gsCardTwoName = "Two";
string gsCardThreeName = "Three";

//Temporary variables for processing
string g_sNoteCardName; // Name of the card to be read.
list g_lTempLines; // The resulting data pushed into a list
integer g_iLine; // The line count for the card reader
key g_kQuery; // The key of the card being read

initialize(string _action) {
// Due to the execution order when using dataserver, this function sets the first card to
// be read, and the excetuion finishes when called again with the _action set to "finish".
if (_action == "") {
loadNoteCard(gsCardOneName);
} else if (_action == "finish") {
// All cards have been read into the lists... now you can do any kind of string
// manipulations to get the data you need to set your script.
// But here we will prove that the cards have been read with a loop

g_lTempLines = []; // lets not forget to delete this global, or it will be dead weight.

integer len = llGetListLength(gOneCard); //Always evaluate this once, don't do it
//INSIDE the for loop like noob programers will.
//Reduce lag, THINK ABOUT MACHINE CYCLES!
integer i = 0;
for (; i< len; ++i)
llSay(0, llList2String(gOneCard,i));

len = llGetListLength(gTwoCard);
for (i = 0; i< len; ++i)
llSay(0, llList2String(gTwoCard,i));

len = llGetListLength(gThreeCard);
for (i = 0; i< len; ++i)
llSay(0, llList2String(gThreeCard,i));
}

}

loadNoteCard( string _notecard ) {
g_lTempLines = []; //clear the temp lines
g_sNoteCardName = _notecard;
g_iLine = 0;
g_kQuery = llGetNotecardLine(g_sNoteCardName, g_iLine);

}

notecardFinished(string _notecard){
// Called at the end of each notecard as it is read. The temp results are stored
// and the next card is commanded to be read.
if (_notecard == gsCardOneName) {
gOneCard = g_lTempLines;
loadNoteCard(gsCardTwoName);
} else if (_notecard == gsCardTwoName) {
gTwoCard = g_lTempLines;
loadNoteCard(gsCardThreeName);
} else if (_notecard == gsCardThreeName) {
gThreeCard = g_lTempLines;
initialize("finish"); // Finally pass execution to finish the initialization.
}
}

default
{
state_entry()
{
}

touch_start(integer _num_det){
initialize("");
}

dataserver(key _query_id, string _data)
{
if (_query_id == g_kQuery) {
// this is a line of our notecard
if (_data != EOF) {
g_lTempLines += _data;
//request a next line
++g_iLine; // increment line count
g_kQuery = llGetNotecardLine(g_sNoteCardName, g_iLine);
} else {
//The notecard has been read
//notify end of read
notecardFinished(g_sNoteCardName);
}
}
}
}

----

/////
// Generic Multi Notecard reader by Randur Source
// Given freely and published on wiki.secondlife.com
//
// This script will read all note cards in sequence and dump the results into chat as an example.
// It can be modified and extended to do other things to the data.
//

integer inventorycnt;
integer notecardlinecnt;
integer notecardlinenumber;
string notecardname;
key linenumberid;
key lineid;

getnextnotecardlinenumber()
{
// first get the number of lines from the notecard
inventorycnt++;
if (inventorycnt < llGetInventoryNumber(INVENTORY_NOTECARD))
{
notecardname = llGetInventoryName(INVENTORY_NOTECARD,inventorycnt);
linenumberid = llGetNumberOfNotecardLines(notecardname);
}
else
llOwnerSay("Done.");
}

getnextnotecardline()
{
// get the next line from the notecard or skip to the next notecard
notecardlinecnt++;
if (notecardlinecnt < notecardlinenumber)
lineid = llGetNotecardLine(notecardname,notecardlinecnt);
else
getnextnotecardlinenumber();
}

default
{
touch_start(integer total_number)
{
if (llDetectedKey(0) != llGetOwner()) return; // allow owner only

inventorycnt = -1;
getnextnotecardlinenumber();
}

dataserver(key queryid,string data)
{
if (queryid == linenumberid) // this was a line number lookup
{
linenumberid = NULL_KEY;
notecardlinenumber = (integer)data;
if (notecardlinenumber == 0)
getnextnotecardlinenumber();
else
{
notecardlinecnt = -1;
getnextnotecardline();
}
}
else if (queryid == lineid) // this was a data line lookup
{
lineid = NULL_KEY;

// Example of what to do with the data:
// Test for valid avatar names, possibly multiple names on each line, separated by ,
// and say them in chat to the owner
list names = llParseString2List(data,[","],[]); // split lines on ,
integer len = llGetListLength(names); // I wouldn't dare to put this inside the for loop
integer cnt;
for (cnt = 0; cnt < len; cnt++)
{
string name = llDumpList2String(llParseString2List(llList2String(names,cnt),[" "],[])," "); // remove extra spaces
if (llGetListLength(llParseString2List(name,[" "],[])) == 2) // check for first + lastname
llOwnerSay(notecardname + ": " + name);
}

getnextnotecardline();
}
}
}
</pre>

|相关函数=
无

|相关事件=
无
}}
附录：（表格）
{| class="wikitable" border="1"
|-
! header 1
! header 2
! header 3
|-
| row 1, cell 1
| row 1, cell 2
| row 1, cell 3
|-
| row 2, cell 1
| row 2, cell 2
| row 2, cell 3
|}

另外如果遇到有specification的情况等可以加到注意事项里面。
在注意事项里面：回车=另起一行回车+开头空两格=方框（类似于示例里面的）

@@ 第28行： / 第28行： @@
   •生成的对象不会产生新的使用限制，如果资产被放在prims库存中，可能会出现这种情况。
- •如果name是一个新的空记事本卡（从未保存过），那么DEBUG频道上将出现错误“找不到notecard~name~”（~name~是name的值）。这是因为在第一次保存记事本卡之前，它并不是仅作为库存占位符作为资产存在的。
+•如果name是一个新的空记事本卡（从未保存过），那么DEBUG频道上将出现错误“找不到notecard~name~”（~name~是name的值）。这是因为在第一次保存记事本卡之前，它并不是仅作为库存占位符作为资产存在的。
   •如果notecard是full perms，您可以使用llGetInventoryKey来检查它，在这种情况下，它将返回NULL_KEY。但是，如果notecard不是完全烫发，则无法避免错误消息。
@@ 第84行： / 第84行： @@
+     }
+}
 /////
 //  Generic Multi Notecard reader by Brangus Weir
@@ 第189行： / 第190行： @@
+     }
+}
-----
+<pre>
 /////
 //  Generic Multi Notecard reader by Randur Source

@@ 第37行： / 第37行： @@
 '''Notes'''
 记事本读卡可以是no modify，也可以是no modify/no copy。
@@ 第84行： / 第85行： @@
+}
-== Useful Snippets ==
+''' Useful Snippets '''
 /////
 //  Generic Multi Notecard reader by Brangus Weir
@@ 第282行： / 第283行： @@
 无
 }}

LlGetNotecardLine - 版本历史

2020年7月6日 (一) 08:36 Wzc

2020年7月6日 (一) 08:33 Wzc

Wzc：创建页面，内容为“{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}} {{函数详情 |函数名 =Function: key llGetNotecardLine( string name, integer line ); |参数…”