Package net.hydromatic.morel.util

Class Unifier

java.lang.Object

net.hydromatic.morel.util.Unifier

Direct Known Subclasses:

MartelliUnifier, RobinsonUnifier

public abstract class Unifier
extends java.lang.Object

Given pairs of terms, finds a substitution to minimize those pairs of terms.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Unifier.Action	Called by the unifier when a Term's type becomes known.
private static class	Unifier.CycleException	Control flow exception, thrown by Unifier.Term.checkCycle(Map, Map) if it finds a cycle in a substitution map.
static class	Unifier.Failure	Result indicating that unification was not possible.
static interface	Unifier.Result	Result of attempting unification.
static class	Unifier.Sequence	A sequence of terms.
static class	Unifier.Substitution	The results of a successful unification.
static interface	Unifier.Term	Term (variable, symbol or node).
static class	Unifier.TermTerm	A pair of terms.
static interface	Unifier.TermVisitor<R>	Visitor for terms.
static class	Unifier.Variable	A variable that represents a symbol or a sequence; unification's task is to find the substitutions for such variables.

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.Map<java.lang.String,Unifier.Sequence>	atomMap
(package private) static Unifier.Substitution	EMPTY
private java.util.Map<java.lang.String,Unifier.Sequence>	sequenceMap
private java.util.Map<java.lang.String,Unifier.Variable>	variableMap
private int	varId

Constructor Summary

Constructors

Constructor	Description
Unifier()

Method Summary

Modifier and Type	Method	Description
Unifier.Sequence	apply(java.lang.String operator, java.lang.Iterable<Unifier.Term> args)	Creates a sequence, or returns an existing one with the same terms.
Unifier.Sequence	apply(java.lang.String operator, Unifier.Term... args)	Creates a sequence, or returns an existing one with the same terms.
Unifier.Term	atom(java.lang.String name)	Creates an atom, or returns an existing one with the same name.
private static void	checkCycles(java.util.Map<Unifier.Variable,Unifier.Term> map, java.util.Map<Unifier.Variable,Unifier.Variable> active)
protected Unifier.Failure	failure(java.lang.String reason)
boolean	occurs()	Whether this unifier checks for cycles in substitutions.
(package private) static Unifier.Sequence	sequenceApply(java.lang.String operator, java.util.Map<Unifier.Variable,Unifier.Term> substitutions, java.lang.Iterable<Unifier.Term> terms)
Unifier.Substitution	substitution(Unifier.Term... varTerms)	Creates a substitution.
abstract Unifier.Result	unify(java.util.List<Unifier.TermTerm> termPairs, java.util.Map<Unifier.Variable,Unifier.Action> termActions)
Unifier.Variable	variable()	Creates a new variable, with a new name.
Unifier.Variable	variable(java.lang.String name)	Creates a variable, or returns an existing one with the same name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EMPTY

static final Unifier.Substitution EMPTY

varId

private int varId

variableMap

private final java.util.Map<java.lang.String,Unifier.Variable> variableMap

atomMap

private final java.util.Map<java.lang.String,Unifier.Sequence> atomMap

sequenceMap

private final java.util.Map<java.lang.String,Unifier.Sequence> sequenceMap

Constructor Detail

Unifier

public Unifier()

Method Detail

occurs

public boolean occurs()

Whether this unifier checks for cycles in substitutions.

apply

public Unifier.Sequence apply(java.lang.String operator,
                              Unifier.Term... args)

Creates a sequence, or returns an existing one with the same terms.

apply

public Unifier.Sequence apply(java.lang.String operator,
                              java.lang.Iterable<Unifier.Term> args)

Creates a sequence, or returns an existing one with the same terms.

variable

public Unifier.Variable variable(java.lang.String name)

Creates a variable, or returns an existing one with the same name.

variable

public Unifier.Variable variable()

Creates a new variable, with a new name.

atom

public Unifier.Term atom(java.lang.String name)

Creates an atom, or returns an existing one with the same name.

substitution

public Unifier.Substitution substitution(Unifier.Term... varTerms)

Creates a substitution.

The arguments are alternating variable / term pairs. For example, substitution(a, x, b, y) becomes [a/X, b/Y].

sequenceApply

static Unifier.Sequence sequenceApply(java.lang.String operator,
                                      java.util.Map<Unifier.Variable,Unifier.Term> substitutions,
                                      java.lang.Iterable<Unifier.Term> terms)

unify

@Nonnull
public abstract Unifier.Result unify(java.util.List<Unifier.TermTerm> termPairs,
                                     java.util.Map<Unifier.Variable,Unifier.Action> termActions)

checkCycles

private static void checkCycles(java.util.Map<Unifier.Variable,Unifier.Term> map,
                                java.util.Map<Unifier.Variable,Unifier.Variable> active)
                         throws Unifier.CycleException

Throws:

Unifier.CycleException

failure

protected Unifier.Failure failure(java.lang.String reason)