`CardGameRules`型

リファレンスの説明と例は英語です。見出しと目次は日本語です。

WHAT EVERY CARD GAME'S RULES ANSWER, whatever the game. S is a game in progress and M one move in it; both are plain data, so a game can be kept, sent or compared as it is.

Every function is pure: it returns a new game and leaves the one it was given alone.

computer sees what the player in that seat could see and nothing more: their own hand, the cards on the table and everything said aloud (the moves so far). Each game's computer reads a view built for it (<game>View), so a player cannot be beaten by a program that looked at their hand; the tests beside each computer hold that.

インポート

import type { CardGameRules } from "@johnmorrisdotca/toranpu";

定義

type CardGameRules<S, M> = {
    start: (size: number, players: readonly string[], _reserved?: unknown, seed?: number, computers?: readonly boolean[]) => S | null;
    moves: (game: S) => readonly M[];
    play: (game: S, move: M) => S | null;
    over: (game: S) => boolean;
    winners: (game: S) => readonly number[];
    encode: (game: S) => string;
    decode: (text: string | null) => S | null;
    toPlay: (game: S) => number | null;
    computer: (game: S) => M;
    seats: (game: S) => CardSeats;
    sensible?: (game: S, random: () => number) => M;
};

メンバー

名前	型	説明
`start`	`(size: number, players: readonly string[], _reserved?: unknown, seed?: number, computers?: readonly boolean[]) => S \| null`	A new game for these players (one name a seat) at this size, or null for a table the game is not offered for. `size` is how long the game lasts in its own terms (`CARD_GAME_TABLES`). The deal is shuffled from `seed`, so a seed and the moves make the same game again anywhere; `computers` says, one a seat, which seats a computer plays. The third argument is unused and reserved: it keeps the signature of a table of games that are played in a language (a word game), so these rules sit in such a table unchanged.
`moves`	`(game: S) => readonly M[]`	Every move the player to move may make now; none once the game is over.
`play`	`(game: S, move: M) => S \| null`	The game after that move, or null for a move that may not be made.
`over`	`(game: S) => boolean`
`winners`	`(game: S) => readonly number[]`	On a game that is over, every seat that won: more than one for a partnership or a tie.
`encode`	`(game: S) => string`	The game as text: its table, seed and moves, never a hand (`cardGameCodec`).
`decode`	`(text: string \| null) => S \| null`	Text read back into the game it records, or null for anything these rules cannot play out again.
`toPlay`	`(game: S) => number \| null`	The seat to move, or null once the game is over.
`computer`	`(game: S) => M`	The move a computer in the seat to move makes: always one of `moves(game)`.
`seats`	`(game: S) => CardSeats`	Who sits where, and which seats a computer plays.
`sensible` (省略可)	`((game: S, random: () => number) => M) \| undefined`	For a game a player choosing uniformly at random would almost never finish (Gin Rummy, where random play rarely knocks), a random move a sensible player might make, for tests and simulations. Always one of `moves(game)`. Absent where random play ends by itself.

例

import type { CardGameRules, GameOf, MoveOf } from "@johnmorrisdotca/toranpu";
import { rulesFor } from "@johnmorrisdotca/toranpu";

const value: CardGameRules<GameOf<"hearts">, MoveOf<"hearts">> = rulesFor("hearts");
console.log(typeof value.play);

function

出力（このページを作ったときに実行した結果）

ソースを見る GitHub で編集@johnmorrisdotca/toranpu 2.15.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。

CardGameRules型

定義

メンバー

例

`CardGameRules`型