Difference between revisions of "LlGetNextEmail"

From Second Life Wiki
Jump to navigation Jump to search
(Add Specification section and move some notes to there.)
m
 
(2 intermediate revisions by 2 users not shown)
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 waiting email with appropriate sender address and subject.
|func_desc=Get the next queued [[email]] that comes from '''address''', with specified '''subject'''.
|return_text
|return_text
|spec=
|spec=
* If a parameter was left {{HoverText|blank|an empty string: {{String}}}}, it will be treated as a wildcard. If both parameters were not blank, both matching must be successful.
The [[email]] [[event]] will be triggered only if '''address''' and '''subject''' match
* Parameters are not case sensitive.
*Neither parameter is case sensitive.
* [[email]] [[event]] will be triggered only when the matching was successful.
*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
|examples=
|examples=
<lsl>
<source lang="lsl2">
default {
default
     state_entry() {
{
         llSetTimerEvent(1); //Don't go much lower than this...
     state_entry()
    {
         llOwnerSay("My email address is: " + (string)llGetKey() + "@lsl.secondlife.com");
 
        // check every half minute
        llSetTimerEvent(30.0);
     }
     }
   
     timer() {
     timer()
         llGetNextEmail("", ""); //Check for emails
    {
    }
         //Check for emails
   
        llGetNextEmail("", "");
    email(string time, string address, string subj, string message, integer num_left) {
   
        llOwnerSay("I got an email: " + subj + "\n" + message);
     
     }
     }
    email(string time, string address, string subj, string message, integer num_left)
    {
          llOwnerSay("I got an email: " + subj + "\n" + message);
    }
}
}
</lsl>
</source>
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llEmail]]}}
|also_functions={{LSL DefineRow||[[llEmail]]}}

Latest revision as of 02:15, 22 January 2015

Summary

Function: llGetNextEmail( string address, string subject );

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

default
{
    state_entry()
    {
        llOwnerSay("My email address is: " + (string)llGetKey() + "@lsl.secondlife.com");

        // check every half minute
        llSetTimerEvent(30.0);
    }
 
    timer()
    {
        //Check for emails
        llGetNextEmail("", "");
    }
 
    email(string time, string address, string subj, string message, integer num_left)
    {
          llOwnerSay("I got an email: " + subj + "\n" + message);
     }
}

See Also

Events

•  email

Functions

•  llEmail

Deep Notes

Search JIRA for related Issues

Signature

function void llGetNextEmail( string address, string subject );
Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlGetNextEmail&oldid=1194208"