/// <summary>
/// Loads ChessBoard from Portable Game Notation<br/>
/// ex.:<br/>
/// [White "Milan1905"]<br/>
/// [Black "Geras1mleo"]<br/>
/// [Result "1-0"]<br/>
/// [WhiteElo "1006"]<br/>
/// [BlackElo "626"]<br/>
/// [Termination "Milan1905 won by resignation"]<br/>
/// <br/>
/// 1. e4 e5 2. Nf3 Nf6 3...
/// </summary>
/// <param name="pgn">PGN string to load</param>
/// <returns>ChessBoard with according positions</returns>
/// <exception cref="ChessArgumentException">Given FEN string didn't match the Regex pattern (if PGN contains FEN in header)</exception>
/// <exception cref="ChessArgumentException">Given San-notated move didn't match the Regex pattern</exception>
/// <exception cref="ChessSanNotFoundException">Given San-notated move is not valid for current board positions</exception>
/// <exception cref="ChessSanTooAmbiguousException">Given San-notated move is too ambiguous between multiple moves</exception>
public static ChessBoard LoadFromPgn(string pgn)
{
var(succeeded, exception) = PgnBuilder.TryLoad(pgn, out var board);
if (!succeeded && exception is not null)
{
throw exception;
}
return(board !);
}
/// <summary>
/// Tries to load ChessBoard from Portable Game Notation<br/>
/// ex.:<br/>
/// [White "Milan1905"]<br/>
/// [Black "Geras1mleo"]<br/>
/// [Result "1-0"]<br/>
/// [WhiteElo "1006"]<br/>
/// [BlackElo "626"]<br/>
/// [Termination "Milan1905 won by resignation"]<br/>
/// <br/>
/// 1. e4 e5 2. Nf3 Nf6 3...
/// </summary>
/// <param name="pgn">PGN string to load</param>
/// <param name="board">Result with loaded board</param>
/// <returns>Whether load is succeeded</returns>
public static bool TryLoadFromPgn(string pgn, [NotNullWhen(true)] out ChessBoard?board)
{
return(PgnBuilder.TryLoad(pgn, out board).succeeded);
}
/// <summary>
/// Generates PGN string representing current board
/// </summary>
public string ToPgn()
{
return(PgnBuilder.BoardToPgn(this));
}