LlGetNextEmail: Difference between revisions
Jump to navigation
Jump to search
Add Specification section and move some notes to there. |
Changing the tense, passed tense is awkward. |
||
| Line 5: | Line 5: | ||
|p1_type=string|p1_name=address|p1_desc=Sender's mail address | |p1_type=string|p1_name=address|p1_desc=Sender's mail address | ||
|p2_type=string|p2_name=subject|p2_desc=Mail subject | |p2_type=string|p2_name=subject|p2_desc=Mail subject | ||
|func_footnote | |func_footnote=If '''address''' or '''subject''' an {{HoverText|empty string|{{String}}}}, then that parameter will be treated as a {{HoverText|wildcard|wildcard in this context means it will matches anything/everything}}. | ||
|func_desc=Get the next | |func_desc=Get the next queued [[email]] that comes from '''address''', with specified '''subject'''. | ||
|return_text | |return_text | ||
|spec= | |spec= | ||
* If a parameter | The [[email]] [[event]] will be triggered only if '''address''' and '''subject''' match | ||
*Neither parameter is case sensitive. | |||
* | *If a parameter is an {{HoverText|empty string|{{String}}}}, then that parameter will be treated as a wildcard, matches anything. | ||
*If both parameters are empty strings then the first email in the queue will be matched. | |||
*The email queue is {{HoverText|FIFO|First In First Out - The first item put into the queue is the first one out of the queue}}. | |||
|caveats= | |caveats= | ||
|constants | |constants | ||
| Line 18: | Line 20: | ||
default { | default { | ||
state_entry() { | state_entry() { | ||
llSetTimerEvent(1); //Don't go much lower than this... | llSetTimerEvent(1.0); //Don't go much lower than this... | ||
} | } | ||
Revision as of 06:48, 14 April 2009
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llGetNextEmail( string address, string subject );| 0.0 | Forced Delay |
| 10.0 | Energy |
Get the next queued email that comes from address, with specified subject.
| • string | address | – | Sender's mail address | |
| • string | subject | – | Mail subject |
If address or subject an empty string, then that parameter will be treated as a wildcard.
Specification
The email event will be triggered only if address and subject match
- Neither parameter is case sensitive.
- If a parameter is an empty string, then that parameter will be treated as a wildcard, matches anything.
- If both parameters are empty strings then the first email in the queue will be matched.
- The email queue is FIFO.
Examples
<lsl> default {
state_entry() {
llSetTimerEvent(1.0); //Don't go much lower than this...
}
timer() {
llGetNextEmail("", ""); //Check for emails
}
email(string time, string address, string subj, string message, integer num_left) {
llOwnerSay("I got an email: " + subj + "\n" + message);
}
}
</lsl>Deep Notes
Signature |
|---|
function void llGetNextEmail( string address, string subject ); |