Email - Second Life Wiki

Email

From Second Life Wiki

Jump to: navigation, search

Event: email( string time, string address, string subject, string message, integer num_left ){ ; }

Triggered when task receives email

• string time In the (string)llGetUnixTime format
• string address
• string subject
• string message
• integer num_left The number of emails left in the email queue

Caveats

  • The email queue is limited to 100 emails, any email after that is bounced.
  • Due to bug SVC-23[c] (present since 2005), objects may stop receiving emails completely until either the region is restarted or the object crosses a region boundary (resetting the script doesn't help). Emails sent may eventually be received after a restart/region-cross. Hence, don't rely on this event for reliable inter-region messaging.

Examples

This application uses email to have objects check with a central server to see if the owner has the latest version. In the objects:

 
string version = "1"; //
string type = "lolcube";
default
{
    on_rez(integer start_param)
    {
        llEmail("5a634b27-f032-283f-2df2-55ead7724b23@lsl.secondlife.com",
            version,
            (string)llGetOwner()+","+type);
    }
}

The server:

 
default
{
    state_entry()
    {
        llSetTimerEvent(15);
    }
 
    timer()
    {
        llGetNextEmail("","");
    }
 
    email( string time, string address, string version, string message, integer num_left )
    {    
        if ((integer)version < 2)
        {
            list info = llCSV2List(llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1));
            llGiveInventory(llList2Key(info,0),llList2String(info,1));
        }
 
        integer i;
        for (i = 0; i < num_left; i++)
        {
            llGetNextEmail("","");
        }
    }
}
 

See Also

Functions

•  llEmail
•  llGetNextEmail