Functions and Directives Functions and Directives

Function FileSeek() Foundation

Seeks files specified by a file mask and file attribute

Syntax
FileSeek( [<cFileMask>]      , ;
          [<nFileAttributes>], ;  // Default:  FA_NORMAL
          [<lExact>]           ;  // Default: .F.
        ) --> cFileName
Return

Returns a filename matching the specified parameters or a null string ("") if no file is found.

Description

<cFileMask>

This is a string specifying the file(s) to seek. It may contain a fully qualified filename or "wild cards" (eg: "C:\DATA\*.NTX" ). The parameter must be specified with the first call. Any subsequent calls to FileSeek() without passing parameters return the next filename which matches the initial parameters.

<nFileAttributes>

File attributes are numeric values corresponding to #define constants found in XBTDISK.CH

FA_NORMAL

FA_READONLY

FA_HIDDEN

FA_SYSTEM

FA_DIRECTORY

FA_ARCHIVE

Multiple attributes are specified by adding the corresponding constants.

<lExact>

To get exact matches when searching for files with the attributes Normal, Achive, and Read Only this parameter must be set .T.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.