Načítať riadky zo štandardného vstupu do premennej indexovaného poľa.
Načíta riadky zo štandardného vstupu do premennej poľa POLE alebo z
popisovača súboru FD ak je zadaná voľba -u. Štandardné POLE je premenná
MAPFILE.
Voľby:
-n počet
[tab]
Skopírovať najviac POČET riadkov. Ak je POČET 0, všetky riadky.
-O začiatok
[tab]
Začať priraďovanie položiek POĽA na indexe ZAČIATOK.
[tab]
[tab]
Predvolený index je 0.
-s počet
[tab]
Ignorovať prvých prečítaných POČET riadkov.
-t
[tab]
[tab]
Odstrániť znak nového riadka z konca každého načítaného riadka.
-u fd
[tab]
[tab]
Načítať riadky z popisovača FD namiesto štandardného vstupu.
-C callback
[tab]
Vyhodnotiť CALLBACK po prečítaní každých QUANTUM riadkov.
-c quantum
[tab]
Určuje počet riadkov, ktoré sa majú prečítať pred každým
[tab]
[tab]
volaním CALLBACK.
Argumenty:
ARRAY
[tab]
[tab]
Názov premennej poľa, kam sa majú uložiť údaje.
Ak uvediete -C bez -c, predvolená hodnota quantum je 5000.
Pri vyhodnotení CALLBACK sa dodá index ďalšieho prvku poľa,
ktorý sa má priradiť ako ďalší argument.
Ak nie je zadaný ZAČIATOK explicitne, mapfile POLE vyčistí predtým,
než ho začne plniť.
Návratová hodnota:
Vráti 0 ak nebola zadaná neplatná voľba a POLE nie je len na čítanie a
nie je to indexované pole.