Difference between revisions of "LlDie"

From Second Life Wiki
Jump to navigation Jump to search
(link with llRemoveInventory that deletes just the script, rather than all of the object that the script contains)
m
 
(20 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|inject-1={{LSL Function/warning||This permanently deletes your whole object (root prim and all linked prims). The deleted object WILL NOT appear in your lost-and-found folder. The deleted object WILL NOT appear in your trash folder. It will be gone, lost forever. There will be NO WAY WHATSOEVER to get it back. Use with caution!}}
|inject-2={{Issues/SVC-7421}}
|func=llDie
|func=llDie
|sort=Die
|sort=Die
|func_id=41|func_sleep=0.0|func_energy=0.0
|func_id=41|func_sleep=0.0|func_energy=0.0
|func_footnote=If called in any prim in the {{LSLG|link set}} the result will be the deletion of the entire object.<br/>To remove a single prim from an object use [[llBreakLink]] first.
|func_footnote=If called in any prim in the {{LSLG|link set}} the result will be the deletion of the entire object.{{PBR}}To remove a single prim from an object use [[llBreakLink]] first.
|func_desc=Deletes the object. The object does not go to the owners Inventory:Trash.
|func_desc=Deletes the object. The object does not go to the owners Inventory:Trash.
|return_text
|return_text
|spec
|spec
|caveats=*After this function is called there is no way to undo the deletion of the object.
|caveats=
*The script may not stop executing immediately after this function is called ({{Jira|SVC-7421}}).
*After this function is called there is no way to undo the deletion of the object.
*Has no effect if called from within an {{LSLGC|Attachment|attachment}}; there is no way to delete an attachment.
*Has no effect if called from within an {{LSLGC|Attachment|attachment}}; there is no way to delete an attachment.
**To detach an object from the avatar call [[llDetachFromAvatar]]
**To detach an object from the avatar call [[llDetachFromAvatar]].
**[[llDetachFromAvatar|Detaching]] a [[llAttachToAvatarTemp|temporary attachment]] will cause the attachment to be deleted.
|constants
|constants
|examples=<pre>//Counts down from 5 to 1, then dies
|examples=
<source lang="lsl2">
default
default
{
{
     state_entry()
     state_entry()
     {
     {
         integer olf;
         // red and opaque text
         for(olf = 5; olf > 0; --olf)
        llSetText("<!-- touch to kill --!>", <1.0, 0.0, 0.0>, 1.0);
             llSay(0, (string)olf);
    }
 
    touch_start(integer num_detected)
    {
        llSay(0, "Good bye, cruel world!");
         llDie();
    }
}
</source>
<source lang="lsl2">
//Counts down from 5 to 1, then dies
default
{
    state_entry()
    {
        integer index = 5;
        while (index)
        {
            // wait a sec
            llSleep(1.0);
             llSay(0, (string)index);
            --index;
        }
         llDie();
         llDie();
     }
     }
}</pre>
}
</source>
|helpers=
|helpers=
[[llRemoveInventory]] of [[llGetScriptName]] deletes just the calling script, rather than all of the object that the calling script contains. For instance, you can write a script that chats a little when dragged on to an object from inventory and then politely disappears itself, such as:
[[llRemoveInventory]] of [[llGetScriptName]] deletes just the calling script, rather than all of the object that the calling script contains. For instance, you can write a script that chats a little when dragged on to an object from inventory and then politely disappears itself, such as:
<pre>
<source lang="lsl2">
// http://wiki.secondlife.com/wiki/llDie
default
default
{
{
Line 34: Line 64:
     }
     }
}
}
</pre>
</source>
|also_functions={{LSL DefineRow||[[llDetachFromAvatar]]|}}
|also_functions={{LSL DefineRow||[[llDetachFromAvatar]]|}}
{{LSL DefineRow||[[llBreakLink]]|}}
{{LSL DefineRow||[[llBreakLink]]|}}
Line 43: Line 73:
|permission
|permission
|negative_index
|negative_index
|haiku={{Haiku|Hey, where did it go?|Assignment. Equality.|Gee, thanks, K & R.}}
|cat1=Object
|cat1=Object
|cat2
|cat2=Stop
|cat3
|cat3=Cleanup
|cat4
|cat4
}}
}}

Latest revision as of 00:05, 22 January 2015

Emblem-important-red.png Warning!

This permanently deletes your whole object (root prim and all linked prims). The deleted object WILL NOT appear in your lost-and-found folder. The deleted object WILL NOT appear in your trash folder. It will be gone, lost forever. There will be NO WAY WHATSOEVER to get it back. Use with caution!

Summary

Function: llDie( );

Deletes the object. The object does not go to the owners Inventory:Trash.

If called in any prim in the link set the result will be the deletion of the entire object.To remove a single prim from an object use llBreakLink first.

Caveats

  • The script may not stop executing immediately after this function is called (SVC-7421).
  • After this function is called there is no way to undo the deletion of the object.
  • Has no effect if called from within an attachment; there is no way to delete an attachment.

Examples

default
{
    state_entry()
    {
        // red and opaque text
        llSetText("<!-- touch to kill --!>", <1.0, 0.0, 0.0>, 1.0);
    }

    touch_start(integer num_detected)
    {
        llSay(0, "Good bye, cruel world!");
        llDie();
    }
}

//Counts down from 5 to 1, then dies
default
{
    state_entry()
    {
        integer index = 5;
        while (index)
        {
            // wait a sec
            llSleep(1.0);
            llSay(0, (string)index);
            --index;
        }
        llDie();
    }
}

Useful Snippets

llRemoveInventory of llGetScriptName deletes just the calling script, rather than all of the object that the calling script contains. For instance, you can write a script that chats a little when dragged on to an object from inventory and then politely disappears itself, such as: 

// http://wiki.secondlife.com/wiki/llDie
default
{
    state_entry()
    {
        llOwnerSay("llGetRegionTimeDilation()");
        llOwnerSay((string) llGetRegionTimeDilation());
        llRemoveInventory(llGetScriptName());
    }
}

See Also

Functions

•  llDetachFromAvatar
•  llBreakLink

Articles

•  Attachment

Deep Notes

Signature

function void llDie();

Haiku

Hey, where did it go?
Assignment. Equality.
Gee, thanks, K & R.

Retrieved from "https://wiki.secondlife.com/w/index.php?title=LlDie&oldid=1194105"