Anterior Sumário Próximo OpenBASE! o Banco de Dados inteligente. Fale conosco!

AJOINS()

Propósito

Retornar o número de itens ou preencher vetores com o LAYOUT dos arquivos que podem ser lidos a partir do arquivo selecionado.

Sintaxe

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

Argumentos

<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.

Utilização

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.

Exemplos

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)

Consulte

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

Anterior Sumário Próximo OpenBASE! o Banco de Dados inteligente. Fale conosco!