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