Click here to Skip to main content
15,867,453 members
Articles / Desktop Programming / MFC
Article

CFileFinder - Extend the functionality of CFileFind MFC class

Rate me:
Please Sign up or sign in to vote.
4.89/5 (47 votes)
15 Aug 20024 min read 365.5K   6.1K   103   58
Search for files by name, size, date, text contents. The search can be performed in a single folder or including it's subfolders.

Sample Image - image.gif

Introduction

CFileFinder uses CFileFind to perform a file search starting from a directory and including optionally it's subdirectories in the search.

  • A list of file paths is mantained internally.
  • If we make use of the callback mechanism, new found file paths can be obtained immediatly.
  • The class allows not only searches based on a file mask but also on the file size, file dates, text contents and file attributes.

Class methods

FindFiles

int FindFiles(LPCTSTR szBaseFolder, LPCTSTR szFileMask, BOOL bSubFolders = FALSE)

Search for files which match the mask szFileMask. This file mask can include one or more wildcard characters (* and ?)

Find

int Find(CFileFinder::CFindOpts &opts)

Find files matching the conditions established in the CFindOpts class parameter (See explanation of CFindOpts below)

FindTextInFile

BOOL FindTextInFile(LPCTSTR szFile, LPCTSTR szText)

Return TRUE if the text szText was found in the file szFile. It's internally used by the Find method. It's declared public to allow applications make use of this functionality.

GetFileCount

int GetFileCount()

Return the count of items found up to the moment the call is performed or the total of files found in the last Find or FindFiles operation.

GetFilePath

CPath GetFilePath(int nIndex)

Return a CPath object with the required file index path. In the CPath class there are two useful operators defined: operator LPCTSTR () and operator = (LPCTSTR szPath) which allows, for instance, direct assign from and to a CString object.

// ...

CString str1("c:\\temp\\list.txt"), str2;
CPath path;

path = str1;
str2 = path;

// at this point, str2 contains the 
// string "c:\temp\list.txt"

For more information about the CPath class see the related article.

FindPathItem

int FindPathItem(LPCTSTR szPath)

Return the index of the file whose path matches szPath or -1 if the file is not in the list.

RemoveAt

void RemoveAt(int nIndex)

Remove item at nIndex position.

RemoveAll

void RemoveAll()

Remove all items from the list.

SetCallback

void SetCallback(FILEFINDERPROC pFileFinderProc, void *pCustomParam)

Set the callback function pointer used by the search process from the Find method. The callback function is defined in the following way:

void FileFinderProc(CFileFinder *pFinder, 
        DWORD   dwCode, void    *pCustomParam);
  • pFinder .- The calling CFileFinder object
  • dwCode .- The calling reason:
    • FF_FOUND - A new file was found
    • FF_DISCARDED - A file matched the file mask but not all the conditions
    • FF_FOLDER - The search in a new folder started
    • FF_FINDTEXT - Searching for text in a file. This gives our applications the chance to process messages while searching text on big files.
  • pCustomParam .- The same pointer passed to the function SetCallback.

The name of the new found file, when the dwCode parameter is FF_FOUND, can be obtained with a call like this:

pFinder->GetFilePath(pFinder->GetFileCount() - 1);

StopSearch

void StopSearch()

If this method is called from within the FileFinderProc callback function, the find process is stopped but the list of files is not deleted.

GetSearchingFolder

LPCTSTR GetSearchingFolder()

Calling this method from FileFinderProc when the dwCode parameter is FF_FOLDER, the name of the folder being searched is retrieved.

The CFindOpts class

This class help us configuring the search to be carried out. Its methods are simple helpers to set the class members easily for the most common searches.

