Příkaz SkipTo


Syntaxe: SkipTo Řetězec

Řetězec je povinně jednoznakový (jinak příkaz zahlásí chybu a ukončí všechny rozpracované scripty). Program přijme od partnerského subjektu spojení řetězec znaků ukončených prvním (nejbližším) výskytem tohoto tzv. ukončovacího znaku. Pokud již spojení ukončil některý z předchozích příkazů, bylo ztraceno či ukončeno partnerským subjektem nebo nebylo vůbec navázáno, příkaz zahlásí chybu a ukončí všechny rozpracované scripty. Příkaz načte řetězec včetně zmíněného ukončovacího znaku (další event. příkazy pro čtení pokračují za tímto znakem). Délka řetězce je omezena počtem 4096 - pokud do tohoto počtu není přijat ukončovací znak, příkaz zahlásí chybu a ukončí všechny rozpracované scripty.
Příkaz v ideálním případě nalezne znaky již přijaté ve vstupní frontě spojení, takže je pouze převezme a ihned se vrátí. Pokud partnerský subjekt dosud neodeslal žádný ukončovací znak, čeká příkaz nejprve na jeho přijetí do vstupní fronty.
Pokud příkaz úspěšně načte řetězec, naplní jeho čistou hodnotou (bez ukončovacího znaku !) systémovou proměnnou line (po příkazu SkipTo "A" a přijetí řetězce "HOLKA" bude mít line délku 4 znaky a hodnotu "HOLK"). Tato systémová proměnná pak může být použita jako součást řetězců (viz také).
V případě úspěšného načtení, je-li současně aktivní některý příkaz OutputFile, je řetězec v úplné délce (včetně ukončovacího znaku) zapsán do výstupního souboru (v našem příkladě se do souboru zapíše všech přijatých 5 znaků "HOLKA").
Typickým použitím příkazu je načtení jedné řádky příkazem SkipTo nl .
Příklady:
	SkipTo "A"
	SkipTo nl
	SkipTo "\n"