Package jason.stdlib
Class concat
java.lang.Object
jason.asSemantics.DefaultInternalAction
jason.stdlib.concat
- All Implemented Interfaces:
InternalAction
,Serializable
@Manual(literal=".concat(arg0,arg1[,...],result)",
hint="concatenates strings or lists",
argsHint={"the first term","the term to be concatenated with prior","the term to be concatenated with prior ones [optional]","the result of the concatenation"},
argsType={"term or list","term or list","term or list","string"},
examples={".concat(\"a\",\"b\",X): X unifies with \"ab\"",".concat(\"a\",\"b\",\"a\"): false",".concat(\"a b\",1,a,X): X unifies with \"a b1a\"",".concat(\"a\", \"b\", \"c\", \"d\", X): X unifies with \"abcd\"",".concat([a,b,c],[d,e],[f,g],X): X unifies with [a,b,c,d,e,f,g]"},
seeAlso={"jason.stdlib.delete","jason.stdlib.length","jason.stdlib.member","jason.stdlib.sort","jason.stdlib.shuffle","jason.stdlib.substring","jason.stdlib.prefix","jason.stdlib.suffix","jason.stdlib.nth","jason.stdlib.max","jason.stdlib.min","jason.stdlib.reverse","jason.stdlib.difference","jason.stdlib.intersection","jason.stdlib.union"})
public class concat
extends DefaultInternalAction
Internal action: .concat
.
Description: concatenates strings or lists.
Parameters:
- + arg[0] ... + arg[n-1] (any term or list): the terms to be concatenated.
- +/- arg[n]: the result of the concatenation.
Examples:
-
.concat("a","b",X)
:X
unifies with "ab". -
.concat("a","b","a")
: false. -
.concat("a b",1,a,X)
:X
unifies with "a b1a". -
.concat("a", "b", "c", "d", X)
:X
unifies with "abcd". -
.concat([a,b,c],[d,e],[f,g],X)
:X
unifies with[a,b,c,d,e,f,g]
.
Note: this internal action does not implement backtrack. You if need backtrack, you can add and use the following rules in your code:
concat([ ], L, L). concat([H|T], L, [H|M]) :- concat(T, L, M).
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic InternalAction
create()
execute
(TransitionSystem ts, Unifier un, Term[] args) Executes the internal action.Methods inherited from class jason.asSemantics.DefaultInternalAction
canBeUsedInContext, checkArguments, destroy, getMaxArgs, getMinArgs, prepareArguments, suspendIntention
-
Constructor Details
-
concat
public concat()
-
-
Method Details
-
create
-
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 classDefaultInternalAction
- Throws:
Exception
-