Class members explained

  • dwOptionsFlags - This flags indicate the constrains to be taken into account apart from the file mask
    • FIND_SIZE - If the size of a file that matches the file mask is not in the range [nMinSize, nMaxSize], the file is discarded.
    • FIND_DATEMODIFIED - The last modified file date must be in the range [tMinModified, tMaxModified]
    • FIND_DATECREATED - The creation file date must be in the range [tMinCreated, tMaxCreated]
    • FIND_DATEACCESSED - The last accessed file date must be in the range [tMinAccessed, tMaxAccessed]
    • FIND_ATTRIBUTES - The attributes of the file found must match the dwFileAttributes member (this member can take the same values as the one with the same name in WIN32_FIND_DATA struct)
    • FIND_TEXT - The file has to contain the text specified in sFindText
  • sBaseFolder - The search root folder
  • sFileMask - The file mask (e.g.: "*.txt", "fi?e.*")
  • sFindText - Text that must be found in a file to consider it a match. Note that the flag FIND_TEXT must be added to dwOptionsFlags. If sFindText is empty the text search is not performed even if the FIND_TEXT is set
  • bSubfolders - A boolean indicating whether the search must include subdirectories or not
  • nMinSize / nMinSize - The file size range when the FIND_SIZE flag is set
  • tMinCreated / tMaxCreated - The file creation date range when the FIND_DATECREATED flag is set
  • tMinModified / tMaxModified - The file last modified range when the FIND_DATEMODIFIED flag is set
  • tMinAccessed / tMaxAccessed - The file last accessed range when the FIND_DATEACCESSED flag is set
  • dwFileAttributes - The file attributes when the FIND_ATTRIBUTES is set

Class methods

void Reset()

  • empty sBaseFolder
  • set sFileMask to "*.*"
  • set bSubFolders to FALSE
  • set nMinSize, nMaxSize to 0
  • reset dwFileAttributes and dwOptionsFlags flags
  • set all date members to the current date and time

void FindNormalFiles()

  • add normal files (FILE_ATTRIBUTE_ARCHIVE) to the search
  • add FIND_ATTRIBUTES to dwOptionsFlags

void FindAllFiles()

  • add all files attributes to the search, even hidden files, system files.
  • add FIND_ATTRIBUTES to dwOptionsFlags

void FindDirectories()

  • add directories to the search (directories have an own attribute: FILE_ATTRIBUTE_DIRECTORY)
  • add FIND_ATTRIBUTES to dwOptionsFlags

void FindText(LPCTSTR szText)

  • set sFindText to szText
  • add FIND_TEXT to dwOptionsFlags

Notes

The CPath class requires linking with the library shlwapi.lib

Sample code can be found in the source of the sample application provided with this article

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer (Senior)
Spain Spain
I studied Telecommunication with spezialization in Sound & Image. I was always very interested in programming at university as well and that is how I earn a living.

Since some years ago, I am also succesfully involved in software architecture and design.

Comments and Discussions

 
GeneralRe: Little bug in Path.cpp Pin
Samuel Gonzalo8-Aug-02 21:21
Samuel Gonzalo8-Aug-02 21:21 
GeneralRe: Little bug in Path.cpp Pin
Anthony_Yio28-Nov-04 21:14
Anthony_Yio28-Nov-04 21:14 
GeneralSplendid! Pin
DCUtility7-Aug-02 7:03
professionalDCUtility7-Aug-02 7:03 
GeneralVery usefull Pin
Roger Allen7-Aug-02 6:23
Roger Allen7-Aug-02 6:23 
GeneralError in VC6 Pin
Michael A. Barnhart7-Aug-02 4:09
Michael A. Barnhart7-Aug-02 4:09 
GeneralRe: Error in VC6 Pin
Paul Selormey7-Aug-02 20:39
Paul Selormey7-Aug-02 20:39 
GeneralRe: Error in VC6 Pin
Michael A. Barnhart8-Aug-02 0:36
Michael A. Barnhart8-Aug-02 0:36 
GeneralNice! Pin
Ravi Bhavnani7-Aug-02 2:51
professionalRavi Bhavnani7-Aug-02 2:51 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.