AFIELDS()

• Propósito
• Sintaxe
• Argumentos
• Utilização
• Exemplos
• Consulte

Propósito

Retornar o número de itens ou preencher vetores com as características do arquivo selecionado.

Sintaxe

AFIELDS ([<vet.C1>[, [<vet.C2>[, [<vet.N1>[, <vet.N2>]]]])

Argumentos

<vet.C1>	representa o nome do vetor que será preenchido com o nome dos itens do arquivo. Deve ter no mínimo 12 caracteres.
<vet.C2>	representa o nome do vetor que será preenchido com o tipo dos itens do arquivo. Deve ter no mínimo 1 caracter.
<vet.N1>	representa o nome do vetor que será preenchido com o tamanho dos itens do arquivo.
<vet.N2>	representa o nome do vetor que será preenchido com o número de casas decimais dos itens numéricos do arquivo.

Utilização

Retorna a quantidade de itens do arquivo selecionado preenchendo, opcionalmente, vetores com a característica do registro do arquivo de banco de dados.

Quando utilizada sem argumentos, retorna o número de itens do arquivo.

Os vetores devem ser declarados com o número de elementos igual ao número de itens do arquivo.

Exemplos

O exemplo a seguir mostra-nos como declarar vetores com o número de elementos igual ao número de itens do registro.

USE tab_func

qtd_item = AFIELDS()     && Retorna o número de itens do registro

DECLARE vet_nom[qtd_item] = SPACE(12)

DECLARE vet_tip[qtd_item] = " "

* Exibe a quantidade de itens (qtd_item) e preenche os 

* vetores

? AFIELDS(vet_nom, vet_tip)

Consulte

DECLARE, ACHOICE(), ACOPY(), AFILL(), AFILES(), AJOINS(), AKEYS(), AINS(), ALEN() e ASCAN().