Legge righe dallo standard input in una variabile di array indicizzato.
Legge righe dallo standard input nella variabile di ARRAY indicizzato, oppure
dal descrittore di file FD se viene fornita l'opzione -u. La variabile MAPFILE
è l'ARRAY predefinito.
Opzioni:
-n numero
[tab]
[tab]
Copia al massimo un NUMERO di righe. Se NUMERO è 0, vengono copiate tutte.
-O origine
[tab]
Inizia assegnando all'ARRAY all'indice ORIGINE. L'indice predefinito è 0.
-s numero
[tab]
Scarta le prime NUMERO righe lette.
-t
[tab]
[tab]
Rimuove un ritorno a capo finale da ciascuna riga letta.
-u fd
[tab]
[tab]
Legge le righe da un descrittore di file FD invece che dallo standard input.
-C callback
[tab]
Esamina CALLBACK ogni volta che vengono lette un numero QUANTO di righe.
-c quantità
[tab]
Specifica il numero di righe lette tra ciascuna chiamata a CALLBACK.
Argomenti:
ARRAY
[tab]
[tab]
Nome della variabile di array da usare per i dati dei file.
Se viene fornito -C senza -c, il quanto predefinito è 5000. Quando
viene analizzata CALLBACK, viene fornito l'indice dell'elemento di
array successivo da assegnare e la riga da attribuire a quell'elemento
come argomenti aggiuntivi.
Se non viene fornito con una origine esplicita, il file di mappa azzererà l'ARRAY
prima della relativa assegnazione.
Stato di uscita:
Restituisce successo a meno che non venga fornita una opzione non valida, ARRAY sia
in sola lettura oppure non indicizzato.