Package jason.stdlib

Class suspend

java.lang.Object
All Implemented Interfaces:
InternalAction, java.io.Serializable

@Manual(literal=".suspend[(goal)]",
        hint="suspend goals, i.e., all intentions trying to achieve given goal will stop running until a .resume",
        argsHint="the goals to be suspended [optional]",
        argsType="literal",
        examples={".suspend(go(1,3)): suspends intentions to go to the location 1,3",".suspend: suspends the current intention"},
        seeAlso={"jason.stdlib.suspended","jason.stdlib.intend","jason.stdlib.desire","jason.stdlib.drop_all_desires","jason.stdlib.drop_all_events","jason.stdlib.drop_all_intentions","jason.stdlib.drop_intention","jason.stdlib.drop_desire","jason.stdlib.succeed_goal","jason.stdlib.fail_goal","jason.stdlib.intention","jason.stdlib.resume"})
public class suspend
extends DefaultInternalAction

Internal action: .suspend(G).

Description: suspend goals G, i.e., all intentions trying to achieve G will stop running until the internal action .resume change the state of those intentions. A literal G is a goal if there is a triggering event +!G in any plan within any intention in I, E, PI, or PA.
The meta-event ^!G[state(suspended)] is produced.

Examples:

  • .suspend(go(1,3)): suspends intentions to go to the location 1,3.
  • .suspend: suspends the current intention.
See Also:
suspended, intend, desire, drop_all_desires, drop_all_events, drop_all_intentions, drop_intention, drop_desire, succeed_goal, fail_goal, intention, resume, Serialized Form