GameResult クラス

rsshogi.record.GameResult

終局結果を表す列挙型です。18 種類の終局結果が定義されており、 勝敗判定のためのメソッドも提供しています。

from rsshogi.record import GameResult

# 定数として使用
if result == GameResult.BLACK_WIN:
    print("先手の勝ち")

クラス定数

18種類の終局結果が定義されています。

勝敗

引き分け

宣言勝ち

没収勝ち・反則勝ち

その他

コンストラクタ

GameResult(value: int) -> GameResult

内部値から GameResult を生成します。

引数:

• value: 上記定数と同等の整数値（0-21、ただし 14・15・18・19 は未使用）

例外:

• ValueError: 不正な値を渡した場合

プロパティ

メソッド

勝敗判定

名前解決

特殊メソッド

使用例

基本的な使い方

import rsshogi as rs

# 定数として使用
result = rs.record.GameResult.BLACK_WIN
print(result.name)   # => "BLACK_WIN"
print(int(result))   # => 0

# 勝敗判定
if result.is_win():
    if result.is_black_win():
        print("先手の勝ち")
    else:
        print("後手の勝ち")
elif result.is_draw():
    print("引き分け")

棋譜の結果を判定

import rsshogi as rs

record = rs.record.Record.from_kif_str(kif_text)
result = record.result

# 詳細な結果を表示
print(f"結果: {result.name}")

if result == rs.record.GameResult.BLACK_WIN:
    print("先手の勝ち（通常）")
elif result == rs.record.GameResult.WHITE_WIN:
    print("後手の勝ち（通常）")
elif result.is_win_by_declaration():
    winner = "先手" if result.is_black_win() else "後手"
    print(f"{winner}の入玉宣言勝ち")
elif result == rs.record.GameResult.DRAW_BY_REPETITION:
    print("千日手による引き分け")
elif result == rs.record.GameResult.BLACK_WIN_BY_TIMEOUT:
    print("後手の時間切れで先手の勝ち")
elif result == rs.record.GameResult.WHITE_WIN_BY_TIMEOUT:
    print("先手の時間切れで後手の勝ち")

結果の種類ごとにカウント

import rsshogi as rs
from collections import Counter

results = []
for kif_text in kif_files:
    record = rs.record.Record.from_kif_str(kif_text)
    results.append(record.result.name)

# 集計
counter = Counter(results)
for name, count in counter.most_common():
    print(f"{name}: {count}局")

数値からの変換

import rsshogi as rs

# 数値から GameResult を生成
result = rs.record.GameResult(0)  # BLACK_WIN
print(result.name)  # => "BLACK_WIN"

# 比較
assert result == rs.record.GameResult.BLACK_WIN
assert result == 0  # int との比較も可能

名前からの変換と __members__

import rsshogi as rs

result = rs.record.GameResult.from_str("black_win")
assert result == rs.record.GameResult.BLACK_WIN

members = rs.record.GameResult.__members__
assert members["BLACK_WIN"] == rs.record.GameResult.BLACK_WIN

dict / set のキーとして使う

import rsshogi as rs

result = rs.record.GameResult.BLACK_WIN
stats = {result: 1}
assert stats[rs.record.GameResult(0)] == 1
assert rs.record.GameResult(0) in {result}

定数の一覧表

関連項目

• Record - 棋譜レコード
• Board - 盤面管理クラス