Retornar o número de itens ou preencher vetores com as características dos arquivos que podem ser lidos a partir do arquivo selecionado.
AJOINS ([<vet.C1>[, [<vet.C2>[, [<vet.N1>[, <vet.N2>]]]])
|
<vet.C1> |
representa o nome do vetor que será preenchido com o nome dos itens dos arquivos. Deve ter no mínimo 12 caracteres. |
|
<vet.C2> |
representa o nome do vetor que será preenchido com o tipo dos itens dos arquivos. Deve ter no mínimo 1 caracter. |
|
<vet.N1> |
representa o nome do vetor que será preenchido com o tamanho dos itens dos arquivos. |
|
<vet.N2> |
representa o nome do vetor que será preenchido com o número de casas decimais dos itens numéricos dos arquivos. |
Retorna a quantidade de itens que podem ser lidos automaticamente a partir do arquivo selecionado, preenchendo, opcionalmente, vetores com as características destes itens.
Os itens retornados pertencem aos arquivos que mantenham relação com o arquivo selecionado. Isto é, arquivos que possibilitem a leitura de seus itens sem a necessidade de um novo comando de leitura.
Quando utilizada sem argumentos, retorna o número de itens que podem ser lidos automaticamente.
Os vetores devem ser declarados com o número de elementos igual ao número de itens que permitam junções com o arquivo selecionado.
O exemplo a seguir mostra-nos como declarar vetores com o número de elementos igual a número de itens lidos a partir do arquivo selecionado.
USE tab_func
qtd_item = AJOINS () && Retorna o numero de itens
DECLARE vet_nom[qtd_item] = SPACE(12)
DECLARE vet_tip[qtd_item] = " "
* Exibe a quantidade de itens (qtd_item) e preenche os
* vetores
* com a características dos itens
? AJOINS (vet_nom, vet_tip)
DECLARE, ACHOICE(), ACOPY(), ADEL(), AFIELDS(), AFILES(), AFILL(), AKEYS(), ALEN() e ASCAN().