Class Disjunction

java.lang.Object
org.projog.core.predicate.builtin.compound.Disjunction
All Implemented Interfaces:
PredicateFactory
public final class Disjunction extends Object implements PredicateFactory
X;Y - disjunction.

X;Y specifies a disjunction of goals. X;Y succeeds if either X succeeds or Y succeeds. If X fails then an attempt is made to satisfy Y. If Y fails the entire disjunction fails.

Note: The behaviour of this predicate changes when its first argument is of the form ->/2, i.e. the "if/then" predicate. When a ->/2 predicate is the first argument of a ;/2 predicate then the resulting behaviour is a "if/then/else" statement of the form ((if->then);else).

See Also:

  • Constructor Details

  • Method Details

    • preprocess

      public PredicateFactory preprocess(Term term)
      Specified by:
      preprocess in interface PredicateFactory

    • getPredicate

      public Predicate getPredicate(Term term)
      Description copied from interface: PredicateFactory
      Returns a Predicate to be used in the evaluation of a goal.
      Specified by:
      getPredicate in interface PredicateFactory
      Parameters:
      term - the term containing the arguments to use in the evaluation of the goal
      Returns:
      Predicate to be used in the evaluation of the goal
      See Also:

    • isRetryable

      public boolean isRetryable()
      Description copied from interface: PredicateFactory
      Should instances of this implementation be re-evaluated when backtracking?

      Some goals (e.g. X is 1) are only meant to be evaluated once (the statement is either true or false) while others (e.g. repeat(3)) are meant to be evaluated multiple times. For instances of Predicate that are designed to possibly have Predicate.evaluate() called on them multiple times for the same individual query this method should return true. For instances of Predicate that are designed to only be evaluated once per individual query this method should return false.

      Specified by:
      isRetryable in interface PredicateFactory
      Returns:
      true if an attempt should be made to re-evaluate instances of implementing classes when backtracking, false otherwise