Plik tekstowy: Różnice pomiędzy wersjami
(→Parametry) |
|||
| Linia 59: | Linia 59: | ||
(pX) | (pX) | ||
gdzie X jest kolejnym indeksem parametru (zaczynając od 1). | gdzie X jest kolejnym indeksem parametru (zaczynając od 1). | ||
| + | |||
Przykładowa zawartość parametryzowanego pliku (nazwijmy go example.txt) może wyglądać tak: | Przykładowa zawartość parametryzowanego pliku (nazwijmy go example.txt) może wyglądać tak: | ||
| Linia 68: | Linia 69: | ||
Umieszczenie takiego polecenia spowoduje nastepującą interpretację zawartości pliku: | Umieszczenie takiego polecenia spowoduje nastepującą interpretację zawartości pliku: | ||
Cześć, jestem Jerzy. Mam 50 lat. | Cześć, jestem Jerzy. Mam 50 lat. | ||
| + | |||
Dopuszczalne jest także zagniezdzanie parametrów. Jesli zdefiniujemy np. | Dopuszczalne jest także zagniezdzanie parametrów. Jesli zdefiniujemy np. | ||
Wersja z 09:05, 6 lip 2022
Artykuł zawiera informacje na temat funkcjonowania plików tekstowych w symulatorze.
Spis treści
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) (znak nowej linii) ; (średnik) , (przecinek)
Dla lepszej czytelności zalicza się stosowanie jedynie białych znaków, czyli spacji, tabulatora oraz znaku nowej linii.
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ć komentarze. Są one ignorowane przez parser. Można w nich zapisywać notatki lub tymczasowo deaktywować wybrane wpisy.
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 wklejana w miejsce tego polecenia.
include file parameters end
| 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 ciągów parametrycznych w dołączanym pliku.
Parametr definiuje się za pomocą ciągu parametrycznego:
(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 spowoduje nastepującą interpretację zawartości pliku:
Cześć, jestem Jerzy. Mam 50 lat.
Dopuszczalne jest także zagniezdzanie parametrów. Jesli zdefiniujemy np.
include foo.inc param1_i_(p3) param2 param3 end
to parser przy odczytywaniu takiego include i napotkaniu tokena "wstaw_tutaj_(p1)_oraz_(p2)" wyprodukuje:
wstaw_tutaj_param1_i_param3_oraz_param2
