Difference between revisions of "Email"

From Second Life Wiki
Jump to: navigation, search
m
Line 7: Line 7:
 
|p4_type=string|p4_name=message|p4_desc
 
|p4_type=string|p4_name=message|p4_desc
 
|p5_type=integer|p5_name=num_left|p5_desc=The number of emails left in the email queue
 
|p5_type=integer|p5_name=num_left|p5_desc=The number of emails left in the email queue
|event_desc=Triggered when task receives email
+
|event_desc=Triggered as a result of calling [[llGetNextEmail]] when there is an email that matches the optional filters used during the [[llGetNextEmail]] call. The email is removed from the email queue.
 
|constants
 
|constants
 
|spec
 
|spec
 
|caveats=
 
|caveats=
 
*The email queue is limited to 100 emails, any email after that is bounced.
 
*The email queue is limited to 100 emails, any email after that is bounced.
* Due to bug {{Jira|SVC-23}} (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.  
+
* Due to bug {{Jira|SVC-23}} (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.  
* The entire incoming email is limited to 4KiB.
+
* The entire incoming email is limited to 1000 bytes.
 
|constants
 
|constants
 
|examples
 
|examples

Revision as of 19:37, 30 August 2008

Description

Event: email( string <span title="In the (string)llGetUnixTime format" style="border-bottom:1px dotted; cursor:help;">time, string address, string subject, string message, integer num_left ){ ; }</span>

Triggered as a result of calling llGetNextEmail when there is an email that matches the optional filters used during the llGetNextEmail call. The email is removed from the email queue.

• 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 (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.
  • The entire incoming email is limited to 1000 bytes.
All Issues ~ Search JIRA for related Bugs

Examples

See Also

Functions

•  llEmail
•  llGetNextEmail

Deep Notes

Signature

event void email( string time, string address, string subject, string message, integer num_left );