xref: /llvm-project/libcxx/include/__cxx03/__filesystem/path_iterator.h (revision ce7771902dc50d900de639d499a60486b83f70e0)
1e78f53d1SNikolas Klauser // -*- C++ -*-
2e78f53d1SNikolas Klauser //===----------------------------------------------------------------------===//
3e78f53d1SNikolas Klauser //
4e78f53d1SNikolas Klauser // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5e78f53d1SNikolas Klauser // See https://llvm.org/LICENSE.txt for license information.
6e78f53d1SNikolas Klauser // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7e78f53d1SNikolas Klauser //
8e78f53d1SNikolas Klauser //===----------------------------------------------------------------------===//
9e78f53d1SNikolas Klauser 
10*ce777190SNikolas Klauser #ifndef _LIBCPP___CXX03___FILESYSTEM_PATH_ITERATOR_H
11*ce777190SNikolas Klauser #define _LIBCPP___CXX03___FILESYSTEM_PATH_ITERATOR_H
12e78f53d1SNikolas Klauser 
1373fbae83SNikolas Klauser #include <__cxx03/__assert>
1473fbae83SNikolas Klauser #include <__cxx03/__config>
1573fbae83SNikolas Klauser #include <__cxx03/__filesystem/path.h>
1673fbae83SNikolas Klauser #include <__cxx03/__iterator/iterator_traits.h>
1773fbae83SNikolas Klauser #include <__cxx03/cstddef>
1873fbae83SNikolas Klauser #include <__cxx03/string>
1973fbae83SNikolas Klauser #include <__cxx03/string_view>
20e78f53d1SNikolas Klauser 
21e78f53d1SNikolas Klauser #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
22e78f53d1SNikolas Klauser #  pragma GCC system_header
23e78f53d1SNikolas Klauser #endif
24e78f53d1SNikolas Klauser 
25e78f53d1SNikolas Klauser #if _LIBCPP_STD_VER >= 17
26e78f53d1SNikolas Klauser 
27e78f53d1SNikolas Klauser _LIBCPP_BEGIN_NAMESPACE_FILESYSTEM
28e78f53d1SNikolas Klauser 
29e78f53d1SNikolas Klauser class _LIBCPP_EXPORTED_FROM_ABI path::iterator {
30e78f53d1SNikolas Klauser public:
31e78f53d1SNikolas Klauser   enum _ParserState : unsigned char {
32e78f53d1SNikolas Klauser     _Singular,
33e78f53d1SNikolas Klauser     _BeforeBegin,
34e78f53d1SNikolas Klauser     _InRootName,
35e78f53d1SNikolas Klauser     _InRootDir,
36e78f53d1SNikolas Klauser     _InFilenames,
37e78f53d1SNikolas Klauser     _InTrailingSep,
38e78f53d1SNikolas Klauser     _AtEnd
39e78f53d1SNikolas Klauser   };
40e78f53d1SNikolas Klauser 
41e78f53d1SNikolas Klauser public:
42e78f53d1SNikolas Klauser   typedef input_iterator_tag iterator_category;
43e78f53d1SNikolas Klauser   typedef bidirectional_iterator_tag iterator_concept;
44e78f53d1SNikolas Klauser 
45e78f53d1SNikolas Klauser   typedef path value_type;
46e78f53d1SNikolas Klauser   typedef ptrdiff_t difference_type;
47e78f53d1SNikolas Klauser   typedef const path* pointer;
48e78f53d1SNikolas Klauser   typedef path reference;
49e78f53d1SNikolas Klauser 
50e78f53d1SNikolas Klauser public:
51e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator() : __stashed_elem_(), __path_ptr_(nullptr), __entry_(), __state_(_Singular) {}
52e78f53d1SNikolas Klauser 
53e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator(const iterator&) = default;
54e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI ~iterator()               = default;
55e78f53d1SNikolas Klauser 
56e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator& operator=(const iterator&) = default;
57e78f53d1SNikolas Klauser 
58e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI reference operator*() const { return __stashed_elem_; }
59e78f53d1SNikolas Klauser 
60e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI pointer operator->() const { return &__stashed_elem_; }
61e78f53d1SNikolas Klauser 
62e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator& operator++() {
63e78f53d1SNikolas Klauser     _LIBCPP_ASSERT_NON_NULL(__state_ != _Singular, "attempting to increment a singular iterator");
64e78f53d1SNikolas Klauser     _LIBCPP_ASSERT_UNCATEGORIZED(__state_ != _AtEnd, "attempting to increment the end iterator");
65e78f53d1SNikolas Klauser     return __increment();
66e78f53d1SNikolas Klauser   }
67e78f53d1SNikolas Klauser 
68e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator operator++(int) {
69e78f53d1SNikolas Klauser     iterator __it(*this);
70e78f53d1SNikolas Klauser     this->operator++();
71e78f53d1SNikolas Klauser     return __it;
72e78f53d1SNikolas Klauser   }
73e78f53d1SNikolas Klauser 
74e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator& operator--() {
75e78f53d1SNikolas Klauser     _LIBCPP_ASSERT_NON_NULL(__state_ != _Singular, "attempting to decrement a singular iterator");
76e78f53d1SNikolas Klauser     _LIBCPP_ASSERT_UNCATEGORIZED(
77e78f53d1SNikolas Klauser         __entry_.data() != __path_ptr_->native().data(), "attempting to decrement the begin iterator");
78e78f53d1SNikolas Klauser     return __decrement();
79e78f53d1SNikolas Klauser   }
80e78f53d1SNikolas Klauser 
81e78f53d1SNikolas Klauser   _LIBCPP_HIDE_FROM_ABI iterator operator--(int) {
82e78f53d1SNikolas Klauser     iterator __it(*this);
83e78f53d1SNikolas Klauser     this->operator--();
84e78f53d1SNikolas Klauser     return __it;
85e78f53d1SNikolas Klauser   }
86e78f53d1SNikolas Klauser 
87e78f53d1SNikolas Klauser private:
88e78f53d1SNikolas Klauser   friend class path;
89e78f53d1SNikolas Klauser 
90e78f53d1SNikolas Klauser   inline _LIBCPP_HIDE_FROM_ABI friend bool operator==(const iterator&, const iterator&);
91e78f53d1SNikolas Klauser 
92e78f53d1SNikolas Klauser   iterator& __increment();
93e78f53d1SNikolas Klauser   iterator& __decrement();
94e78f53d1SNikolas Klauser 
95e78f53d1SNikolas Klauser   path __stashed_elem_;
96e78f53d1SNikolas Klauser   const path* __path_ptr_;
97e78f53d1SNikolas Klauser   path::__string_view __entry_;
98e78f53d1SNikolas Klauser   _ParserState __state_;
99e78f53d1SNikolas Klauser };
100e78f53d1SNikolas Klauser 
101e78f53d1SNikolas Klauser _LIBCPP_AVAILABILITY_FILESYSTEM_LIBRARY
102e78f53d1SNikolas Klauser inline _LIBCPP_HIDE_FROM_ABI bool operator==(const path::iterator& __lhs, const path::iterator& __rhs) {
103e78f53d1SNikolas Klauser   return __lhs.__path_ptr_ == __rhs.__path_ptr_ && __lhs.__entry_.data() == __rhs.__entry_.data();
104e78f53d1SNikolas Klauser }
105e78f53d1SNikolas Klauser 
106e78f53d1SNikolas Klauser _LIBCPP_AVAILABILITY_FILESYSTEM_LIBRARY
107e78f53d1SNikolas Klauser inline _LIBCPP_HIDE_FROM_ABI bool operator!=(const path::iterator& __lhs, const path::iterator& __rhs) {
108e78f53d1SNikolas Klauser   return !(__lhs == __rhs);
109e78f53d1SNikolas Klauser }
110e78f53d1SNikolas Klauser 
111e78f53d1SNikolas Klauser _LIBCPP_END_NAMESPACE_FILESYSTEM
112e78f53d1SNikolas Klauser 
113e78f53d1SNikolas Klauser #endif // _LIBCPP_STD_VER >= 17
114e78f53d1SNikolas Klauser 
115*ce777190SNikolas Klauser #endif // _LIBCPP___CXX03___FILESYSTEM_PATH_ITERATOR_H
116