Lit des lignes depuis l'entrée standard vers une variable tableau indexé.
Lit des lignes depuis l'entrée standard vers la variable tableau indexé TABLEAU ou
depuis le descripteur de fichier FD si l'option « -u » est utilisée. La variable MAPFILE
est le TABLEAU par défaut.
Options :
-n nombre
[tab]
Copie au maximum NOMBRE lignes. Si NOMBRE est 0, toutes les lignes sont copiées.
-O origine
[tab]
Commence l'affectation au TABLEAU à l'indice ORIGINE. L'indice par défaut est 0.
-s nombre
[tab]
Saute les NOMBRE premières lignes lues.
-t
[tab]
[tab]
Retire les retours à la ligne de chaque ligne lue.
-u fd
[tab]
[tab]
Lit les lignes depuis le descripteur de fichier FD au lieu de l'entrée standard.
-C callback
[tab]
Évalue le CALLBACK à chaque fois que QUANTUM lignes sont lues.
-c quantum
[tab]
Indique le nombre de lignes lues entre chaque appel au CALLBACK.
Arguments :
TABLEAU
[tab]
[tab]
Nom de la variable tableau à utiliser pour les données.
Si l'option « -C » est fournie sans option « -c », le quantum par défaut est 5000. Lorsque
CALLBACK est évalué, l'indice du prochain élément de tableau qui sera affecté
lui est transmis comme argument additionnel.
Si la commande « mapfile » n'est pas fournie avec une origine explicite, le tableau est vidé
avant affectation.
code de retour :
Renvoie le code de succès à moins qu'une option non valable ne soit donnée ou que
le TABLEAU soit en lecture seule ou ne soit pas un tableau indexé.