Class Cut

java.lang.Object
org.projog.core.predicate.builtin.flow.Cut
All Implemented Interfaces:
PredicateFactory
public final class Cut extends Object implements PredicateFactory
! - the "cut".

The "cut", represented as a !, is a special mechanism which affects how prolog backtracks.

  • Constructor Details

    • Cut

      public Cut()

  • Method Details

    • 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

    • isAlwaysCutOnBacktrack

      public boolean isAlwaysCutOnBacktrack()
      Description copied from interface: PredicateFactory
      Will attempting to re-evaluate this implementation always result in a cut?
      Specified by:
      isAlwaysCutOnBacktrack in interface PredicateFactory
      Returns:
      true if a cut will always be encountered when attempting to re-evaluate, false otherwise