Analyse d'un fichier PGN par les expressions régulières

**Roland Chastain** · 22/11/2017, 23h19

Bonjour ! Je vous propose une procédure qui analyse le contenu d'un fichier PGN, représentant un ensemble de parties d'échecs.
La procédure est basée sur les expressions régulières.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
 
unit PGN;
 
interface
 
procedure ParsePGNText(const aText: string);
 
implementation
 
uses
  RegExpr;
 
procedure ParsePGNText(const aText: string);
const
  TAG = '\[\w+\s+"[^"]+"\]';
  TAGS = '(' + TAG + '\s+)+';
  FULLMOVENUMBER = '\d+\.\s+';
  FULLMOVE = '([A-Za-z][\w-+#]+\s+){1,2}';
  MOVE = FULLMOVENUMBER + FULLMOVE;
  MOVES = '(' + MOVE + ')+';
  RESULT = '(1-0|0-1|1/2-1/2|\*)';
  GAME = TAGS + MOVES + RESULT;
 
type
  TPattern = (ptGame, ptTag, ptMove, ptResult);
 
var
  vExpr: array[TPattern] of TRegExpr;
  vPattern: TPattern;
  vText: string;
 
begin
  vText := aText;
 
  vExpr[ptGame] := TRegExpr.Create(GAME);
  vExpr[ptTag] := TRegExpr.Create(TAG);
  vExpr[ptMove] := TRegExpr.Create(MOVE);
  vExpr[ptResult] := TRegExpr.Create(RESULT);
 
  try
    if vExpr[ptGame].Exec(vText) then
      repeat
        vText := vExpr[ptGame].Match[0];
 
        with vExpr[ptTag] do
          if Exec(vText) then
          repeat
            WriteLn('TAG ', Match[0]);
          until not ExecNext;
 
        with vExpr[ptMove] do
          if Exec(vText) then
          repeat
            WriteLn('MOVE ', ReplaceRegExpr('\s', Match[0], ' ', FALSE));
          until not ExecNext;
 
        with vExpr[ptResult] do
          if Exec(vText) then
            WriteLn('RESULT ', Match[0]);
 
      until not vExpr[ptGame].ExecNext;
  finally
    for vPattern in TPattern do
    vExpr[vPattern].Free;
  end;
end;
 
end.

Qu'en pensez-vous ?

**Roland Chastain** · 25/11/2017, 01h20

Voici une nouvelle version qui pousse plus loin l'analyse du contenu du fichier. Les groupes de caractères qui représentent les coups sont décomposés dans leurs différents éléments, par exemple :

Code X :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
[MOVE]36. Ra6+ Kc5 
  ELEM[1]R
  ELEM[2]
  ELEM[3]a6
  ELEM[4]
  ELEM[5]+
  ELEM[1]K
  ELEM[2]
  ELEM[3]c5

Il y a aussi certaines subtilités du standard PGN que je n'avais pas prises en compte dans la version précédente.

Pour le moment, la fonction ParsePGNText ne fait qu'écrire dans la console les sous-chaînes extraites. Au lieu de cela, il serait intéressant que la fonction renvoie un tableau contenant toutes les données. Je réfléchis à la forme que pourrait prendre ce tableau.

**Roland Chastain** · 26/11/2017, 22h41

J'ai revu ma copie, après m'être aperçu que certaine subtilités de la "notation algébrique standard" m'avaient échappé.

Cette fois j'ai mis les petits plats dans les grands :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
const
  COLUMN = '[a-h]';
  ROW = '[1-8]';
  KINGSIDE_CASTLING = 'O-O';
  QUEENSIDE_CASTLING = 'O-O-O';
 
  PIECE = '[PNBRQK]';
  DISAMBIGUATION = COLUMN + '|' + ROW + '|' + COLUMN + ROW;
  CAPTURE = 'x';
  SQUARE_OR_CASTLING = COLUMN + ROW + '|' + QUEENSIDE_CASTLING + '|' + KINGSIDE_CASTLING;
  PROMOTION = '=[NBRQ]';
  CHECK_OR_CHECKMATE = '[+#]';
  SAN_MOVE =
    '(' + PIECE + ')?' +
    '(' + DISAMBIGUATION + ')?' +
    '(' + CAPTURE + ')?' +
    '(' + SQUARE_OR_CASTLING + ')' +
    '(' + PROMOTION + ')?' +
    '(' + CHECK_OR_CHECKMATE + ')?';
 
  FULL_MOVE = '(\d+)\.\s+(' + SAN_MOVE + '\s+){1,2}';
  MOVES_SECTION = '(' + FULL_MOVE + ')+';
 
  TAG_PAIR = '\[(\w+)\s+"([^"]+)"\]';
  TAG_PAIRS_SECTION  = '(' + TAG_PAIR + '\s+)+';
 
  GAME_TERMINATION = '(1-0|0-1|1/2-1/2|\*)';
 
  GAME = TAG_PAIRS_SECTION + MOVES_SECTION + GAME_TERMINATION;

