FindFiles

 

Description

List all files in specified folder with specified file extension, or with file name with wild characters.

Syntax

BOOL FindFiles( StringArray & saResult, LPCSTR lpcszPath, LPCSTR lpcszFileOrExt = NULL, bool bCheckExist = false, int nRecurseLevel = 0 )

Parameters

saResult
[output] the referrence of string array will receive the finding results
lpcszPath
[input] the file path to search for files
lpcszFileOrExt
[input] the file extension to search for, or file name with extension. Wildcard characters allowed. NULL means find all files.
bCheckExist
[input] true will check the given saReult to see if the file is already in that array
nRecurseLevel
[input] level of recursive. If zero then do not recursive, if -1 then recursive all.

Return

Returns TRUE for success, otherwise FALSE.

Examples

EX1

void FindFiles_ex1()
{
    //1. path and extension supplied
    string strExePath = GetAppPath();
    StringArray saResult;
    FindFiles(saResult, strExePath, "otw");
    int ii;
    printf("FindFiles(saResult, strExePath, \"otw\")\n");
    for (ii = 0;ii<saResult.GetSize();ii++)
        {
        out_str(saResult[ii]);
        }
    //2. just path supplied, find all files.
    FindFiles(saResult, strExePath, "*.*");
    printf("FindFiles(saResult, strExePath, \"*.*\")\n");
    for (ii = 0;ii<saResult.GetSize();ii++)
        {
        out_str(saResult[ii]);
        }
    // the same as 2
    FindFiles(saResult, strExePath);
    printf("FindFiles(saResult, strExePath)\n");
    for (ii = 0;ii<saResult.GetSize();ii++)
        {
        out_str(saResult[ii]);
        }
    //3. strWildNameWithExt contains filename (with wildchar(s)), and extension.
    string strWildNameWithExt = "a*c?e.ext";
    FindFiles(saResult, strExePath, strWildNameWithExt);
    printf("FindFiles(saResult, strExePath, strWildNameWithExt)\n");
    for (ii = 0;ii<saResult.GetSize();ii++)
        {
        out_str(saResult[ii]);
        }
}

Remark

See Also

header to Include

origin.h

Reference