Plik tekstowy: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(Parametry)
Linia 34: Linia 34:
 
== Include ==
 
== Include ==
 
Include jest poleceniem które pomaga w modularyzacji plików.  
 
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.
+
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.
  
 
  <span style="color:tomato;font-weight:bold">include</span> ''file parameters'' <span style="color:tomato;font-weight:bold">end</span>
 
  <span style="color:tomato;font-weight:bold">include</span> ''file parameters'' <span style="color:tomato;font-weight:bold">end</span>

Wersja z 08:53, 6 lip 2022

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)
(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ć 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 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 spowoduje nastepującą interpretację zawartości pliku:

Cześć, jestem Jerzy. Mam 50 lat.