Package jason.stdlib

Class drop_event

All Implemented Interfaces:
InternalAction, java.io.Serializable

@Manual(literal=".drop_event(event)",
        hint="removes referred event from the agent circumstance",
        argsHint="the event to be dropped",
        argsType="literal",
        examples=".drop_event(go(X,Y)): removes events such as <+!go(1,3),_> from the set of events",
        seeAlso={"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.current_intention","jason.stdlib.resume","jason.stdlib.suspend","jason.stdlib.suspended"})
public class drop_event
extends drop_desire

Internal action: .drop_event(D).

Description: removes events D from the agent circumstance. This internal action simply removes all +!D entries (those for which .desire(D) would succeed) from the set of events only; this action is complementary to .drop_desire and .drop_intention, in case a goal is to be removed only from the set of events and not from the set of intentions. No event is produced as a consequence of dropping desires from the set of events.

Parameters:

  • - event (literal): the event to be dropped.

Example:

  • .drop_event(go(X,Y)): removes events such as <+!go(1,3),_> from the set of events.
See Also:
current_intention, desire, drop_all_desires, drop_all_events, drop_all_intentions, drop_intention, drop_desire, succeed_goal, fail_goal, intend, Serialized Form
  • Constructor Details

    • drop_event

      public drop_event()
  • Method Details

    • execute

      public java.lang.Object execute​(TransitionSystem ts, Unifier un, Term[] args) throws java.lang.Exception
      Description copied from interface: InternalAction
      Executes the internal action. It should return a Boolean or an Iterator. A true boolean return means that the IA was successfully executed. An Iterator result means that there is more than one answer for this IA (e.g. see member internal action).
      Specified by:
      execute in interface InternalAction
      Overrides:
      execute in class drop_desire
      Throws:
      java.lang.Exception