Difference between revisions of "State exit"

From Second Life Wiki
Jump to navigation Jump to search
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(9 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{LSL_Event
{{LSL_Event
|event_id=1|event_delay|event=state_exit
|event_id=1|event_delay|event=state_exit
|event_desc=Triggered on any state transition
|event_desc=Triggered on a qualifying [[state]] transition.
|constants
|constants
|spec
|spec
|caveats
|caveats=
|examples
* Events queued during [[state_exit]], are dumped before the next state is entered. use [[state_entry]] to avoid this, when possible. See [[state]] for further caveats.
|examples=<source lang="lsl2">default
{
    state_entry()
    {
        llOwnerSay("Entering default state");
    }
    touch_end(integer detected)
    {
        // Note: NEVER do a state change from a touch_start event -
        // - this can result in a missed touch_start on re-entering this state
        // Here we do the state change safely from within touch_end
        state other;
    }
    state_exit()
    {
        llOwnerSay("leaving default state");
    }
}
 
state other
{
    state_entry()
    {
        llOwnerSay("Entering state \"other\"");
    }
    touch_end(integer detected)
    {
        state default;
    }
    state_exit()
    {
        llOwnerSay("leaving state \"other\"");
    }
}</source>
|helpers
|helpers
|also_header
|also_header
Line 12: Line 46:
|also_articles
|also_articles
|also_footer
|also_footer
|notes
|notes=While the [[default]] [[state_entry]] is triggered on script reset, state_exit is not triggered prior to the reset.
|mode
|mode
|deprecated
|deprecated
|cat1=Script
|cat1=Script
|cat2
|cat2=State
|cat3
|cat3
|cat4
|cat4
}}
}}

Latest revision as of 00:07, 22 January 2015

Description

Event: state_exit( ){ ; }

Triggered on a qualifying state transition.


Caveats

  • Events queued during state_exit, are dumped before the next state is entered. use state_entry to avoid this, when possible. See state for further caveats.


Examples

default
{
    state_entry()
    {
        llOwnerSay("Entering default state");
    }
    touch_end(integer detected)
    {
        // Note: NEVER do a state change from a touch_start event -
        // - this can result in a missed touch_start on re-entering this state
        // Here we do the state change safely from within touch_end
        state other;
    }
    state_exit()
    {
        llOwnerSay("leaving default state");
    }
}

state other
{
    state_entry()
    {
        llOwnerSay("Entering state \"other\"");
    }
    touch_end(integer detected)
    {
        state default;
    }
    state_exit()
    {
        llOwnerSay("leaving state \"other\"");
    }
}

Notes

While the default state_entry is triggered on script reset, state_exit is not triggered prior to the reset.

Deep Notes

Signature

event void state_exit(  );