Slouží pro práci se strukturovanými textovými soubory. Soubor je členěn do sekcí, které obsahují na každém řádku na levé straně rovnítka klíč a na pravé straně hodnotu. Typickým příkladem takovýchto souborů jsou INI soubory používané systémem Control Web nebo některými aplikacemi ve Windows.
text_scanner text_scanner_name;
rem = string;
timer = timer_name;
send_same_data;
driver_exception = driver_name;
file_name = string;
open = boolean_expression;
save = boolean_expression;
clear = boolean_expression;
output = boolean_dataelement;
receivers = [ identifier, . . . ];
section
name = string;
range = min_index, max_index;
item
key = string;
element = data_element;
end_item;
item
...
end_item;
end_section;
section
...
end_section;
end_text_scanner;
Příklad nastavení parametrů přístroje
text_scanner TextScanner;
file_name = 'TEST.INI';
section
name = 'main';
item
key = 'user name';
element = user_name;
end_item;
item
key = 'time';
element = time;
end_item;
item
key = 'date';
element = date;
end_item;
end_section;
section
name = 'parameters';
range = 1, 5;
item
key = 'temperature';
element = TempArray;
end_item;
item
key = 'maximal';
element = MaxArray;
end_item;
item
key = 'minimal';
element = MinArray;
end_item;
end_section;
end_text_scanner;
Obsah souboru TEST.INI
[main] user name = kacafirek time = 12:35 date = 27.10.1997 [parameters 1] temperature = 24.5 maximal = 40 minimal = 10 [parameters 2] temperature = 27 maximal = 35 minimal = 15 [parameters 3] temperature = -12 maximal = -5 minimal = -20 [parameters 4] temperature = -25 maximal = -10 minimal = -30 [parameters 5] temperature = 40 maximal = 60 minimal = 20
Open( Path : string; &ok : boolean )
Otevře soubor Path, načte data a výsledek operace vrátí v parametru ok.
Save( Path : string; &ok : boolean )
Zapíše data do souboru Path a výsledek operace vrátí v parametru ok.
Clear()
Smaže obsah souboru.
CreateSection( Section : string )
Vytvoří novou sekci Section.
SetSection( Section : string; &ok : boolean )
Nastaví ukazatel sekce na sekci Section. Výsledek operace vrátí v parametru ok.
ClearSection( Section : string )
Smaže obsah sekce Section.
DeleteSection( Section : string )
Odstraní sekci Section.
GetKeyBool( Key : string; &Value : boolean; &ok : boolean )
Vrátí v parametru Value hodnotu typu boolean klíče Key z právě aktuální sekce. Výsledek operace vrátí v parametru ok.
GetKeyInt( Key : string; &Value : number; &ok : boolean )
Vrátí v parametru Value hodnotu typu integer klíče Key z právě aktuální sekce. Výsledek operace vrátí v parametru ok.
GetKeyReal( Key : string; &Value : real; &ok : boolean )
Vrátí v parametru Value hodnotu typu real klíče Key z právě aktuální sekce. Výsledek operace vrátí v parametru ok.
GetKeyStr( Key : string; &String : string; &ok : boolean )
Vrátí v parametru String hodnotu typu string klíče Key z právě aktuální sekce. Výsledek operace vrátí v parametru ok.
SetKeyBool( Key : string; Value : boolean; &ok : boolean )
Nastaví hodnotu klíče Key na boolean hodnotu Value v právě aktuální sekci. Výsledek operace vrátí v parametru ok.
SetKeyInt( Key : string; Value : number; &ok : boolean )
Nastaví hodnotu klíče Key na integer hodnotu Value v právě aktuální sekci. Výsledek operace vrátí v parametru ok.
SetKeyReal( Key : string; Value : real; &ok : boolean )
Nastaví hodnotu klíče Key na real hodnotu Value v právě aktuální sekci. Výsledek operace vrátí v parametru ok.
SetKeyStr( Key : string; String : string; &ok : boolean )
Nastaví hodnotu klíče Key na string hodnotu String v právě aktuální sekci. Výsledek operace vrátí v parametru ok.
ShowFile()
Zobrazí aktuální stav souboru v textovém DataView.
Přístroj může volat standardní událostní proceduru:
OnActivate()
Podrobnější informace k této proceduře lze nalézt v kapitole Programování a procedury.