Plik tekstowy: Różnice pomiędzy wersjami
(→Include i parametryzacja) |
|||
| Linia 34: | Linia 34: | ||
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. | 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 < | + | <span style="color:tomato;font-weight:bold">include</span> ''file parameters'' <span style="color:tomato;font-weight:bold">end</span> |
| + | |||
| + | {| class="wikitable" | ||
| + | |+ 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 === | === Parametry === | ||
| Linia 44: | Linia 57: | ||
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: | ||
| − | + | Cześć, jestem '''(p1)'''. Mam (p2) lat. | |
Dołączenie powyższego pliku za pomocą polecenia include: | Dołączenie powyższego pliku za pomocą polecenia include: | ||
| − | include example.txt Jerzy end | + | <span style="color:tomato;font-weight:bold">include</span> example.txt Jerzy 50 <span style="color:tomato;font-weight:bold">end</span> |
Umieszczenie takiego polecenia w pliku spowoduje nastepującą interpretację jego zawartości: | Umieszczenie takiego polecenia w pliku spowoduje nastepującą interpretację jego zawartości: | ||
| − | + | Cześć, jestem Jerzy. Mam 50 lat. | |
Wersja z 06:54, 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) ; (ś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 i parametryzacja
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
| 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.
