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

USE

Propósito

Abrir um arquivo.

Sintaxe

USE <arq.ban>

USE <microesquema>

USE *

<microesquema>

ENDUSE

USE <biblioteca> (<membro>)

Argumentos

<arq.ban>         representa o nome de um arquivo do banco de dados aberto pelo último comando DATABASE.

<microesquema>     representa o nome de um arquivo no diretório corrente onde foi feita a descrição de um arquivo externo.

USE * ... ENDUSE     determina que a descrição do micro-esquema será feita na própria fonte. ENDUSE termina a descrição do arquivo.

<biblioteca>         representa o nome de um arquivo no diretório corrente, onde foram feitas várias definições de arquivos externos.

<membro>         representa o nome do micro-esquema definido dentro de uma biblioteca.

Utilização

Abre um arquivo, seja ele de que tipo for e o deixa disponível para uso, até que um outro arquivo seja aberto ou selecionado.

O comando USE é um comando muito utilizado na linguagem.

Embora tenha uma sintaxe parecida para todos os casos funciona de forma distinta para arquivos do banco de dados e para arquivos externos. Para se abrir um arquivo externo existem várias formas de utilização uma para cada caso, dependendo da forma como foi definida sua aplicação. Os itens de um arquivo externo são declarados em memória como variáveis locais, portanto todas as variáveis de um arquivo externo ficam disponíveis em memória.

Pode-se determinar uma área de trabalho para um arquivo através do comando SELECT.

Em uma mesma fonte podem ser utilizados arquivos de banco de dados e arquivos externos desde que seus nomes sejam diferentes, pois o comando USE primeiro verifica no dicionário de dados a existência do arquivo e depois pesquisa o diretório corrente a procura do micro-esquema.

Exemplo

O exemplo a seguir mostra-nos como definir um arquivo externo dentro do código fonte do programa.

SELECT x

USE *    && Inicia a declaração de um arquivo externo.

agenda I LEN(112)

telefone    n14 KEY

ramal    u05

nome    u35

endereco    u50

aniversario    u08

ENDUSE    && Termina a declaração

O exemplo a seguir mostra-nos como abrir um arquivo de um banco de dados, determinando uma área de trabalho para este.

DATABASE bdemp1 33 a 2

SELECT a

USE tab_func

LOCATE

O exemplo a seguir mostra-nos como abrir um arquivo externo, através de micro-esquema definido no diretório corrente. Observe durante a compilação a declaração dos itens.

SELECT a

USE usuarios.d

LOCATE

O exemplo a seguir mostra-nos como utilizar um arquivo externo que foi declarado dentro de uma biblioteca de micro-esquemas.

USE bibext.d (agendatel)

LOCATE FOR numero = 05122217455

DO WHILE FOUND( )

  ? nome

ENDDO

Consulte

$FILES, CLOSE FILE, DATABASE, RESTORE, SAVE, SELECT, AFILES( ) e AJOINS( ).

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