AKEYS()

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

Propósito

Retornar o número de chaves e preencher vetores com as características destes itens.

Sintaxe

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

Argumentos

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

Utilização

Retorna a quantidade de chaves do arquivo selecionado, preenchendo, opcionalmente, vetores com as características das chaves do registro de um arquivo de banco de dados. Quando utilizada sem argumentos, retorna o número de chaves do arquivo.

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

Exemplos

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

USE tab_func

qtd_item = AKEYS ()     && Retorna o numero de chaves do registro

DECLARE vet_nom[qtd_item] = SPACE(12)

DECLARE vet_tip[qtd_item] = " "

* Exibe a quantidade de chaves (qtd_item) e preenche 

* vetores

? AKEYS (vet_nom, vet_tip)

Consulte

DECLARE, ACHOICE(), ACOPY(), ADEL(), AFIELDS(), AFILES(), AFILL(), AJOINS(), ALEN() e ASCAN().