Share via

ADATABASES( ) (Función)

  • Artículo

Incluye los nombres de todas las bases de datos abiertas, junto con sus rutas de acceso, en una matriz de variables.

ADATABASES(ArrayName)

Valores devueltos

Numeric

Parámetros

  • ArrayName
    Especifica el nombre de la matriz. Si la matriz que especifica no existe, Visual FoxPro la creará automáticamente. Si la matriz existe, pero no es suficientemente grande para dar cabida a toda la información de la base de datos, Visual FoxPro aumentará automáticamente el tamaño de la matriz para proporcionar espacio para la información. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño. Si la matriz existe y ADATABASES( ) devuelve 0 porque no ha encontrado bases de datos abiertas, la matriz permanecerá inalterada. Si la matriz no existe y ADATABASES( ) devuelve 0, la matriz no se creará.

Observaciones

Los nombres de todas las bases de datos abiertas en la sesión de datos actual se introducen en una matriz.

ADATABASES( ) crea una matriz bidimensional. La primera columna de la matriz contiene los nombres de las bases de datos abiertas y la segunda columna contiene las rutas de acceso a dichas bases de datos.

ADATABASES( ) devuelve el número de nombres de bases de datos (filas) de la matriz. Si no hay ninguna base de datos abierta, ADATABASES( ) devolverá 0 y no creará ninguna matriz.

Ejemplo

El ejemplo siguiente abre la base de datos testdata y utiliza ADATABASES( ) para crear una matriz llamada gaDatabase que contiene los nombres de todas las bases de datos abiertas.

SET PATH TO (HOME(2) + 'data\')     && Sets path to database
OPEN DATABASE testdata && Opens the database
CLEAR
? ADATABASES(gaDatabase)     && Creates an array of open databases
DISPLAY MEMORY LIKE gadatabase  && Displays the contents of the array
CLOSE DATABASES

Vea también

CREATE DATABASE | DISPLAY DATABASE | LIST DATABASE | MODIFY DATABASE | OPEN DATABASE