Příkaz Receive


Syntaxe: Receive počet znaků

Program přijme od partnerského subjektu spojení řetězec čítající právě tolik znaků. 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 přijímá řetězec v jeho čisté délce (bez jakýchkoli konců řádky) a nemá vliv na event. následující čtení. Délka řetězce je omezena počtem 4096, je však možné číst i delší bloky prostým opakováním příkazu Receive.
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 dostatečný počet znaků, čeká příkaz nejprve na naplnění požadované délky vstupní fronty.
Pokud příkaz úspěšně načte řetězec, naplní jeho úplnou hodnotou systémovou proměnnou line (po příkazu Receive 5 bude mít line délku 5 znaků). 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 zapsán do výstupního souboru (po příkazu Receive 5 se do souboru zapíše přijatých 5 znaků).
Příklady:
	Receive 1
	Receive 110