directory.hpp 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620
  1. // boost/filesystem/directory.hpp ---------------------------------------------------//
  2. // Copyright Beman Dawes 2002-2009
  3. // Copyright Jan Langer 2002
  4. // Copyright Dietmar Kuehl 2001
  5. // Copyright Vladimir Prus 2002
  6. // Copyright Andrey Semashev 2019
  7. // Distributed under the Boost Software License, Version 1.0.
  8. // See http://www.boost.org/LICENSE_1_0.txt
  9. // Library home page: http://www.boost.org/libs/filesystem
  10. //--------------------------------------------------------------------------------------//
  11. #ifndef BOOST_FILESYSTEM3_DIRECTORY_HPP
  12. #define BOOST_FILESYSTEM3_DIRECTORY_HPP
  13. #include <boost/config.hpp>
  14. # if defined( BOOST_NO_STD_WSTRING )
  15. # error Configuration not supported: Boost.Filesystem V3 and later requires std::wstring support
  16. # endif
  17. #include <boost/filesystem/config.hpp>
  18. #include <boost/filesystem/path.hpp>
  19. #include <boost/filesystem/file_status.hpp>
  20. #include <string>
  21. #include <vector>
  22. #include <utility> // std::move
  23. #include <boost/assert.hpp>
  24. #include <boost/core/scoped_enum.hpp>
  25. #include <boost/detail/bitmask.hpp>
  26. #include <boost/system/error_code.hpp>
  27. #include <boost/smart_ptr/intrusive_ptr.hpp>
  28. #include <boost/smart_ptr/intrusive_ref_counter.hpp>
  29. #include <boost/iterator/iterator_facade.hpp>
  30. #include <boost/iterator/iterator_categories.hpp>
  31. #include <boost/config/abi_prefix.hpp> // must be the last #include
  32. //--------------------------------------------------------------------------------------//
  33. namespace boost {
  34. namespace filesystem {
  35. //--------------------------------------------------------------------------------------//
  36. // //
  37. // directory_entry //
  38. // //
  39. //--------------------------------------------------------------------------------------//
  40. // GCC has a problem with a member function named path within a namespace or
  41. // sub-namespace that also has a class named path. The workaround is to always
  42. // fully qualify the name path when it refers to the class name.
  43. class directory_entry
  44. {
  45. public:
  46. typedef boost::filesystem::path::value_type value_type; // enables class path ctor taking directory_entry
  47. directory_entry() BOOST_NOEXCEPT {}
  48. explicit directory_entry(const boost::filesystem::path& p) :
  49. m_path(p), m_status(file_status()), m_symlink_status(file_status())
  50. {
  51. }
  52. directory_entry(const boost::filesystem::path& p,
  53. file_status st, file_status symlink_st = file_status()) :
  54. m_path(p), m_status(st), m_symlink_status(symlink_st)
  55. {
  56. }
  57. directory_entry(const directory_entry& rhs) :
  58. m_path(rhs.m_path), m_status(rhs.m_status), m_symlink_status(rhs.m_symlink_status)
  59. {
  60. }
  61. directory_entry& operator=(const directory_entry& rhs)
  62. {
  63. m_path = rhs.m_path;
  64. m_status = rhs.m_status;
  65. m_symlink_status = rhs.m_symlink_status;
  66. return *this;
  67. }
  68. // As of October 2015 the interaction between noexcept and =default is so troublesome
  69. // for VC++, GCC, and probably other compilers, that =default is not used with noexcept
  70. // functions. GCC is not even consistent for the same release on different platforms.
  71. #if !defined(BOOST_NO_CXX11_RVALUE_REFERENCES)
  72. directory_entry(directory_entry&& rhs) BOOST_NOEXCEPT :
  73. m_path(std::move(rhs.m_path)), m_status(std::move(rhs.m_status)), m_symlink_status(std::move(rhs.m_symlink_status))
  74. {
  75. }
  76. directory_entry& operator=(directory_entry&& rhs) BOOST_NOEXCEPT
  77. {
  78. m_path = std::move(rhs.m_path);
  79. m_status = std::move(rhs.m_status);
  80. m_symlink_status = std::move(rhs.m_symlink_status);
  81. return *this;
  82. }
  83. #endif
  84. void assign(const boost::filesystem::path& p,
  85. file_status st = file_status(), file_status symlink_st = file_status())
  86. {
  87. m_path = p;
  88. m_status = st;
  89. m_symlink_status = symlink_st;
  90. }
  91. void replace_filename(const boost::filesystem::path& p,
  92. file_status st = file_status(), file_status symlink_st = file_status())
  93. {
  94. m_path.remove_filename();
  95. m_path /= p;
  96. m_status = st;
  97. m_symlink_status = symlink_st;
  98. }
  99. # ifndef BOOST_FILESYSTEM_NO_DEPRECATED
  100. void replace_leaf(const boost::filesystem::path& p, file_status st, file_status symlink_st)
  101. {
  102. replace_filename(p, st, symlink_st);
  103. }
  104. # endif
  105. const boost::filesystem::path& path() const BOOST_NOEXCEPT { return m_path; }
  106. operator const boost::filesystem::path&() const BOOST_NOEXCEPT { return m_path; }
  107. file_status status() const { return get_status(); }
  108. file_status status(system::error_code& ec) const BOOST_NOEXCEPT { return get_status(&ec); }
  109. file_status symlink_status() const { return get_symlink_status(); }
  110. file_status symlink_status(system::error_code& ec) const BOOST_NOEXCEPT { return get_symlink_status(&ec); }
  111. bool operator==(const directory_entry& rhs) const BOOST_NOEXCEPT { return m_path == rhs.m_path; }
  112. bool operator!=(const directory_entry& rhs) const BOOST_NOEXCEPT { return m_path != rhs.m_path; }
  113. bool operator< (const directory_entry& rhs) const BOOST_NOEXCEPT { return m_path < rhs.m_path; }
  114. bool operator<=(const directory_entry& rhs) const BOOST_NOEXCEPT { return m_path <= rhs.m_path; }
  115. bool operator> (const directory_entry& rhs) const BOOST_NOEXCEPT { return m_path > rhs.m_path; }
  116. bool operator>=(const directory_entry& rhs) const BOOST_NOEXCEPT { return m_path >= rhs.m_path; }
  117. private:
  118. BOOST_FILESYSTEM_DECL file_status get_status(system::error_code* ec=0) const;
  119. BOOST_FILESYSTEM_DECL file_status get_symlink_status(system::error_code* ec=0) const;
  120. private:
  121. boost::filesystem::path m_path;
  122. mutable file_status m_status; // stat()-like
  123. mutable file_status m_symlink_status; // lstat()-like
  124. }; // directory_entry
  125. //--------------------------------------------------------------------------------------//
  126. // //
  127. // directory_entry overloads //
  128. // //
  129. //--------------------------------------------------------------------------------------//
  130. // Without these functions, calling (for example) 'is_directory' with a 'directory_entry' results in:
  131. // - a conversion to 'path' using 'operator const boost::filesystem::path&()',
  132. // - then a call to 'is_directory(const path& p)' which recomputes the status with 'detail::status(p)'.
  133. //
  134. // These functions avoid a costly recomputation of the status if one calls 'is_directory(e)' instead of 'is_directory(e.status)'
  135. inline file_status status (const directory_entry& e) BOOST_NOEXCEPT { return e.status(); }
  136. inline bool type_present (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::type_present(e.status()); }
  137. inline bool status_known (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::status_known(e.status()); }
  138. inline bool exists (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::exists(e.status()); }
  139. inline bool is_regular_file(const directory_entry& e) BOOST_NOEXCEPT { return filesystem::is_regular_file(e.status()); }
  140. inline bool is_directory (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::is_directory(e.status()); }
  141. inline bool is_symlink (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::is_symlink(e.status()); }
  142. inline bool is_other (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::is_other(e.status()); }
  143. #ifndef BOOST_FILESYSTEM_NO_DEPRECATED
  144. inline bool is_regular (const directory_entry& e) BOOST_NOEXCEPT { return filesystem::is_regular(e.status()); }
  145. #endif
  146. //--------------------------------------------------------------------------------------//
  147. // //
  148. // directory_iterator helpers //
  149. // //
  150. //--------------------------------------------------------------------------------------//
  151. BOOST_SCOPED_ENUM_UT_DECLARE_BEGIN(directory_options, unsigned int)
  152. {
  153. none = 0u,
  154. skip_permission_denied = 1u, // if a directory cannot be opened because of insufficient permissions, pretend that the directory is empty
  155. follow_directory_symlink = 1u << 1, // recursive_directory_iterator: follow directory symlinks
  156. skip_dangling_symlinks = 1u << 2, // non-standard extension for recursive_directory_iterator: don't follow dangling directory symlinks,
  157. pop_on_error = 1u << 3, // non-standard extension for recursive_directory_iterator: instead of producing an end iterator on errors,
  158. // repeatedly invoke pop() until it succeeds or the iterator becomes equal to end iterator
  159. _detail_no_push = 1u << 4 // internal use only
  160. }
  161. BOOST_SCOPED_ENUM_DECLARE_END(directory_options)
  162. BOOST_BITMASK(BOOST_SCOPED_ENUM_NATIVE(directory_options))
  163. class directory_iterator;
  164. namespace detail {
  165. BOOST_FILESYSTEM_DECL
  166. system::error_code dir_itr_close(// never throws()
  167. void*& handle
  168. #if defined(BOOST_POSIX_API)
  169. , void*& buffer
  170. #endif
  171. ) BOOST_NOEXCEPT;
  172. struct dir_itr_imp :
  173. public boost::intrusive_ref_counter< dir_itr_imp >
  174. {
  175. directory_entry dir_entry;
  176. void* handle;
  177. #if defined(BOOST_POSIX_API)
  178. void* buffer; // see dir_itr_increment implementation
  179. #endif
  180. dir_itr_imp() BOOST_NOEXCEPT :
  181. handle(0)
  182. #if defined(BOOST_POSIX_API)
  183. , buffer(0)
  184. #endif
  185. {
  186. }
  187. ~dir_itr_imp() BOOST_NOEXCEPT
  188. {
  189. dir_itr_close(handle
  190. #if defined(BOOST_POSIX_API)
  191. , buffer
  192. #endif
  193. );
  194. }
  195. };
  196. // see path::iterator: comment below
  197. BOOST_FILESYSTEM_DECL void directory_iterator_construct(directory_iterator& it, const path& p, unsigned int opts, system::error_code* ec);
  198. BOOST_FILESYSTEM_DECL void directory_iterator_increment(directory_iterator& it, system::error_code* ec);
  199. } // namespace detail
  200. //--------------------------------------------------------------------------------------//
  201. // //
  202. // directory_iterator //
  203. // //
  204. //--------------------------------------------------------------------------------------//
  205. class directory_iterator :
  206. public boost::iterator_facade<
  207. directory_iterator,
  208. directory_entry,
  209. boost::single_pass_traversal_tag
  210. >
  211. {
  212. friend class boost::iterator_core_access;
  213. friend BOOST_FILESYSTEM_DECL void detail::directory_iterator_construct(directory_iterator& it, const path& p, unsigned int opts, system::error_code* ec);
  214. friend BOOST_FILESYSTEM_DECL void detail::directory_iterator_increment(directory_iterator& it, system::error_code* ec);
  215. public:
  216. directory_iterator() BOOST_NOEXCEPT {} // creates the "end" iterator
  217. // iterator_facade derived classes don't seem to like implementations in
  218. // separate translation unit dll's, so forward to detail functions
  219. explicit directory_iterator(const path& p, BOOST_SCOPED_ENUM_NATIVE(directory_options) opts = directory_options::none)
  220. {
  221. detail::directory_iterator_construct(*this, p, static_cast< unsigned int >(opts), 0);
  222. }
  223. directory_iterator(const path& p, system::error_code& ec) BOOST_NOEXCEPT
  224. {
  225. detail::directory_iterator_construct(*this, p, static_cast< unsigned int >(directory_options::none), &ec);
  226. }
  227. directory_iterator(const path& p, BOOST_SCOPED_ENUM_NATIVE(directory_options) opts, system::error_code& ec) BOOST_NOEXCEPT
  228. {
  229. detail::directory_iterator_construct(*this, p, static_cast< unsigned int >(opts), &ec);
  230. }
  231. BOOST_DEFAULTED_FUNCTION(directory_iterator(directory_iterator const& that), : m_imp(that.m_imp) {})
  232. BOOST_DEFAULTED_FUNCTION(directory_iterator& operator= (directory_iterator const& that), { m_imp = that.m_imp; return *this; })
  233. #if !defined(BOOST_NO_CXX11_RVALUE_REFERENCES)
  234. directory_iterator(directory_iterator&& that) BOOST_NOEXCEPT :
  235. m_imp(std::move(that.m_imp))
  236. {
  237. }
  238. directory_iterator& operator= (directory_iterator&& that) BOOST_NOEXCEPT
  239. {
  240. m_imp = std::move(that.m_imp);
  241. return *this;
  242. }
  243. #endif // !defined(BOOST_NO_CXX11_RVALUE_REFERENCES)
  244. directory_iterator& increment(system::error_code& ec) BOOST_NOEXCEPT
  245. {
  246. detail::directory_iterator_increment(*this, &ec);
  247. return *this;
  248. }
  249. private:
  250. boost::iterator_facade<
  251. directory_iterator,
  252. directory_entry,
  253. boost::single_pass_traversal_tag
  254. >::reference dereference() const
  255. {
  256. BOOST_ASSERT_MSG(!is_end(), "attempt to dereference end directory iterator");
  257. return m_imp->dir_entry;
  258. }
  259. void increment() { detail::directory_iterator_increment(*this, 0); }
  260. bool equal(const directory_iterator& rhs) const BOOST_NOEXCEPT
  261. {
  262. return m_imp == rhs.m_imp || (is_end() && rhs.is_end());
  263. }
  264. bool is_end() const BOOST_NOEXCEPT
  265. {
  266. // Note: The check for handle is needed because the iterator can be copied and the copy
  267. // can be incremented to end while the original iterator still refers to the same dir_itr_imp.
  268. return !m_imp || !m_imp->handle;
  269. }
  270. private:
  271. // intrusive_ptr provides the shallow-copy semantics required for single pass iterators
  272. // (i.e. InputIterators). The end iterator is indicated by is_end().
  273. boost::intrusive_ptr< detail::dir_itr_imp > m_imp;
  274. };
  275. // enable directory_iterator C++11 range-based for statement use --------------------//
  276. // begin() and end() are only used by a range-based for statement in the context of
  277. // auto - thus the top-level const is stripped - so returning const is harmless and
  278. // emphasizes begin() is just a pass through.
  279. inline const directory_iterator& begin(const directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  280. inline directory_iterator end(const directory_iterator&) BOOST_NOEXCEPT { return directory_iterator(); }
  281. // enable C++14 generic accessors for range const iterators
  282. inline const directory_iterator& cbegin(const directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  283. inline directory_iterator cend(const directory_iterator&) BOOST_NOEXCEPT { return directory_iterator(); }
  284. // enable directory_iterator BOOST_FOREACH -----------------------------------------//
  285. inline directory_iterator& range_begin(directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  286. inline directory_iterator range_begin(const directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  287. inline directory_iterator range_end(directory_iterator&) BOOST_NOEXCEPT { return directory_iterator(); }
  288. inline directory_iterator range_end(const directory_iterator&) BOOST_NOEXCEPT { return directory_iterator(); }
  289. } // namespace filesystem
  290. // namespace boost template specializations
  291. template<typename C, typename Enabler>
  292. struct range_mutable_iterator;
  293. template<>
  294. struct range_mutable_iterator<boost::filesystem::directory_iterator, void>
  295. {
  296. typedef boost::filesystem::directory_iterator type;
  297. };
  298. template<typename C, typename Enabler>
  299. struct range_const_iterator;
  300. template<>
  301. struct range_const_iterator<boost::filesystem::directory_iterator, void>
  302. {
  303. typedef boost::filesystem::directory_iterator type;
  304. };
  305. namespace filesystem {
  306. //--------------------------------------------------------------------------------------//
  307. // //
  308. // recursive_directory_iterator helpers //
  309. // //
  310. //--------------------------------------------------------------------------------------//
  311. #if !defined(BOOST_FILESYSTEM_NO_DEPRECATED)
  312. // Deprecated enum, use directory_options instead
  313. BOOST_SCOPED_ENUM_UT_DECLARE_BEGIN(symlink_option, unsigned int)
  314. {
  315. none = static_cast< unsigned int >(directory_options::none),
  316. no_recurse = none, // don't follow directory symlinks (default behavior)
  317. recurse = static_cast< unsigned int >(directory_options::follow_directory_symlink), // follow directory symlinks
  318. _detail_no_push = static_cast< unsigned int >(directory_options::_detail_no_push) // internal use only
  319. }
  320. BOOST_SCOPED_ENUM_DECLARE_END(symlink_option)
  321. BOOST_BITMASK(BOOST_SCOPED_ENUM_NATIVE(symlink_option))
  322. #endif // BOOST_FILESYSTEM_NO_DEPRECATED
  323. class recursive_directory_iterator;
  324. namespace detail {
  325. struct recur_dir_itr_imp :
  326. public boost::intrusive_ref_counter< recur_dir_itr_imp >
  327. {
  328. typedef directory_iterator element_type;
  329. std::vector< element_type > m_stack;
  330. // directory_options values, declared as unsigned int for ABI compatibility
  331. unsigned int m_options;
  332. explicit recur_dir_itr_imp(unsigned int opts) BOOST_NOEXCEPT : m_options(opts) {}
  333. };
  334. BOOST_FILESYSTEM_DECL void recursive_directory_iterator_construct(recursive_directory_iterator& it, const path& dir_path, unsigned int opts, system::error_code* ec);
  335. BOOST_FILESYSTEM_DECL void recursive_directory_iterator_increment(recursive_directory_iterator& it, system::error_code* ec);
  336. BOOST_FILESYSTEM_DECL void recursive_directory_iterator_pop(recursive_directory_iterator& it, system::error_code* ec);
  337. } // namespace detail
  338. //--------------------------------------------------------------------------------------//
  339. // //
  340. // recursive_directory_iterator //
  341. // //
  342. //--------------------------------------------------------------------------------------//
  343. class recursive_directory_iterator :
  344. public boost::iterator_facade<
  345. recursive_directory_iterator,
  346. directory_entry,
  347. boost::single_pass_traversal_tag
  348. >
  349. {
  350. friend class boost::iterator_core_access;
  351. friend BOOST_FILESYSTEM_DECL void detail::recursive_directory_iterator_construct(recursive_directory_iterator& it, const path& dir_path, unsigned int opts, system::error_code* ec);
  352. friend BOOST_FILESYSTEM_DECL void detail::recursive_directory_iterator_increment(recursive_directory_iterator& it, system::error_code* ec);
  353. friend BOOST_FILESYSTEM_DECL void detail::recursive_directory_iterator_pop(recursive_directory_iterator& it, system::error_code* ec);
  354. public:
  355. recursive_directory_iterator() BOOST_NOEXCEPT {} // creates the "end" iterator
  356. explicit recursive_directory_iterator(const path& dir_path)
  357. {
  358. detail::recursive_directory_iterator_construct(*this, dir_path, static_cast< unsigned int >(directory_options::none), 0);
  359. }
  360. recursive_directory_iterator(const path& dir_path, system::error_code& ec)
  361. {
  362. detail::recursive_directory_iterator_construct(*this, dir_path, static_cast< unsigned int >(directory_options::none), &ec);
  363. }
  364. recursive_directory_iterator(const path& dir_path, BOOST_SCOPED_ENUM_NATIVE(directory_options) opts)
  365. {
  366. detail::recursive_directory_iterator_construct(*this, dir_path, static_cast< unsigned int >(opts), 0);
  367. }
  368. recursive_directory_iterator(const path& dir_path, BOOST_SCOPED_ENUM_NATIVE(directory_options) opts, system::error_code& ec)
  369. {
  370. detail::recursive_directory_iterator_construct(*this, dir_path, static_cast< unsigned int >(opts), &ec);
  371. }
  372. #if !defined(BOOST_FILESYSTEM_NO_DEPRECATED)
  373. // Deprecated constructors
  374. recursive_directory_iterator(const path& dir_path, BOOST_SCOPED_ENUM_NATIVE(symlink_option) opts)
  375. {
  376. detail::recursive_directory_iterator_construct(*this, dir_path, static_cast< unsigned int >(opts), 0);
  377. }
  378. recursive_directory_iterator(const path& dir_path, BOOST_SCOPED_ENUM_NATIVE(symlink_option) opts, system::error_code& ec) BOOST_NOEXCEPT
  379. {
  380. detail::recursive_directory_iterator_construct(*this, dir_path, static_cast< unsigned int >(opts), &ec);
  381. }
  382. #endif // BOOST_FILESYSTEM_NO_DEPRECATED
  383. BOOST_DEFAULTED_FUNCTION(recursive_directory_iterator(recursive_directory_iterator const& that), : m_imp(that.m_imp) {})
  384. BOOST_DEFAULTED_FUNCTION(recursive_directory_iterator& operator= (recursive_directory_iterator const& that), { m_imp = that.m_imp; return *this; })
  385. #if !defined(BOOST_NO_CXX11_RVALUE_REFERENCES)
  386. recursive_directory_iterator(recursive_directory_iterator&& that) BOOST_NOEXCEPT :
  387. m_imp(std::move(that.m_imp))
  388. {
  389. }
  390. recursive_directory_iterator& operator= (recursive_directory_iterator&& that) BOOST_NOEXCEPT
  391. {
  392. m_imp = std::move(that.m_imp);
  393. return *this;
  394. }
  395. #endif // !defined(BOOST_NO_CXX11_RVALUE_REFERENCES)
  396. recursive_directory_iterator& increment(system::error_code& ec) BOOST_NOEXCEPT
  397. {
  398. detail::recursive_directory_iterator_increment(*this, &ec);
  399. return *this;
  400. }
  401. int depth() const BOOST_NOEXCEPT
  402. {
  403. BOOST_ASSERT_MSG(!is_end(), "depth() on end recursive_directory_iterator");
  404. return static_cast< int >(m_imp->m_stack.size() - 1u);
  405. }
  406. bool recursion_pending() const BOOST_NOEXCEPT
  407. {
  408. BOOST_ASSERT_MSG(!is_end(), "recursion_pending() on end recursive_directory_iterator");
  409. return (m_imp->m_options & static_cast< unsigned int >(directory_options::_detail_no_push)) == 0u;
  410. }
  411. #ifndef BOOST_FILESYSTEM_NO_DEPRECATED
  412. int level() const BOOST_NOEXCEPT { return depth(); }
  413. bool no_push_pending() const BOOST_NOEXCEPT { return !recursion_pending(); }
  414. bool no_push_request() const BOOST_NOEXCEPT { return !recursion_pending(); }
  415. #endif
  416. void pop()
  417. {
  418. detail::recursive_directory_iterator_pop(*this, 0);
  419. }
  420. void pop(system::error_code& ec) BOOST_NOEXCEPT
  421. {
  422. detail::recursive_directory_iterator_pop(*this, &ec);
  423. }
  424. void disable_recursion_pending(bool value = true) BOOST_NOEXCEPT
  425. {
  426. BOOST_ASSERT_MSG(!is_end(), "disable_recursion_pending() on end recursive_directory_iterator");
  427. if (value)
  428. m_imp->m_options |= static_cast< unsigned int >(directory_options::_detail_no_push);
  429. else
  430. m_imp->m_options &= ~static_cast< unsigned int >(directory_options::_detail_no_push);
  431. }
  432. #ifndef BOOST_FILESYSTEM_NO_DEPRECATED
  433. void no_push(bool value = true) BOOST_NOEXCEPT { disable_recursion_pending(value); }
  434. #endif
  435. file_status status() const
  436. {
  437. BOOST_ASSERT_MSG(!is_end(), "status() on end recursive_directory_iterator");
  438. return m_imp->m_stack.back()->status();
  439. }
  440. file_status symlink_status() const
  441. {
  442. BOOST_ASSERT_MSG(!is_end(), "symlink_status() on end recursive_directory_iterator");
  443. return m_imp->m_stack.back()->symlink_status();
  444. }
  445. private:
  446. boost::iterator_facade<
  447. recursive_directory_iterator,
  448. directory_entry,
  449. boost::single_pass_traversal_tag
  450. >::reference dereference() const
  451. {
  452. BOOST_ASSERT_MSG(!is_end(), "dereference of end recursive_directory_iterator");
  453. return *m_imp->m_stack.back();
  454. }
  455. void increment() { detail::recursive_directory_iterator_increment(*this, 0); }
  456. bool equal(const recursive_directory_iterator& rhs) const BOOST_NOEXCEPT
  457. {
  458. return m_imp == rhs.m_imp || (is_end() && rhs.is_end());
  459. }
  460. bool is_end() const BOOST_NOEXCEPT
  461. {
  462. // Note: The check for m_stack.empty() is needed because the iterator can be copied and the copy
  463. // can be incremented to end while the original iterator still refers to the same recur_dir_itr_imp.
  464. return !m_imp || m_imp->m_stack.empty();
  465. }
  466. private:
  467. // intrusive_ptr provides the shallow-copy semantics required for single pass iterators
  468. // (i.e. InputIterators). The end iterator is indicated by is_end().
  469. boost::intrusive_ptr< detail::recur_dir_itr_imp > m_imp;
  470. };
  471. #if !defined(BOOST_FILESYSTEM_NO_DEPRECATED)
  472. typedef recursive_directory_iterator wrecursive_directory_iterator;
  473. #endif
  474. // enable recursive directory iterator C++11 range-base for statement use ----------//
  475. // begin() and end() are only used by a range-based for statement in the context of
  476. // auto - thus the top-level const is stripped - so returning const is harmless and
  477. // emphasizes begin() is just a pass through.
  478. inline const recursive_directory_iterator& begin(const recursive_directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  479. inline recursive_directory_iterator end(const recursive_directory_iterator&) BOOST_NOEXCEPT { return recursive_directory_iterator(); }
  480. // enable C++14 generic accessors for range const iterators
  481. inline const recursive_directory_iterator& cbegin(const recursive_directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  482. inline recursive_directory_iterator cend(const recursive_directory_iterator&) BOOST_NOEXCEPT { return recursive_directory_iterator(); }
  483. // enable recursive directory iterator BOOST_FOREACH -------------------------------//
  484. inline recursive_directory_iterator& range_begin(recursive_directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  485. inline recursive_directory_iterator range_begin(const recursive_directory_iterator& iter) BOOST_NOEXCEPT { return iter; }
  486. inline recursive_directory_iterator range_end(recursive_directory_iterator&) BOOST_NOEXCEPT { return recursive_directory_iterator(); }
  487. inline recursive_directory_iterator range_end(const recursive_directory_iterator&) BOOST_NOEXCEPT { return recursive_directory_iterator(); }
  488. } // namespace filesystem
  489. // namespace boost template specializations
  490. template<>
  491. struct range_mutable_iterator<boost::filesystem::recursive_directory_iterator, void>
  492. {
  493. typedef boost::filesystem::recursive_directory_iterator type;
  494. };
  495. template<>
  496. struct range_const_iterator<boost::filesystem::recursive_directory_iterator, void>
  497. {
  498. typedef boost::filesystem::recursive_directory_iterator type;
  499. };
  500. } // namespace boost
  501. #include <boost/config/abi_suffix.hpp> // pops abi_prefix.hpp pragmas
  502. #endif // BOOST_FILESYSTEM3_DIRECTORY_HPP