Class UniqueInBoxHeuristic

Checks for any squares that are the unique provider of a given possible value within a box. Sets the possible values for those squares to just their unique value.

For example, if a box had three unset squares with possible values: A: [1, 2], B: [1, 2], and C: [1, 2, 3], then this would set C's possible values to [3].

Inheritance

System.Object

UniqueInBoxHeuristic

Implements

IHeuristic

Inherited Members

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: SudokuSpice.RuleBased.Heuristics

Assembly: SudokuSpice.dll

Syntax

public class UniqueInBoxHeuristic : IHeuristic

Constructors

| Improve this Doc View Source

UniqueInBoxHeuristic(IMissingBoxValuesTracker)

Creates the heuristic.

Declaration

public UniqueInBoxHeuristic(IMissingBoxValuesTracker boxValuesTracker)

Parameters

Type	Name	Description
IMissingBoxValuesTracker	boxValuesTracker	Something that tracks the possible values for each box. Rules often do this already, for example.

Methods

| Improve this Doc View Source

CopyWithNewReferences(IReadOnlyPuzzleWithMutablePossibleValues, ReadOnlySpan<IRule>)

Creates a deep copy of this heuristic. Requires rules to contain an IMissingBoxValuesTracker.

Declaration

public IHeuristic CopyWithNewReferences(IReadOnlyPuzzleWithMutablePossibleValues puzzle, ReadOnlySpan<IRule> rules)

Parameters

Type	Name	Description
IReadOnlyPuzzleWithMutablePossibleValues	puzzle
System.ReadOnlySpan<IRule>	rules

Returns

Type	Description
IHeuristic

| Improve this Doc View Source

TryInitFor(IReadOnlyPuzzleWithMutablePossibleValues)

Tries to initialize this heuristic for solving the given puzzle.

Declaration

public bool TryInitFor(IReadOnlyPuzzleWithMutablePossibleValues puzzle)

Parameters

Type	Name	Description
IReadOnlyPuzzleWithMutablePossibleValues	puzzle	The puzzle to solve.

Returns

Type	Description
System.Boolean	False if this heuristic cannot be initialized for the given puzzle, else true.

Remarks

In general, it doesn't make sense to want to maintain the previous state if this method fails. Therefore, it is not guaranteed that the heuristic's state is unchanged on failure.

| Improve this Doc View Source

UndoLastUpdate()

Undoes the last modifications made by this heuristic.

Declaration

public void UndoLastUpdate()

| Improve this Doc View Source

UpdateAll()

Updates all the current possible values.

Declaration

public bool UpdateAll()

Returns

Type	Description
System.Boolean	Returns true if any modifications were made.

Implements

IHeuristic