X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1944c6bdd0daa0a9793e9a57f0800c169fec958b..ef094fa075bc56bcbc33b12159c395ea28afda3b:/include/wx/dir.h?ds=sidebyside diff --git a/include/wx/dir.h b/include/wx/dir.h index f8b0b67f3c..e0b69e7ea3 100644 --- a/include/wx/dir.h +++ b/include/wx/dir.h @@ -6,13 +6,13 @@ // Created: 08.12.99 // RCS-ID: $Id$ // Copyright: (c) 1999 Vadim Zeitlin -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// #ifndef _WX_DIR_H_ #define _WX_DIR_H_ -#ifdef __GNUG__ +#if defined(__GNUG__) && !defined(__APPLE__) #pragma interface "dir.h" #endif @@ -37,10 +37,50 @@ enum wxDIR_DEFAULT = wxDIR_FILES | wxDIR_DIRS | wxDIR_HIDDEN }; +// these constants are possible return value of wxDirTraverser::OnDir() +enum wxDirTraverseResult +{ + wxDIR_IGNORE = -1, // ignore this directory but continue with others + wxDIR_STOP, // stop traversing + wxDIR_CONTINUE // continue into this directory +}; + +// ---------------------------------------------------------------------------- +// wxDirTraverser: helper class for wxDir::Traverse() +// ---------------------------------------------------------------------------- + +class WXDLLEXPORT wxDirTraverser +{ +public: + // called for each file found by wxDir::Traverse() + // + // return wxDIR_STOP or wxDIR_CONTINUE from here (wxDIR_IGNORE doesn't + // make sense) + virtual wxDirTraverseResult OnFile(const wxString& filename) = 0; + + // called for each directory found by wxDir::Traverse() + // + // return one of the enum elements defined above + virtual wxDirTraverseResult OnDir(const wxString& dirname) = 0; + + // called for each directory which we couldn't open during our traversal + // of the directory tyree + // + // this method can also return either wxDIR_STOP, wxDIR_IGNORE or + // wxDIR_CONTINUE but the latter is treated specially: it means to retry + // opening the directory and so may lead to infinite loop if it is + // returned unconditionally, be careful with this! + // + // the base class version always returns wxDIR_IGNORE + virtual wxDirTraverseResult OnOpenError(const wxString& dirname); +}; + // ---------------------------------------------------------------------------- // wxDir: portable equivalent of {open/read/close}dir functions // ---------------------------------------------------------------------------- +class WXDLLEXPORT wxDirData; + class WXDLLEXPORT wxDir { public: @@ -65,6 +105,9 @@ public: // returns TRUE if the directory was successfully opened bool IsOpened() const; + // get the full name of the directory (without '/' at the end) + wxString GetName() const; + // file enumeration routines // ------------------------- @@ -74,36 +117,35 @@ public: const wxString& filespec = wxEmptyString, int flags = wxDIR_DEFAULT) const; - // get next file in the enumeration started with either GetFirst() or - // GetFirstNormal() + // get next file in the enumeration started with GetFirst() bool GetNext(wxString *filename) const; - // TODO using scandir() when available later, emulating it otherwise -#if 0 - // get all files in the directory into an array, return TRUE on success + // return true if this directory has any files in it + bool HasFiles(const wxString& spec = wxEmptyString); + + // return true if this directory has any subdirectories + bool HasSubDirs(const wxString& spec = wxEmptyString); + + // enumerate all files in this directory and its subdirectories // - // this function uses Select() function to select the files - // unless the filespec is explicitly given and Compare() function to sort - // them - bool Read(wxArrayString& filenames, - const wxString& filespec = wxEmptyString) const; - -protected: - // this function is called by Read() if filespec is not specified in - // Read(): it should return TRUE if the file matches our selection - // criteria and FALSE otherwise - virtual bool Select(const wxChar* filename); - - // This function is called by Read() to sort the array: it should return - // -1, 0 or +1 if the first file is less than, equal to or greater than - // the second. The base class version does - virtual int Compare(const wxChar *filename1, const wxChar *filename2); -#endif // 0 + // return the number of files found + size_t Traverse(wxDirTraverser& sink, + const wxString& filespec = wxEmptyString, + int flags = wxDIR_DEFAULT) const; + + // simplest version of Traverse(): get the names of all files under this + // directory into filenames array, return the number of files + static size_t GetAllFiles(const wxString& dirname, + wxArrayString *files, + const wxString& filespec = wxEmptyString, + int flags = wxDIR_DEFAULT); private: friend class WXDLLEXPORT wxDirData; wxDirData *m_data; + + DECLARE_NO_COPY_CLASS(wxDir) }; #endif // _WX_DIR_H_