Difference between revisions of "DBF DBF()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
Line 23: Line 23:
 
==DESCRIPTION==
 
==DESCRIPTION==
 
The DBF_DBF() function will return the name of the currently selected database as character string, or a NULL if none is active.
 
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.
 
The database name is returned in lower case including the file extension.

Latest revision as of 16:55, 15 December 2009

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.

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()