Ler 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 arquivos FD se a opção -u é fornecida.
A variável ARQUIVOMAPA (MAPFILE) é a matriz padrão.
Opções:
-n contagem
[tab]Copia, no máximo, o número de linhas CONTAGEM. Se
[tab]CONTAGEM for zero, todas as linhas são copiadas.
-O origem
[tab]Começa a atribuir à MATRIZ no índice ORIGEM. O índice
[tab]padrão é 0.
-s contagem
[tab]Descarta a leitura do número de linhas CONTAGEM.
-t
[tab][tab]Remove o código de nova-linha de cada linha lida.
-u fd
[tab][tab]Lê linhas do descritor de arquivos FD em vez de
[tab]ler da entrada padrão.
-C retornochamada
[tab]Avalia RETORNOCHAMADA toda vez que uma
[tab]QUANTIDADE de linhas é lida.
-c quantidade
[tab]Especifica o número de linhas lidas entre cada
[tab]RETORNOCHAMADA.
Argumentos:
MATRIZ
[tab][tab]Nome da variável de matriz usada para guardar dados.
Se -C é fornecida sem -c, a quantidade padrão é 5000. Quando
RETORNOCHAMADA é avaliado, é fornecido o índice do próximo
elemento da matriz a ser atribuído e a linha a ser atribuída
àquele elemento como argumentos adicionais.
Se não for fornecido com uma origem explícita, ARQUIVOMAPA irá
apagar o conteúdo da MATRIZ antes que elementos lhe sejam
atribuídos.
Status de saída:
Retorna bem-sucedido a menos que uma opção inválida seja dada,
ou que MATRIZ seja somente-leitura ou não seja uma matriz
indexada.
