DBF DBF()

PURPOSE

Return the database name

SYNONYM

api_dbf_dbf()

SYNOPSIS

#include "dbapi.h"
 
char	*DBF_DBF()
 
<input parameters>
none
 
<output parameters>
none

DESCRIPTION

The DBF_DBF() function will return the name of the currently selected database as character string, or a NULL if none is active.

Recital provides you with 100 workareas by default, however, up to 256 may be set with the DB_MAXWKA environment variable / symbol.

The database name is returned in lower case including the file extension.

EXAMPLE

The following example returns the name of the database in the current workarea.

#include "dbapi.h"
 
dbapi_dbf_dbf()
{
    char 	*dbfname()
 
    dbfname = DBF_DBF();
 
    _retc( dbfname );
}

SEE ALSO

DBF_ALIAS(), DBF_FMT(), DBF_INDEXKEY(), DBF_INDEXORDER(), DBF_ISEXCLUSIVE(), DBF_ISREADONLY(), DBF_NDX(),DBF_SELECT(), DBF_USED(), FIELD_COUNT(), FIELD_LOOKUP()