llEmail
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llEmail( string address, string subject, string message );| 20.0 | Forced Delay |
| 10.0 | Energy |
Sends an email to address with subject and message.
| • string | address | |||
| • string | subject | |||
| • string | message |
Specification
The message is prefixed with information about the prim sending the email.
| Template | Example |
|---|---|
Object-Name: *prim* Region: *simname* (*simpos.x*, *simpos.y*) Local-Position: (*primpos.x*, *primpos.y*, *primpos.z*) *message* |
Object-Name: Object Region: Gibson (254976, 256000) Local-Position: (117, 129, 50) The real message starts here. |
Caveats
- This function causes the script to sleep for 20.0 seconds.
- There is a limit to the number of email messages an object can send in a given amount of time.
Examples
<lsl> string email = "";
default {
state_entry()
{
if(email == "")
email = (string)llGetKey()+"@lsl.secondlife.com";
//Send an email to a normal email account
llEmail( email, "Look it's an email subject line!", "Testing 1 2 3" );
}
touch_start( integer num_detected )
{
integer i = 0;
//Send an email to the person who touched the prim
do
llEmail( email, "No touching!", "I was defiled by: " + llDetectedName(i) + "\nKey: " + (string) llDetectedKey(i) );
while(++i < num_detected);
}
}
</lsl>Useful Snippets
<lsl> email( string time, string address, string subj, string message, integer num_left ) {
if(llGetSubString(address, -19, -1) == "@lsl.secondlife.com")//trim the header
message = llDeleteSubString(message, 0, llSubStringIndex(message, "\n\n") + 1);
} </lsl>
Notes
- Because of the long delay on this function, it is often called from a second script triggered by link message.
- If you are sending email within Second Life, remember that the address is [key]@lsl.secondlife.com
- Which means if the key returned by llGetKey is "a2e76fcd-9360-4f6d-a924-000000000003", then its email address is "a2e76fcd-9360-4f6d-a924-000000000003@lsl.secondlife.com".