Package jason.stdlib
Class df_search
java.lang.Object
jason.asSemantics.DefaultInternalAction
jason.stdlib.df_register
jason.stdlib.df_search
- All Implemented Interfaces:
InternalAction
,Serializable
@Manual(literal=".df_search(service[,type],result)",
hint="list of all agents providing the service and, optionally, the type",
argsHint={"the service the agents are registered","the type of the service [optional]","the resulting list of agents providing the service"},
argsType={"literal","string","list"},
examples=".df_search(\"sell(book)\",L): unifies L with [bob,alice] in case these two agents have registered as book sellers",
seeAlso={"jason.stdlib.df_register","jason.stdlib.df_deregister","jason.stdlib.df_subscribe"})
public class df_search
extends df_register
Internal action: .df_search(S [,T] , L)
.
Description: unifies in L a list of all agents providing the service S of type T (see FIPA Directory Facilitator specification). An optional second argument can be used to define the type of the service.
Parameters:
- - service (literal): the service the agents are registered.
- - type (string -- optional): the type of the service.
- - type (list): the resultant list of agents providing the service.
Examples:
-
.df_search("sell(book)",L)
: unifies L with [bob,alice] in case these two agents have registered as book sellers.
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic InternalAction
create()
execute
(TransitionSystem ts, Unifier un, Term[] args) Executes the internal action.int
int
Methods inherited from class jason.stdlib.df_register
getService, getType
Methods inherited from class jason.asSemantics.DefaultInternalAction
canBeUsedInContext, checkArguments, destroy, prepareArguments, suspendIntention
-
Constructor Details
-
df_search
public df_search()
-
-
Method Details
-
create
-
getMinArgs
public int getMinArgs()- Overrides:
getMinArgs
in classdf_register
-
getMaxArgs
public int getMaxArgs()- Overrides:
getMaxArgs
in classdf_register
-
execute
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 interfaceInternalAction
- Overrides:
execute
in classdf_register
- Throws:
Exception
-