]> git.saurik.com Git - wxWidgets.git/blob - include/wx/dir.h
Added simplistic makefile/project files for wxWinCE.
[wxWidgets.git] / include / wx / dir.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/dir.h
3 // Purpose: wxDir is a class for enumerating the files in a directory
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 08.12.99
7 // RCS-ID: $Id$
8 // Copyright: (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
9 // Licence: wxWindows license
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_DIR_H_
13 #define _WX_DIR_H_
14
15 #if defined(__GNUG__) && !defined(__APPLE__)
16 #pragma interface "dir.h"
17 #endif
18
19 #ifndef WX_PRECOMP
20 #include "wx/string.h"
21 #endif
22
23 // ----------------------------------------------------------------------------
24 // constants
25 // ----------------------------------------------------------------------------
26
27 // these flags define what kind of filenames is included in the list of files
28 // enumerated by GetFirst/GetNext
29 enum
30 {
31 wxDIR_FILES = 0x0001, // include files
32 wxDIR_DIRS = 0x0002, // include directories
33 wxDIR_HIDDEN = 0x0004, // include hidden files
34 wxDIR_DOTDOT = 0x0008, // include '.' and '..'
35
36 // by default, enumerate everything except '.' and '..'
37 wxDIR_DEFAULT = wxDIR_FILES | wxDIR_DIRS | wxDIR_HIDDEN
38 };
39
40 // these constants are possible return value of wxDirTraverser::OnDir()
41 enum wxDirTraverseResult
42 {
43 wxDIR_IGNORE = -1, // ignore this directory but continue with others
44 wxDIR_STOP, // stop traversing
45 wxDIR_CONTINUE // continue into this directory
46 };
47
48 // ----------------------------------------------------------------------------
49 // wxDirTraverser: helper class for wxDir::Traverse()
50 // ----------------------------------------------------------------------------
51
52 class WXDLLEXPORT wxDirTraverser
53 {
54 public:
55 // called for each file found by wxDir::Traverse()
56 //
57 // return wxDIR_STOP or wxDIR_CONTINUE from here
58 virtual wxDirTraverseResult OnFile(const wxString& filename) = 0;
59
60 // called for each directory found by wxDir::Traverse()
61 //
62 // return one of the enum elements defined above
63 virtual wxDirTraverseResult OnDir(const wxString& dirname) = 0;
64 };
65
66 // ----------------------------------------------------------------------------
67 // wxDir: portable equivalent of {open/read/close}dir functions
68 // ----------------------------------------------------------------------------
69
70 class WXDLLEXPORT wxDirData;
71
72 class WXDLLEXPORT wxDir
73 {
74 public:
75 // test for existence of a directory with the given name
76 static bool Exists(const wxString& dir);
77
78 // ctors
79 // -----
80
81 // default, use Open()
82 wxDir() { m_data = NULL; }
83
84 // opens the directory for enumeration, use IsOpened() to test success
85 wxDir(const wxString& dir);
86
87 // dtor cleans up the associated ressources
88 ~wxDir();
89
90 // open the directory for enumerating
91 bool Open(const wxString& dir);
92
93 // returns TRUE if the directory was successfully opened
94 bool IsOpened() const;
95
96 // get the full name of the directory (without '/' at the end)
97 wxString GetName() const;
98
99 // file enumeration routines
100 // -------------------------
101
102 // start enumerating all files matching filespec (or all files if it is
103 // empty) and flags, return TRUE on success
104 bool GetFirst(wxString *filename,
105 const wxString& filespec = wxEmptyString,
106 int flags = wxDIR_DEFAULT) const;
107
108 // get next file in the enumeration started with GetFirst()
109 bool GetNext(wxString *filename) const;
110
111 // return true if this directory has any files in it
112 bool HasFiles(const wxString& spec = wxEmptyString);
113
114 // return true if this directory has any subdirectories
115 bool HasSubDirs(const wxString& spec = wxEmptyString);
116
117 // enumerate all files in this directory and its subdirectories
118 //
119 // return the number of files found
120 size_t Traverse(wxDirTraverser& sink,
121 const wxString& filespec = wxEmptyString,
122 int flags = wxDIR_DEFAULT) const;
123
124 // simplest version of Traverse(): get the names of all files under this
125 // directory into filenames array, return the number of files
126 static size_t GetAllFiles(const wxString& dirname,
127 wxArrayString *files,
128 const wxString& filespec = wxEmptyString,
129 int flags = wxDIR_DEFAULT);
130
131 private:
132 friend class WXDLLEXPORT wxDirData;
133
134 wxDirData *m_data;
135 };
136
137 #endif // _WX_DIR_H_