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 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 final class	Unifier.Sequence	A sequence of terms.
static class	Unifier.Substitution	Map from variables to terms.
static final class	Unifier.SubstitutionResult	The results of a successful unification.
static interface	Unifier.Term	Term (variable, symbol or node).
static final class	Unifier.TermTerm	A pair of terms.
static interface	Unifier.TermVisitor<R>	Visitor for terms.
static interface	Unifier.Tracer	Called on various events during unification.
static final 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 final Map<String,Unifier.Sequence>	atomMap
private final Map<String,Unifier.Sequence>	sequenceMap
private final Map<String,Unifier.Variable>	variableMap
private int	varId

Constructor Summary

Constructors

Constructor	Description
Unifier()

Method Summary

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

varId

private int varId

variableMap

private final Map<String,Unifier.Variable> variableMap

atomMap

private final Map<String,Unifier.Sequence> atomMap

sequenceMap

private final Map<String,Unifier.Sequence> sequenceMap

Constructor Details

Unifier

public Unifier()

Method Details

occurs

public boolean occurs()

Whether this unifier checks for cycles in substitutions.

apply

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

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

apply

public Unifier.Sequence apply(String operator,
 Iterable<? extends Unifier.Term> args)

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

variable

public Unifier.Variable variable(String name)

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

variable

public Unifier.Variable variable(int ordinal)

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

variable

public Unifier.Variable variable()

Creates a new variable, with a new name.

atom

public Unifier.Term atom(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(String operator,
 Map<Unifier.Variable,Unifier.Term> substitutions,
 Iterable<Unifier.Term> terms)

unify

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

checkCycles

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

Throws:

Unifier.CycleException

failure

protected Unifier.Failure failure(String reason)