Versenyjelentési fájl

A Tournament Report File, röviden TRF olyan szövegfájl, amelyet arra terveztek, hogy különböző programok kiszámítható módon cserélhessenek versenyadatokat. Nem szabad formájú szöveg: a rekordok azonosító kódokkal kezdődnek, a mezők pedig rögzített oszlopokat, vagyis minden sorban pontos karakterpozíciókat foglalnak el. A szóközök ezért a szerkezet részét képezik, és szerkesztéskor nem szabad eltávolítani őket.

Egy TRF tartalmazhatja az esemény adatait, a játékosokat, párosítási számokat, szövetségeket, pontszámokat, végső helyezéseket, valamint minden fordulóhoz az ellenfelet, a színt és az eredményt. A specifikáció támogatja az értékszámokhoz, a párosítások ellenőrzéséhez, a holtversenyek feloldásához, a csapatversenyekhez és a versenyprogramok közötti, esemény közbeni adatcseréhez használt adatokat is.

Amit nem rögzít

A TRF arról számol be, mi történt a verseny egészében, de rendszerint nem tárolja minden játszma összes lépését. Ezt a szerepet gyakran a PGN, vagyis Portable Game Notation tölti be: a lépésszövege rögzíti a lejátszott sorozatot, a címkepárjai pedig olyan adatokat azonosítanak, mint a játékosok, a dátum és az eredmény. Egy eseménynek mindkét formátumra szüksége lehet, mert más kérdésekre válaszolnak.

A megadott verzió számít. A TRF fejlődött, és egyes rekordok vagy mezők nem állnak rendelkezésre minden verzióban. Az importáló szoftvernek tudnia kell, melyik verziót várja, és pontosan meg kell őriznie minden mező hosszát, sorrendjét és jelentését.