Class SymbolMatcher

java.lang.Object

org.ek9lang.compiler.support.SymbolMatcher

All Implemented Interfaces:

Serializable

public class SymbolMatcher
extends Object
implements Serializable

Given some search criteria and a List of Symbols, this class will find the best match. The main reason for this is to avoid method name mangling and incorporate coercion, and interface/super type matches.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final double	COERCION_COST
static final double	HIGH_COST
static final double	INVALID_COST
static final double	PERCENT_100
static final double	PERCENT_INVALID
static final double	PERCENT_ZERO
static final double	SUPER_COST
static final double	TRAIT_COST
static final double	ZERO_COST

Constructor Summary

Constructors

Constructor	Description
SymbolMatcher()

Method Summary

Modifier and Type	Method	Description
void	addMatchesToResult(MethodSymbolSearchResult result, SymbolSearch criteria, List<MethodSymbol> methodSymbols)	Match the search criteria against one or more symbol methods.
double	getCostOfMatch(Optional<ISymbol> fromSymbol, Optional<ISymbol> toSymbol)	Calculates the cost of matching two symbols, which may or may not be present.
double	getCostOfParameterMatch(List<ISymbol> fromSymbols, List<ISymbol> toSymbols)	Calculates the percentage of matching these two lists of parameters.

Methods inherited from class java.lang.Object

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

Field Details

ZERO_COST

public static final double ZERO_COST

See Also:

• Constant Field Values

SUPER_COST

public static final double SUPER_COST

See Also:

• Constant Field Values

TRAIT_COST

public static final double TRAIT_COST

See Also:

• Constant Field Values

COERCION_COST

public static final double COERCION_COST

See Also:

• Constant Field Values

HIGH_COST

public static final double HIGH_COST

See Also:

• Constant Field Values

INVALID_COST

public static final double INVALID_COST

See Also:

• Constant Field Values

PERCENT_100

public static final double PERCENT_100

See Also:

• Constant Field Values

PERCENT_ZERO

public static final double PERCENT_ZERO

See Also:

• Constant Field Values

PERCENT_INVALID

public static final double PERCENT_INVALID

See Also:

• Constant Field Values

Constructor Details

SymbolMatcher

public SymbolMatcher()

Method Details

addMatchesToResult

public void addMatchesToResult(MethodSymbolSearchResult result,
 SymbolSearch criteria,
 List<MethodSymbol> methodSymbols)

Match the search criteria against one or more symbol methods. We use a percentage match algorithm to try and find the best match where there are methods of the same name.

getCostOfParameterMatch

public double getCostOfParameterMatch(List<ISymbol> fromSymbols,
 List<ISymbol> toSymbols)

Calculates the percentage of matching these two lists of parameters. This is useful for calculating matches to overloaded methods and coercions. But if the symbols do not have types then it's an immediate failure to match.

getCostOfMatch

public double getCostOfMatch(Optional<ISymbol> fromSymbol,
 Optional<ISymbol> toSymbol)

Calculates the cost of matching two symbols, which may or may not be present.