rollHeld関数
リファレンスの説明と例は英語です。見出しと目次は日本語です。
Hold some dice of a roll and throw the rest again, as Yacht and Farkle do.
held[i] is whether face i stays. The dice not held are thrown in order
from the source, so from a seed the second roll replays like the first.
The roll that comes back says which faces were held. Only plain dice can be
held (canHold); anything else is a RangeError, as is a held that does
not fit the roll.
インポート
import { rollHeld } from "@johnmorrisdotca/korokoro";定義
function rollHeld(previous: Roll, held: readonly boolean[], source?: RandomSource, at?: number): Roll引数
| 名前 | 型 | 説明 |
|---|---|---|
previous | Roll | The roll whose held dice must remain unchanged. |
held | readonly boolean[] | A mask marking dice whose faces stay fixed. |
source (省略可) | RandomSource | A source of unsigned 32-bit integers; crypto by default where optional. |
at (省略可) | number | The recorded time in epoch milliseconds. |
戻り値
Roll
Hold some dice of a roll and throw the rest again, as Yacht and Farkle do. held[i] is whether face i stays. The dice not held are thrown in order from the source, so from a seed the second roll replays like the first. The roll that comes back says which faces were held. Only plain dice can be held (canHold); anything else is a RangeError, as is a held that does not fit the roll.
例
import { rollHeld } from "@johnmorrisdotca/korokoro";
import { normalizeSpec, rollFrom, seededSource } from "@johnmorrisdotca/korokoro";
const spec = normalizeSpec({ count: 2, sides: 6 });
const sample = rollFrom(spec, [2, 5], "saved", 0, null)!;
console.log(rollHeld(sample, [true, false], seededSource("next"), 1).faces);[ 2, 2 ]出力（このページを作ったときに実行した結果）
この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。