Lee líneas de un fichero y las guarda en una variable de matriz indizada.
Lee líneas de la entrada estándar y las guarda en la variable de matriz
indizada MATRIZ, o desde el descriptor de fichero DF si se proporciona
la opción -u. La variable MAPFILE es la MATRIZ por defecto.
Opciones:
-n cuenta
[tab]
Copia hasta CUENTA líneas. Si CUENTA es 0, se copian
[tab]
todas las líneas.
-O origen
[tab]
Comienza a asignar a MATRIZ en el índice ORIGEN. El
[tab]
índice por defecto es 0.
-s cuenta
[tab]
Descarta las primeras CUENTA líneas leídas.
-t
[tab]
[tab]
Borra la nueva línea final de cada línea leída.
-u df
[tab]
[tab]
Lee líneas del descriptor de fichero DF en lugar de la
[tab]
entrada estándar.
-C llamada
[tab]
Evalúa LLAMADA cada vez que se leen QUANTUM líneas.
-c quantum
[tab]
Especifica el número de líneas a leer entre cada
[tab]
llamada a LLAMADA.
Argumentos:
MATRIZ
[tab]
[tab]
Nombre de variable de matriz a usar para guardar datos.
Si se proporciona -C sin -c, el quantum por defecto es 5000. Cuando
se evalúa LLAMADA, se proporciona el índice del siguiente elemento
de la matriz a asignar como un argumento adicional.
Si no se proporciona un origen explícito, mapfile borrará la MATRIZ
antes de usarla para asignación.
Estado de Salida:
Devuelve con éxito a menos que se proporcione una opción inválida o
la MATRIZ sea de sólo lectura o no sea una matriz indizada.