Plik tekstowy

Artykuł zawiera informacje na temat funkcjonowania plików tekstowych w symulatorze.

Tokeny i separatory

Plik tekstowy składa się z tokenów, czyli ciągów tekstu oddzielonych od siebie separatorami. Podstawowymi separatorami są znaki:

(spacja)
(tabulator)
; (średnik)
, (przecinek)

Gdy zachodzi potrzeba, aby znak separatora był częścią tokenu, wówczas token należy ująć w cudzysłów, tak jak w poniższym przykładzie.

token1 token2 "token;3" token4

Komentarze

W plikach tekstowych można stosować dwa typy komentarzy.

Komentarz liniowy

Znakiem początkowym komentarza liniowego są dwa ukośniki, a jego końcem jest znak nowej linii:

// ta treść jest zakomentowana
ale ta już nie

Komentarz blokowy

Komentarzem blokowym można objąć wiele linii tekstu. Znakiem początkowym jest ukośnik i gwiazdka, a końcowym - gwiazdka i ukośnik.

/* ta treść zajmuje
wiele linii
i jest
zakomentowana */
ale ta już nie jest

Include

Include jest poleceniem które pomaga w modularyzacji plików. Podczas wczytywania pliku, gdy parser trafi na polecenie include we wczytywanym pliku, zawartość pliku dołączonego za pośrednictwem polecenia include jest niejako "wklejana" w miejsce tego polecenia.

include file parameters end

Opis parametrów

Nazwa	Znaczenie
file	Ścieżka do pliku, którego zawartość ma być podstawiona w miejsce wpisu.
parameters	Wartości, które zostaną podstawione w miejsce parametrów zdefiniowanych w pliku.

Parametry

Polecenie include może przyjmować parametry, których wartości zostaną podstawione w miejsce określonych tokenów w dołączanym pliku.

Parametr definiuje się za pomocą ciągu tekstowego:

(pX)

gdzie X jest kolejnym indeksem parametru (zaczynając od 1).

Przykładowa zawartość parametryzowanego pliku (nazwijmy go example.txt) może wyglądać tak:

Cześć, jestem (p1). Mam (p2) lat.

Dołączenie powyższego pliku za pomocą polecenia include:

include example.txt Jerzy 50 end

Umieszczenie takiego polecenia w pliku spowoduje nastepującą interpretację jego zawartości:

Cześć, jestem Jerzy. Mam 50 lat.