Package jason.stdlib

Class fail_goal

All Implemented Interfaces:
InternalAction, java.io.Serializable

@Manual(literal=".fail_goal(goal)",
        hint="aborts referred goals in the agent circumstance as if a plan for such goal had failed",
        argsHint="the goals which the achieving attempts will be aborted",
        argsType="literal",
        examples=".fail_goal(go(1,3)): aborts an attempt to achieve goals such as !go(1,3) as if a plan for it had failed, generating event -!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_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 fail_goal
extends succeed_goal

Internal action: .fail_goal(G).

Description: aborts goals G in the agent circumstance as if a plan for such goal had failed. An event -!G is generated. A literal G is a goal if there is a triggering event +!G in any plan within any intention; also note that intentions can be suspended hence appearing in sets E, PA, or PI of the agent's circumstance as well.
The meta-event ^!G[state(failed)] is produced.

Parameters:

  • - goal (literal): the goals to be aborted.

Example:

  • .fail_goal(go(1,3)): aborts an attempt to achieve goals such as !go(1,3) as if a plan for it had failed, the generated event is -!go(1,3).
(Note: this internal action was introduced in a DALT 2006 paper, where it was called .dropGoal(G,false).)
See Also:
intend, desire, drop_all_desires, drop_all_events, drop_all_intentions, drop_intention, drop_desire, succeed_goal, intention, suspend, suspended, resume, Serialized Form