X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/d9ff0f91fbddae88286567cab74dcfb59c91fc0f..6f41c10973643552837c6bd38b23779e65a2eaa3:/include/wx/dir.h diff --git a/include/wx/dir.h b/include/wx/dir.h index 4c8a2368cb..0781b13c13 100644 --- a/include/wx/dir.h +++ b/include/wx/dir.h @@ -6,19 +6,17 @@ // 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__ - #pragma interface "dir.h" -#endif +#include "wx/longlong.h" +#include "wx/string.h" +#include "wx/filefn.h" // for wxS_DIR_DEFAULT -#ifndef WX_PRECOMP - #include "wx/string.h" -#endif +class WXDLLIMPEXP_FWD_BASE wxArrayString; // ---------------------------------------------------------------------------- // constants @@ -26,7 +24,7 @@ // these flags define what kind of filenames is included in the list of files // enumerated by GetFirst/GetNext -enum +enum wxDirFlags { wxDIR_FILES = 0x0001, // include files wxDIR_DIRS = 0x0002, // include directories @@ -49,29 +47,43 @@ enum wxDirTraverseResult // wxDirTraverser: helper class for wxDir::Traverse() // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxDirTraverser +class WXDLLIMPEXP_BASE wxDirTraverser { public: + /// a virtual dtor has been provided since this class has virtual members + virtual ~wxDirTraverser() { } // called for each file found by wxDir::Traverse() // - // return wxDIR_STOP or wxDIR_CONTINUE from here + // 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 tree + // + // 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 wxDir +class WXDLLIMPEXP_FWD_BASE wxDirData; + +class WXDLLIMPEXP_BASE wxDir { public: - // test for existence of a directory with the given name - static bool Exists(const wxString& dir); // ctors // ----- @@ -82,23 +94,28 @@ public: // opens the directory for enumeration, use IsOpened() to test success wxDir(const wxString& dir); - // dtor cleans up the associated ressources + // dtor cleans up the associated resources ~wxDir(); // open the directory for enumerating bool Open(const wxString& dir); - // returns TRUE if the directory was successfully opened + // 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; + // Same as GetName() but does include the trailing separator, unless the + // string is empty (only for invalid directories). + wxString GetNameWithSep() const; + + // file enumeration routines // ------------------------- // start enumerating all files matching filespec (or all files if it is - // empty) and flags, return TRUE on success + // empty) and flags, return true on success bool GetFirst(wxString *filename, const wxString& filespec = wxEmptyString, int flags = wxDIR_DEFAULT) const; @@ -107,12 +124,10 @@ public: bool GetNext(wxString *filename) const; // return true if this directory has any files in it - bool HasFiles(const wxString& spec = wxEmptyString) - { wxString s; return GetFirst(&s, spec, wxDIR_FILES | wxDIR_HIDDEN); } + bool HasFiles(const wxString& spec = wxEmptyString) const; // return true if this directory has any subdirectories - bool HasSubDirs(const wxString& spec = wxEmptyString) - { wxString s; return GetFirst(&s, spec, wxDIR_DIRS | wxDIR_HIDDEN); } + bool HasSubDirs(const wxString& spec = wxEmptyString) const; // enumerate all files in this directory and its subdirectories // @@ -128,10 +143,39 @@ public: const wxString& filespec = wxEmptyString, int flags = wxDIR_DEFAULT); + // check if there any files matching the given filespec under the given + // directory (i.e. searches recursively), return the file path if found or + // empty string otherwise + static wxString FindFirst(const wxString& dirname, + const wxString& filespec, + int flags = wxDIR_DEFAULT); + +#if wxUSE_LONGLONG + // returns the size of all directories recursively found in given path + static wxULongLong GetTotalSize(const wxString &dir, wxArrayString *filesSkipped = NULL); +#endif // wxUSE_LONGLONG + + + // static utilities for directory management + // (alias to wxFileName's functions for dirs) + // ----------------------------------------- + + // test for existence of a directory with the given name + static bool Exists(const wxString& dir); + + static bool Make(const wxString &dir, int perm = wxS_DIR_DEFAULT, + int flags = 0); + + static bool Remove(const wxString &dir, int flags = 0); + + private: - friend class WXDLLEXPORT wxDirData; + friend class wxDirData; wxDirData *m_data; + + wxDECLARE_NO_COPY_CLASS(wxDir); }; #endif // _WX_DIR_H_ +