Plik tekstowy: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(Include i parametryzacja)
(Tokeny i separatory)
Linia 6: Linia 6:
 
  (spacja)
 
  (spacja)
 
  (tabulator)
 
  (tabulator)
 +
(znak nowej linii)
 
  ; (średnik)
 
  ; (średnik)
 
  , (przecinek)
 
  , (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.
 
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
 
  token1 token2 '''"token;3"''' token4
 
  
 
== Komentarze ==
 
== Komentarze ==

Wersja z 07:02, 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 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.