]> git.ipfire.org Git - thirdparty/gcc.git/blame - libstdc++-v3/include/experimental/fs_dir.h
Implement N4100 File System TS
[thirdparty/gcc.git] / libstdc++-v3 / include / experimental / fs_dir.h
CommitLineData
0ca7ba9a
JW
1// Filesystem directory utilities -*- C++ -*-
2
3// Copyright (C) 2014-2015 Free Software Foundation, Inc.
4//
5// This file is part of the GNU ISO C++ Library. This library is free
6// software; you can redistribute it and/or modify it under the
7// terms of the GNU General Public License as published by the
8// Free Software Foundation; either version 3, or (at your option)
9// any later version.
10
11// This library is distributed in the hope that it will be useful,
12// but WITHOUT ANY WARRANTY; without even the implied warranty of
13// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14// GNU General Public License for more details.
15
16// Under Section 7 of GPL version 3, you are granted additional
17// permissions described in the GCC Runtime Library Exception, version
18// 3.1, as published by the Free Software Foundation.
19
20// You should have received a copy of the GNU General Public License and
21// a copy of the GCC Runtime Library Exception along with this program;
22// see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23// <http://www.gnu.org/licenses/>.
24
25/** @file experimental/fs_dir.h
26 * This is an internal header file, included by other library headers.
27 * Do not attempt to use it directly. @headername{experimental/filesystem}
28 */
29
30#ifndef _GLIBCXX_EXPERIMENTAL_FS_DIR_H
31#define _GLIBCXX_EXPERIMENTAL_FS_DIR_H 1
32
33#if __cplusplus < 201103L
34# include <bits/c++0x_warning.h>
35#else
36# include <typeinfo>
37# include <ext/concurrence.h>
38# include <bits/unique_ptr.h>
39# include <bits/shared_ptr.h>
40
41namespace std _GLIBCXX_VISIBILITY(default)
42{
43namespace experimental
44{
45namespace filesystem
46{
47inline namespace v1
48{
49_GLIBCXX_BEGIN_NAMESPACE_VERSION
50
51 /**
52 * @ingroup filesystem
53 * @{
54 */
55
56 class file_status
57 {
58 public:
59 // constructors
60 explicit
61 file_status(file_type __ft = file_type::none,
62 perms __prms = perms::unknown) noexcept
63 : _M_type(__ft), _M_perms(__prms) { }
64
65 file_status(const file_status&) noexcept = default;
66 file_status(file_status&&) noexcept = default;
67 ~file_status() = default;
68
69 file_status& operator=(const file_status&) noexcept = default;
70 file_status& operator=(file_status&&) noexcept = default;
71
72 // observers
73 file_type type() const noexcept { return _M_type; }
74 perms permissions() const noexcept { return _M_perms; }
75
76 // modifiers
77 void type(file_type __ft) noexcept { _M_type = __ft; }
78 void permissions(perms __prms) noexcept { _M_perms = __prms; }
79
80 private:
81 file_type _M_type;
82 perms _M_perms;
83 };
84
85_GLIBCXX_BEGIN_NAMESPACE_CXX11
86
87 class directory_entry
88 {
89 public:
90 // constructors and destructor
91 directory_entry() noexcept = default;
92 directory_entry(const directory_entry&) = default;
93 directory_entry(directory_entry&&) noexcept = default;
94 explicit directory_entry(const filesystem::path& __p) : _M_path(__p) { }
95 ~directory_entry() = default;
96
97 // modifiers
98 directory_entry& operator=(const directory_entry&) = default;
99 directory_entry& operator=(directory_entry&&) noexcept = default;
100
101 void assign(const filesystem::path& __p) { _M_path = __p; }
102
103 void
104 replace_filename(const filesystem::path& __p)
105 { _M_path = _M_path.parent_path() / __p; }
106
107 // observers
108 const filesystem::path& path() const noexcept { return _M_path; }
109 operator const filesystem::path&() const noexcept { return _M_path; }
110
111 file_status
112 status() const
113 { return filesystem::status(_M_path); }
114
115 file_status
116 status(error_code& __ec) const noexcept
117 { return filesystem::status(_M_path, __ec); }
118
119 file_status
120 symlink_status() const
121 { return filesystem::symlink_status(_M_path); }
122
123 file_status
124 symlink_status(error_code& __ec) const noexcept
125 { return filesystem::symlink_status(_M_path, __ec); }
126
127 bool
128 operator< (const directory_entry& __rhs) const noexcept
129 { return _M_path < __rhs._M_path; }
130
131 bool
132 operator==(const directory_entry& __rhs) const noexcept
133 { return _M_path == __rhs._M_path; }
134
135 bool
136 operator!=(const directory_entry& __rhs) const noexcept
137 { return _M_path != __rhs._M_path; }
138
139 bool
140 operator<=(const directory_entry& __rhs) const noexcept
141 { return _M_path <= __rhs._M_path; }
142
143 bool
144 operator> (const directory_entry& __rhs) const noexcept
145 { return _M_path > __rhs._M_path; }
146
147 bool
148 operator>=(const directory_entry& __rhs) const noexcept
149 { return _M_path >= __rhs._M_path; }
150
151 private:
152 filesystem::path _M_path;
153 };
154
155 struct _Dir;
156 class recursive_directory_iterator;
157
158 class directory_iterator
159 {
160 public:
161 typedef directory_entry value_type;
162 typedef ptrdiff_t difference_type;
163 typedef const directory_entry* pointer;
164 typedef const directory_entry& reference;
165 typedef input_iterator_tag iterator_category;
166
167 directory_iterator() noexcept = default;
168
169 explicit
170 directory_iterator(const path& __p)
171 : directory_iterator(__p, directory_options::none, nullptr) { }
172
173 directory_iterator(const path& __p, directory_options __options)
174 : directory_iterator(__p, __options, nullptr) { }
175
176 directory_iterator(const path& __p, error_code& __ec) noexcept
177 : directory_iterator(__p, directory_options::none, __ec) { }
178
179 directory_iterator(const path& __p,
180 directory_options __options, error_code& __ec) noexcept
181 : directory_iterator(__p, __options, &__ec) { }
182
183 directory_iterator(const directory_iterator& rhs) = default;
184
185 directory_iterator(directory_iterator&& rhs) noexcept = default;
186
187 ~directory_iterator() = default;
188
189 directory_iterator& operator=(const directory_iterator& rhs) = default;
190 directory_iterator& operator=(directory_iterator&& rhs) noexcept = default;
191
192 const directory_entry& operator*() const;
193 const directory_entry* operator->() const { return &**this; }
194 directory_iterator& operator++();
195 directory_iterator& increment(error_code& __ec) noexcept;
196
197 directory_iterator operator++(int)
198 {
199 auto __tmp = *this;
200 ++*this;
201 return __tmp;
202 }
203
204 friend bool
205 operator==(const directory_iterator& __lhs,
206 const directory_iterator& __rhs)
207 { return __lhs._M_dir == __rhs._M_dir; }
208
209 private:
210 directory_iterator(const path&, directory_options, error_code*);
211 directory_iterator(std::shared_ptr<_Dir>, error_code*);
212
213 friend class recursive_directory_iterator;
214
215 std::shared_ptr<_Dir> _M_dir;
216 };
217
218 inline directory_iterator
219 begin(directory_iterator __iter) { return __iter; }
220
221 inline directory_iterator
222 end(directory_iterator) { return directory_iterator(); }
223
224 inline bool
225 operator!=(const directory_iterator& __lhs, const directory_iterator& __rhs)
226 { return !(__lhs == __rhs); }
227
228 class recursive_directory_iterator
229 {
230 public:
231 typedef directory_entry value_type;
232 typedef ptrdiff_t difference_type;
233 typedef const directory_entry* pointer;
234 typedef const directory_entry& reference;
235 typedef input_iterator_tag iterator_category;
236
237 recursive_directory_iterator() noexcept = default;
238
239 explicit
240 recursive_directory_iterator(const path& __p)
241 : recursive_directory_iterator(__p, directory_options::none, nullptr) { }
242
243 recursive_directory_iterator(const path& __p, directory_options __options)
244 : recursive_directory_iterator(__p, __options, nullptr) { }
245
246 recursive_directory_iterator(const path& __p,
247 directory_options __options,
248 error_code& __ec) noexcept
249 : recursive_directory_iterator(__p, __options, &__ec) { }
250
251 recursive_directory_iterator(const path& __p, error_code& __ec) noexcept
252 : recursive_directory_iterator(__p, directory_options::none, &__ec) { }
253
254 recursive_directory_iterator(
255 const recursive_directory_iterator&) = default;
256
257 recursive_directory_iterator(
258 recursive_directory_iterator&&) noexcept = default;
259
260 ~recursive_directory_iterator();
261
262 // observers
263 directory_options options() const { return _M_options; }
264 int depth() const;
265 bool recursion_pending() const { return _M_pending; }
266
267 const directory_entry& operator*() const;
268 const directory_entry* operator->() const { return &**this; }
269
270 // modifiers
271 recursive_directory_iterator&
272 operator=(const recursive_directory_iterator& rhs) noexcept;
273 recursive_directory_iterator&
274 operator=(recursive_directory_iterator&& rhs) noexcept;
275
276 recursive_directory_iterator& operator++();
277 recursive_directory_iterator& increment(error_code& __ec) noexcept;
278
279 recursive_directory_iterator operator++(int)
280 {
281 auto __tmp = *this;
282 ++*this;
283 return __tmp;
284 }
285
286 void pop();
287
288 void disable_recursion_pending() { _M_pending = false; }
289
290 friend bool
291 operator==(const recursive_directory_iterator& __lhs,
292 const recursive_directory_iterator& __rhs)
293 { return __lhs._M_dirs == __rhs._M_dirs; }
294
295 private:
296 recursive_directory_iterator(const path&, directory_options, error_code*);
297
298 struct _Dir_stack;
299 std::shared_ptr<_Dir_stack> _M_dirs;
300 directory_options _M_options;
301 bool _M_pending;
302 };
303
304 inline recursive_directory_iterator
305 begin(recursive_directory_iterator __iter) { return __iter; }
306
307 inline recursive_directory_iterator
308 end(recursive_directory_iterator) { return recursive_directory_iterator(); }
309
310 inline bool
311 operator!=(const recursive_directory_iterator& __lhs,
312 const recursive_directory_iterator& __rhs)
313 { return !(__lhs == __rhs); }
314
315_GLIBCXX_END_NAMESPACE_CXX11
316
317 // @} group filesystem
318_GLIBCXX_END_NAMESPACE_VERSION
319} // namespace v1
320} // namespace filesystem
321} // namespace experimental
322} // namespace std
323
324#endif // C++11
325
326#endif // _GLIBCXX_EXPERIMENTAL_FS_DIR_H