Click above to get retro games delivered to your door ever month!

N_FMAP( <nHandle> )


Parameters

<nHandle>
File handle number.


Returns

Filespec associated with handle. If the specified handle is not open, 
or if an invalid handle is given, a null string is returned.


Description

The lowest file handle number usable by your application is 5, since 
DOS reserves handle 0-4 for its own use.

The filename returned by N_FMAP() will appear exactly as it was 
specified in the command that created it. Remember, however, that many 
Clipper commands add a default extension (NTX, DBF, and so on) if you 
do not specify one.


Examples

CLOSE DATA
USE CUSTFILE INDEX CUSTNO
? N_FMAP(5)
CUSTFILE.DBF

? N_FMAP(6)
CUSTFILE.NTX

// Locate the handle for a specific filename 
FUNCTION GetHandle( cFilename )
  LOCAL k

  FOR k = 5 TO N_HANDLES(-1)  // Can't be handle 0-4
     IF UPPER(N_FMAP(k)) == UPPER(cFilename)
       RETURN k               // Handle #
     ENDIF
  NEXT
RETURN 0                      // Not found