Maintenant je cherche sous quelle forme renvoyer ces données, sachant qu'il peut y avoir zéro ou une ou plusieurs parties dans un fichier, que chaque partie a une liste de coups de longueur variable...

Le seul point pour lequel j'ai une idée précise, c'est pour les paires nom-valeurs : je pense utiliser un TStringList.

**Roland Chastain** · 28/11/2017, 22h47

J'ai retravaillé l'unité PGN. Les données, au lieu d'être simplement écrites dans la console, sont renvoyées au programme principal sous la forme d'un tableau.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
 
unit PGN;
 
interface
 
uses
  SysUtils, Classes;
 
type
  TGroupIndex = 1..6;
 
  TChessGame = class
    tags: TStringList;
    moves: array of array[TGroupIndex] of string;
    termination: string;
    constructor Create; overload;
    destructor Destroy; override;
  end;
 
  TChessGameArray = array of TChessGame;
 
function ParsePGNText(aText: string): TChessGameArray;
 
implementation
 
uses
  RegExpr;
 
constructor TChessGame.Create;
begin
  inherited;
  tags := TStringList.Create;
end;
 
destructor TChessGame.Destroy;
begin
  tags.Free;
  SetLength(moves, 0);
  inherited;
end;
 
function ParsePGNText(aText: string): TChessGameArray;
const
  COLUMN = '[a-h]';
  ROW = '[1-8]';
  KINGSIDE_CASTLING = 'O-O';
  QUEENSIDE_CASTLING = 'O-O-O';
  PIECE = '[PNBRQK]';
  DISAMBIGUATION = COLUMN + '|' + ROW + '|' + COLUMN + ROW;
  CAPTURE = 'x';
  SQUARE_OR_CASTLING = COLUMN + ROW + '|' + QUEENSIDE_CASTLING + '|' + KINGSIDE_CASTLING;
  PROMOTION = '=[NBRQ]';
  CHECK_OR_CHECKMATE = '[+#]';
  SAN_MOVE =
    '(' + PIECE + ')?' +
    '(' + DISAMBIGUATION + ')?' +
    '(' + CAPTURE + ')?' +
    '(' + SQUARE_OR_CASTLING + ')' +
    '(' + PROMOTION + ')?' +
    '(' + CHECK_OR_CHECKMATE + ')?';
  FULL_MOVE = '(\d+)\.\s+(' + SAN_MOVE + '\s+){1,2}';
  MOVES_SECTION = '(' + FULL_MOVE + ')+';
  TAG_PAIR = '\[(\w+)\s+"([^"]+)"\]';
  TAG_PAIRS_SECTION  = '(' + TAG_PAIR + '\s+)+';
  GAME_TERMINATION = '(1-0|0-1|1/2-1/2|\*)';
  GAME = TAG_PAIRS_SECTION + MOVES_SECTION + GAME_TERMINATION;
type
  TSearch = (searchGame, searchTagPair, searchFullMove, searchTermination, searchMove);
const
  PATTERNS: array[TSearch] of string = (GAME, TAG_PAIR, FULL_MOVE, GAME_TERMINATION, SAN_MOVE);
var
  vExpr: array[TSearch] of TRegExpr;
  vSearch: TSearch;
  vText: string;
procedure ParseFullMove(const aFullMove: string);
var
  vIndex: integer;
begin
  with vExpr[searchMove] do
    if Exec(aFullMove) then
      with result[High(result)] do
      repeat
        SetLength(moves, Succ(Length(moves)));
        for vIndex := 1 to SubExprMatchCount do
          moves[High(moves)][vIndex] := Match[vIndex];
      until not ExecNext;
