jason.stdlib.difference Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jason Show documentation

Jason is a fully-fledged interpreter for an extended version of AgentSpeak, a BDI agent-oriented logic programming language.

The newest version!

package jason.stdlib;

import jason.JasonException;
import jason.asSemantics.DefaultInternalAction;
import jason.asSemantics.InternalAction;
import jason.asSemantics.TransitionSystem;
import jason.asSemantics.Unifier;
import jason.asSyntax.ListTerm;
import jason.asSyntax.Term;

/**
  Internal action: .difference(S1,S2,S3).

  
Description: S3 is the difference between the sets S1 and S2 (represented by lists).
  The result set is sorted.

  
Parameters:

  + arg[0] (a list).

  
+ arg[1] (a list).

  
+/- arg[2]: the difference.
  

  Examples:

   .difference("[a,b,c]","[b,e]",X): X unifies with "[a,c]".
  
 .difference("[a,b,a,c]","[f,e,a,c]",X): X unifies with "[b]".
  

  @see jason.stdlib.concat
  @see jason.stdlib.delete
  @see jason.stdlib.length
  @see jason.stdlib.member
  @see jason.stdlib.sort
  @see jason.stdlib.substring
  @see jason.stdlib.nth
  @see jason.stdlib.max
  @see jason.stdlib.min
  @see jason.stdlib.reverse

  @see jason.stdlib.intersection
  @see jason.stdlib.union
*/
public class difference extends DefaultInternalAction {

    private static InternalAction singleton = null;
    public static InternalAction create() {
        if (singleton == null)
            singleton = new difference();
        return singleton;
    }

    @Override public int getMinArgs() {
        return 3;
    }
    @Override public int getMaxArgs() {
        return 3;
    }

    @Override protected void checkArguments(Term[] args) throws JasonException {
        super.checkArguments(args); // check number of arguments
        if (!args[0].isList())
            throw JasonException.createWrongArgument(this,"first argument '"+args[0]+"'is not a list.");
        if (!args[1].isList())
            throw JasonException.createWrongArgument(this,"second argument '"+args[1]+"'is not a list.");
        if (!args[2].isVar() && !args[2].isList())
            throw JasonException.createWrongArgument(this,"last argument '"+args[2]+"'is not a list nor a variable.");
    }

    @Override
    public Object execute(TransitionSystem ts, Unifier un, Term[] args) throws Exception {
        checkArguments(args);
        return un.unifies(args[2], ((ListTerm)args[0]).difference( (ListTerm)args[1]) );
    }
}