#ifndef _WX_DIR_H_
#define _WX_DIR_H_
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
- #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_BASE wxArrayString;
+class WXDLLIMPEXP_FWD_BASE wxArrayString;
// ----------------------------------------------------------------------------
// constants
// 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
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 (wxDIR_IGNORE doesn't
virtual wxDirTraverseResult OnDir(const wxString& dirname) = 0;
// called for each directory which we couldn't open during our traversal
- // of the directory tyree
+ // 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
// wxDir: portable equivalent of {open/read/close}dir functions
// ----------------------------------------------------------------------------
-class WXDLLIMPEXP_BASE wxDirData;
+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
// -----
// 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
// get the full name of the directory (without '/' at the end)
wxString GetName() const;
+
// file enumeration routines
// -------------------------
bool GetNext(wxString *filename) const;
// return true if this directory has any files in it
- bool HasFiles(const wxString& spec = wxEmptyString);
+ bool HasFiles(const wxString& spec = wxEmptyString) const;
// return true if this directory has any subdirectories
- bool HasSubDirs(const wxString& spec = wxEmptyString);
+ bool HasSubDirs(const wxString& spec = wxEmptyString) const;
// enumerate all files in this directory and its subdirectories
//
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 wxDirData;
wxDirData *m_data;
- DECLARE_NO_COPY_CLASS(wxDir)
+ wxDECLARE_NO_COPY_CLASS(wxDir);
};
#endif // _WX_DIR_H_