DBF ALIAS()

From Recital Documentation Wiki
Revision as of 16:55, 15 December 2009 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

PURPOSE

Return alias name


SYNONYM

api_dbf_alias()


SYNOPSIS

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


DESCRIPTION

The DBF_ALIAS() function will return will return the alias name of the currently selected workarea as an upper case character string, or a NULL if no database is in use.


EXAMPLE

The following example returns the alias name of the current workarea, or executes the command specified in the first parameter if no database is open.


#include <stdio.h>
#include "dbapi.h"
 
dbapi_dbf_alias()
{
    char	*alias;
 
    alias = DBF_ALIAS();
 
    if ( alias == NULL) {
       COMMAND(_parc(1) );
       _retc("");
    } else {
       _retc( alias );
    }
}


SEE ALSO

DBF_DBF(), DBF_FMT(), DBF_INDEXKEY(), DBF_INDEXORDER(), DBF_ISEXCLUSIVE(), DBF_ISREADONLY(), DBF_NDX(), DBF_SELECT(), DBF_USED()