PGNタグペア

PGNはPortable Game Notationの略で、対局を記録するテキスト形式です。PGNタグペアは、対局に関する1つの記述情報を保存します。連続する4部分、開始角括弧、タグ名、引用符付き値、終了角括弧で構成されます。[White "Carlsen, Magnus"]では、Whiteが名前、Carlsen, Magnusが値です。

名前に使えるのは文字、数字、アンダースコアだけで、大文字と小文字を区別します。そのためWhiteとwhiteは別の名前です。1つの対局のタグセクション内で、同じタグ名を複数回使うべきではありません。

値の中で引用符そのものを書く場合は直前にバックスラッシュを置き、バックスラッシュそのものは2個重ねます。引用符付き文字列の中に改行やタブ文字を入れることはできません。

タグペアは対局の冒頭、ムーブテキストの前にまとめて置かれます。Event、Date、White、Resultなどのタグは、イベント、日付、プレイヤー、結果を表します。ほかのタグには、標準でない初期局面やタイムコントロールなどの追加情報を保存できます。

PGNエクスポート形式では、名前と値の間を正確に1個の空白とし、各ペアを独立した行に置き、セクション後に空行を入れる必要があります。インポート形式では空白と改行をより柔軟に扱えます。タグペアの論理構造は同じです。