クイックスタート

このガイドでは、rustshogiの基本的な使用方法を説明します。

基本的な使用方法

まず、rustshogiをインポートして初期局面を作成します：

from rustshogi import Board, ColorType, Move, Address, PieceType

# 初期局面を作成
board = Board("startpos")
print(board)

盤面の表示

盤面の現在の状態を確認できます：

# 盤面を文字列として表示
print(str(board))

# 特定の位置の駒を確認
address = Address(5, 5)  # 5五の位置
piece = board.get_piece(address)
print(f"5五の駒: {piece}")

合法手の検索

現在の局面での合法手を検索：

# 先手の合法手を検索
legal_moves = board.search_moves(ColorType.Black)
print(f"先手の合法手数: {len(legal_moves)}")

# 最初の合法手を表示
if legal_moves:
    print(f"最初の合法手: {legal_moves[0]}")

手を実行

合法手を実行して局面を進めます：

# 手を実行
if legal_moves:
    move = legal_moves[0]
    board.execute_move(move)
    print(f"手を実行しました: {move}")
    print(board)

手の表現

手は以下のような形式で表現されます：

# 手の詳細情報
move = legal_moves[0]
print(f"移動元: {move.get_from()}")
print(f"移動先: {move.get_to()}")
print(f"駒: {move.get_piece()}")
print(f"成り: {move.is_promote()}")
print(f"打ち駒: {move.is_drop()}")

ゲームの終了判定

ゲームが終了したかどうかを確認：

# ゲーム終了判定
is_finished, winner = board.is_finished()
if is_finished:
    print("ゲーム終了")
    print(f"勝者: {winner}")
else:
    print("ゲーム継続中")

完全な例

以下は簡単な対局の例です：

from rustshogi import Board, ColorType, Game, Move

# 初期局面
board = Board("startpos")

# 10手まで対局
for i in range(10):
    is_finished, winner = board.is_finished()
    if is_finished:
        print(f"ゲーム終了: 勝者 {winner}")
        break

    # 現在の手番を決定（交互に指す）
    current_color = ColorType.Black if i % 2 == 0 else ColorType.White
    legal_moves = board.search_moves(current_color)

    if not legal_moves:
        print("合法手がありません")
        break

    # 最初の合法手を指す
    move = legal_moves[0]
    board.execute_move(move)

    print(f"手数 {i+1}: {move}")
    print(board)
    print("-" * 40)

print("対局終了")