end;
begin
  for vSearch in TSearch do
    vExpr[vSearch] := TRegExpr.Create(PATTERNS[vSearch]);
 
  SetLength(result, 0);
 
  try
    if vExpr[searchGame].Exec(aText) then
      repeat
        aText := vExpr[searchGame].Match[0];
 
        SetLength(result, Succ(Length(result)));
        result[High(result)] := TChessGame.Create;
        result[High(result)].tags.Sorted := TRUE;
 
        with vExpr[searchTagPair] do
          if Exec(aText) then
          repeat
            result[High(result)].tags.Append(Format('%s=%s', [Match[1], Match[2]]));
          until not ExecNext;
 
        with vExpr[searchFullMove] do
          if Exec(aText) then
          repeat
            ParseFullMove(Match[0]);
          until not ExecNext;
 
        with vExpr[searchTermination] do
          if Exec(aText) then
            result[High(result)].termination := Match[0];
 
      until not vExpr[searchGame].ExecNext;
  finally
    for vSearch in TSearch do
      vExpr[vSearch].Free;
  end;
end;
 
end.

Les observations sur ce code sont les bienvenues.

Que pensez-vous de la forme sous laquelle les données sont renvoyées ? L'auriez-vous déclarée plus ou moins de la même façon ? Je parle du type TChessGameArray.

**M.Dlb** · 29/11/2017, 11h24

Bonjour Roland,

Sans avoir lu en détail le programme... pour ce genre de choses, je passe plutôt par une TList, qui est beaucoup plus flexible qu'un array.
Vu qu'on est à fond dans le monde objet mode Delphi (tu utilises des classes, plutôt que des objects ou des records), on peut estimer que pour la cohérence philosophique, la classe TList soit plus adaptée

**Roland Chastain** · 01/12/2017, 15h00

@M.Dlb

Bonjour ! Merci pour ta réponse et ta suggestion, que j'ai suivie.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
type
  TGroupIndex = 1..6;
  PGroups = ^TGroups;
  TGroups = array[TGroupIndex] of string;
 
  TChessGame = class
    tags: TStringList;
    moves: TList;
    termination: string;
    constructor Create; overload;
    destructor Destroy; override;
  end;
 
function ParsePGNText(aText: string): TList;

La seule qui m'a mis un peu mal à l'aise avec la classe TList c'est qu'il faut savoir, pour ne pas dire deviner, ce qu'elle contient. Ou alors y a-t-il un moyen de le contrôler dans le code ?

**M.Dlb** · 01/12/2017, 18h04

Envoyé par Roland Chastain

La seule qui m'a mis un peu mal à l'aise avec la classe TList c'est qu'il faut savoir, pour ne pas dire deviner, ce qu'elle contient. Ou alors y a-t-il un moyen de le contrôler dans le code ?

Que veux-tu dire par là ?
TList représente une liste de pointeurs, qui pointe vers des objets. J'évite toujours de mélanger les types d'objets dans mes listes : une instance TList pour chaque type d'objet du programme. Ainsi, lors du transtypage pour l'accès aux infos par le biais de la propriété Items, aucune question à se poser.
Pour la gestion, la propriété Count donne le nombre d'éléments dans la liste, puis après un fait joujou avec Add, Delete, Pack (qui est bien utile pour faire le ménage), etc...

**anapurna** · 01/12/2017, 18h09

salut

utilise les collections c'est pratique aussi

**Roland Chastain** · 01/12/2017, 18h14

Envoyé par anapurna

salut

utilise les collections c'est pratique aussi

Bonjour ! Merci pour ta réponse. J'avais fait moi-même un tutoriel sur les collections en Pascal.

Les collections en Pascal

Est-ce que c'est à ce genre de code que tu penses ou à autre chose ?

**anapurna** · 04/12/2017, 14h43

salut

pas tout a fait j'etais plus sur un truc du genre

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
type
  TMove = class (TCollectionItem)
  private
    Fdata : ...;
  published
    property Data: ... read Fdata write Fdata;
  end;    
 
 TMoves = class (TCollection)
  private
    function GetItem(Index: Integer): TMove;
  public
    function Add: TMove;
    property Item[Index: Integer]: TMove read GetItem;
  end;  
 
.....
 
  function TMoves.Add: TMove;
  begin
    result := inherited Add as TMove;
  end;
 
  function TMoves.GetItem(Index: Integer): TMove;
  begin
    result := inherited Items[Index] as TMove;
  end;

Analyse d'un fichier PGN par les expressions régulières

Contribuez Pascal

Discussions similaires

Partager

Partager