Difference between revisions of "LlEmail"
Jump to navigation
Jump to search
Blubb Dixon (talk | contribs) m (sp) |
Void Singer (talk | contribs) m (formatted example) |
||
| Line 32: | Line 32: | ||
|caveats=* There is a limit to the number of email messages an object can send in a given amount of time. | |caveats=* There is a limit to the number of email messages an object can send in a given amount of time. | ||
|constants | |constants | ||
|examples=< | |examples= | ||
<lsl> | |||
string email = ""; | string email = ""; | ||
| Line 52: | Line 53: | ||
} | } | ||
} | } | ||
</ | </lsl> | ||
|helpers= | |helpers= | ||
<pre> | <pre> | ||
Revision as of 09:21, 11 February 2008
| 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 )
{
//Send an email to the person who touched the prim
llEmail( email, "No touching!", "I was defiled by: " + llDetectedName(0)+"\nKey: "+(string)llDetectedKey(0) );
}
}
</lsl>Useful Snippets
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);
}
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".
See Also
Deep Notes
Feature Design Document
(none)
Functional Spec
(none)
Test scripts
Discussion for future improvements
(none)
Relationship to other features
List of features that need to be tested when this feature changes, and why.
IM to email - verify IM -> email still works.
Postcards - Postcards use email out?