Načte řádky ze standardního vstupu do proměnné typu indexované pole.
Načte řádky ze standardního vstupu nebo z
[nbsp]deskriptoru souboru FD, byl-li
zadán přepínač -u, do proměnné POLE, která je typu indexované pole.
Implicitním POLEM je proměnná MAPFILE.
Přepínače:
-n počet
[tab]Zkopíruje nejvýše POČET řádků. Je-li POČET 0,
[tab][tab]zkopíruje všechny řádky.
-O počátek
[tab]Přiřazování do POLE začne na indexu POČÁTEK.
[tab][tab]Implicitní index je 0.
-s počet
[tab]Zahodí prvních POČET načtených řádků.
-t
[tab][tab]Odstraní znak konce řádku z
[nbsp]každého načteného řádku.
-u fd
[tab][tab]Řádky čte z
[nbsp]deskriptoru souboru FD namísto ze
[tab][tab]standardního vstupu.
-C volání
[tab]Vyhodnotí VOLÁNÍ pokaždé, když je načteno MNOŽSTVÍ
[tab][tab]řádků.
-c množství
[tab]Udává počet řádků, které je třeba přečíst, mezi
[tab][tab]každým zavoláním VOLÁNÍ.
Argumenty:
POLE
[tab][tab]Název proměnné typu pole, do které budou přiřazena data.
Je-li uvedeno -C bez -c, implicitní množství bude 5000. Vyhodnocovanému
VOLÁNÍ budou jako dodatečné argumenty předány index prvku pole, do
kterého se má vzápětí přiřazovat, a řádek, který má být přiřazen do
tohoto prvku.
Nebude-li explicitně udán počátek, mapfile vyprázdní POLE před tím,
než do něj začne přiřazovat.
Návratový kód:
Vrátí úspěch, pokud nebyl zadán neplatný přepínač, POLE nebylo jen pro
čtení a bylo indexovaným polem.
