Package jason.stdlib

Class drop_desire

java.lang.Object
All Implemented Interfaces:
InternalAction, java.io.Serializable
Direct Known Subclasses:
drop_event, drop_future_intention

@Manual(literal=".drop_desire(desire)",
        hint="removes referred desire from the agent circumstance",
        argsHint="the desire to be dropped",
        argsType="literal",
        examples=".drop_desire(go(X,3)): remove desires such as <+!go(1,3),_> from the set of events and intentions having plans with triggering events such as +!go(1,3)",
        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_event","jason.stdlib.drop_intention","jason.stdlib.drop_desire","jason.stdlib.succeed_goal","jason.stdlib.fail_goal","jason.stdlib.intention","jason.stdlib.resume","jason.stdlib.suspend","jason.stdlib.suspended"})
public class drop_desire
extends drop_intention

Internal action: .drop_desire(D).

Description: removes desire D from the agent circumstance. This internal action simply removes all +!D entries (those for which .desire(D) would succeed) from both the set of events and the set of intentions. No event is produced as a consequence of dropping desires.

Parameters:

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

Example:

  • .drop_desire(go(X,3)): remove desires such as <+!go(1,3),_> from the set of events and intentions having plans with triggering events such as +!go(1,3).
See Also:
intention, desire, drop_all_desires, drop_all_events, drop_all_intentions, drop_event, drop_intention, succeed_goal, fail_goal, intend, suspend, suspended, Serialized Form
  • Constructor Details

    • drop_desire

      public drop_desire()
  • 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_intention
      Throws:
      java.lang.Exception
    • dropEvt

      public void dropEvt​(Circumstance C, Literal l, Unifier un)