PGNP: PGN Parser

PGNP is a Portable Game Notation (PGN) parser. More details about the PGN specification can be found here.

Features

• Basic PGN parsing (tags, move, comments, variations, NAG, etc.)
• Parse PGN files that contains multiple games
• Handle very large files: up to 2^(sizeof(unsigned long long)*8) bytes
• Efficiency

How to use it ?

PGNP can be used as a shared library in your project. You only need to include pgnp.hpp and linking the .so file to your executable.

Example

Somewhere at the beginning of the file:

#include "pgnp.hpp"

Load PGN from file/string:

pgnp::PGN pgn;
try {
    pgn.FromFile("pgn.txt"); // Or pgn.FromString("YOUR PGN CONTENT HERE");
    pgn.ParseNextGame();
}
catch(...){
    // Handle exceptions
}

Various API calls:

bool hasRound=pgn.HasTag("Round"); // Check if a tag exists
try {
    pgn.STRCheck(); // Perform a Seven Tag Roster check
}
catch(...){
    // Handle exceptions
}
std::vector<std::string> tags=pgn.GetTagList(); // Get the list of tags in current game
std::string tagValue=GetTagValue("Date"); // Get the value of a tag in current game

Access to moves:

pgnp::HalfMove *moves=new pgnp::HalfMove();
pgn.GetMoves(moves); // Get the tree of half moves
int length=moves->GetLength(); // Get the number of half move in the current MainLine
// Public members:
// moves->variations contains variations of the current move
// moves->isBlack boolean that says if current half move is for the black side
// Check pgnp.hpp for more infos for the other fields (comments, count, etc.)

CMake Integration

By using the add_subdirectory() directive on this repository, you will be able to use the following cmake calls in your project:

include_directories(${PGNP_INCLUDE_DIR})
target_link_libraries(<YOUR_TARGET> pgnp)