Package jason.stdlib

Class drop_all_events

java.lang.Object

jason.asSemantics.DefaultInternalAction

jason.stdlib.drop_all_events

All Implemented Interfaces:

InternalAction, Serializable

@Manual(literal=".drop_all_events",
        hint="removes all desires that the agent has not yet committed to",
        argsHint="",
        argsType="",
        examples=".drop_all_events: remove all not commited desires",
        seeAlso={"jason.stdlib.intend","jason.stdlib.desire","jason.stdlib.drop_all_desires","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_all_events
extends DefaultInternalAction

Internal action: .drop_all_events.

Description: removes all desires that the agent has not yet committed to. No event is produced.

This action changes the agent's circumstance structure by simply emptying the whole set of events (E). This action is complementary to .drop_all_desires and .drop_all_intentions, in case all entries are to be removed from the set of events but not from the set of intentions.

Example:

• .drop_all_events: remove all not commited desires.

See Also:

• intend
• desire
• drop_all_desires
• drop_all_intentions
• drop_intention
• drop_desire
• succeed_goal
• fail_goal
• intention
• suspend
• suspended
• resume
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
drop_all_events()

Method Summary

Modifier and Type	Method	Description
Object	execute(TransitionSystem ts, Unifier un, Term[] args)	Executes the internal action.
int	getMaxArgs()
int	getMinArgs()

Methods inherited from class jason.asSemantics.DefaultInternalAction

canBeUsedInContext, checkArguments, destroy, prepareArguments, suspendIntention

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

drop_all_events

public drop_all_events()

Method Details

getMinArgs

public int getMinArgs()

Overrides:

getMinArgs in class DefaultInternalAction

getMaxArgs

public int getMaxArgs()

Overrides:

getMaxArgs in class DefaultInternalAction

execute

public Object execute(TransitionSystem ts,
 Unifier un,
 Term[] args)
               throws 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 DefaultInternalAction

Throws:

Exception