Reference · Number-puzzle engines
enterNumberfunction
Write a number into a cell (0 empties it). Its own pencil marks go, and with tidy (the default)
the number comes out of the pencil marks of every cell that shares a group with it, as a person
with a pencil would rub it out. Nothing happens to a printed cell, or when the cell already holds
that number.
Import it
import { enterNumber } from "@johnmorrisdotca/kazu";
Definition
function enterNumber(game: KazuGame, cell: number, value: number, tidy?: boolean): KazuGame
Parameters
| Name | Type | Description |
|---|---|---|
game | KazuGame | The current immutable number-grid game. |
cell | number | A zero-based row-major cell index. |
value | number | The value to validate, encode or enter specified by this signature. |
tidy (optional) | boolean | Whether to clear notes affected by the entered number. |
Returns
KazuGame
Write a number into a cell (0 empties it). Its own pencil marks go, and with tidy (the default) the number comes out of the pencil marks of every cell that shares a group with it, as a person with a pencil would rub it out. Nothing happens to a printed cell, or when the cell already holds that number.
Examples
import type { KazuPuzzle } from "@johnmorrisdotca/kazu";
import { decodeCells, enterNumber, newKazuGame, readGivens } from "@johnmorrisdotca/kazu";
const puzzle: KazuPuzzle = {"kind":"number-place","size":4,"level":"easy","seed":42,"givens":"14..2..1412.3..4","solution":"1432234141233214"};
const kind = puzzle.kind;
const size = puzzle.size;
const givens = puzzle.givens;
const answer = puzzle.solution;
const printed = readGivens(kind,size,givens)!;
const cells = printed.cells;
const solution = decodeCells(answer,size)!;
const game = newKazuGame(kind,size,givens)!;
const blank = cells.findIndex(value=>value===0);
console.log(enterNumber(game,blank,solution[blank]).entries[blank]);3What it prints (run when this page was built)