Bt_FMap() Function

 

<< Click to Display Table of Contents >>

Navigation:  Support Functions >

 

Bt_FMap() Function

 

Previous pageReturn to chapter overviewNext page

 

Purpose

 

 

Get Btrieve file name associated with an Dictionary table

 

 

 

Prototype

 

 

FUNCTION Bt_FMap ( cPath AS STRING, cTable AS STRING )  AS STRING PASCAL

 

 

 

Argument(s)

 

 

<cPath>is the location of the FILE.DDF file
<cTable>is the name of an Btrieve table.

 

 

 

 

Return

 

 

Name of the Btrieve file associated with an Dictionary . If the Btrieve table is not defined in the data dictionary, then BT_FMAP() returns a null string.

 

 

 

Description

 

 

BT_FMAP(<cTable>) consults the appropriate entry in the data dictionary and returns the name of the Btrieve file associated with the table specified in <cTable>. No effort is made to see that the Btrieve file actually exists on disk.

 

 

 

Example(s)

 

 

* Name of Btrieve file associated

* with Appointments table

? BT_FMAP('appointments')

PATAPP.DTA

 

 

 

 

See Also

 

 

BT_ATABLES()