Difference between revisions of "DBF()"

From Lianjapedia
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Function to return the table file name
 
Function to return the table file name
 
  
 
==Syntax==
 
==Syntax==
 
DBF([<workarea | alias>])
 
DBF([<workarea | alias>])
 
  
 
==See Also==
 
==See Also==
[[ALIAS()]], [[FCOUNT()]], [[FIELD()]], [[FILTER()]], [[FMT()]], [[INDEXKEY()]], [[NDX()]], [[READVAR()]], [[SELECT()]], [[SET COMPATIBLE]], [[SET FILECASE]], [[SET FULLPATH]], [[WORKAREA()]]
+
[[ALIAS()]], [[DBD()]], [[FCOUNT()]], [[FIELD()]], [[FILTER()]], [[INDEXKEY()]], [[NDX()]], [[SELECT()]], [[SET FILECASE]], [[SET FULLPATH]], [[WORKAREA()]]
 
+
  
 
==Description==
 
==Description==
 
The DBF() function returns the file name of the currently active table or a null string if none is active.  If the optional <workarea | alias> is specified, then the function will return the table name from the specified workarea.  The DBF() function returns a character string in lower case, including the file extension.  If the command FULLPATH is set ON, then the DBF() function will return the node, disk and directory name with the table name.
 
The DBF() function returns the file name of the currently active table or a null string if none is active.  If the optional <workarea | alias> is specified, then the function will return the table name from the specified workarea.  The DBF() function returns a character string in lower case, including the file extension.  If the command FULLPATH is set ON, then the DBF() function will return the node, disk and directory name with the table name.
 
If SET COMPATIBLE is set to FOXPRO or VFP the DBF() return value format differs in the following way: if SET FULLPATH is ON the full path to the database table is returned, if SET FILECASE is OFF then the return value is converted to upper case (Windows only).
 
 
  
 
==Example==
 
==Example==
Line 33: Line 27:
 
</code>
 
</code>
  
 
==Products==
 
Recital Server, Recital
 
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:Cursor Functions]]

Latest revision as of 13:44, 1 March 2019

Purpose

Function to return the table file name

Syntax

DBF([<workarea | alias>])

See Also

ALIAS(), DBD(), FCOUNT(), FIELD(), FILTER(), INDEXKEY(), NDX(), SELECT(), SET FILECASE, SET FULLPATH, WORKAREA()

Description

The DBF() function returns the file name of the currently active table or a null string if none is active. If the optional <workarea | alias> is specified, then the function will return the table name from the specified workarea. The DBF() function returns a character string in lower case, including the file extension. If the command FULLPATH is set ON, then the DBF() function will return the node, disk and directory name with the table name.

Example

use patrons
? dbf()
patrons.dbf
dbfname = dbf()
? dbfname
patrons.dbf
? len(dbfname)
        11
use
dbfname = dbf()
? len(dbfname)
         0