Lê linhas da entrada padrão para uma variável de matriz indexada.
Lê linhas da entrada padrão para a variável de matriz indexada MATRIZ, ou
do descritor de ficheiro FD se a opção -u for fornecida. A variável MAPFILE
é a MATRIZ predefinida.
Opções:
-d delim
[tab]
Usa DELIM para terminar as linhas, em vez de nova linha
-n total
[tab]
Copia no máximo TOTAL linhas. Se TOTAL for 0, copia todas
-O origem
[tab]
Começa a atribuir a MATRIZ no índice ORIGEM. A predefinição é 0
-s total
[tab]
Descarta as primeiras TOTAL linhas lidas
-t
[tab]
Remove um DELIM inicial de cada linha lida (predefinição é nova linha)
-u fd
[tab]
Lê linhas do descritor de ficheiro FD em vez da entrada padrão
-C retorno
[tab]
Avalia RETORNO cada vez que QUANTUM linhas são lidas
-c quantum
[tab]
Especifica o número de linhas lidas entre cada chamada a
[tab]
[tab]
[tab]
RETORNO
Argumentos:
ARRAY
[tab]
Nome de variável de matriz a usar para dados de ficheiro
Se -C for fornecido sem -c, a quantidade predefinida é 5000. Quando
RETORNO é avaliado, é fornecido o índice do elemento seguinte da
matriz a ser atribuído e a linha a ser atribuída a esse elemento
como argumentos adicionais.
Se não for fornecido com uma origem explícita, mapfile limpa MATRIZ antes
de lhe fazer atribuições.
Estado de saída:
Devolve sucesso a não ser que indique uma opção inválida, MATRIZ seja só
de leitura ou não seja uma matriz indexada.