__cxx03/__filesystem/path_iterator.h

0001 // -*- C++ -*-
0002 //===----------------------------------------------------------------------===//
0003 //
0004 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
0005 // See https://llvm.org/LICENSE.txt for license information.
0006 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
0007 //
0008 //===----------------------------------------------------------------------===//
0009
0010 #ifndef _LIBCPP___CXX03___FILESYSTEM_PATH_ITERATOR_H
0011 #define _LIBCPP___CXX03___FILESYSTEM_PATH_ITERATOR_H
0012
0013 #include <__cxx03/__assert>
0014 #include <__cxx03/__config>
0015 #include <__cxx03/__filesystem/path.h>
0016 #include <__cxx03/__iterator/iterator_traits.h>
0017 #include <__cxx03/cstddef>
0018 #include <__cxx03/string>
0019 #include <__cxx03/string_view>
0020
0021 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
0022 #  pragma GCC system_header
0023 #endif
0024
0025 #if _LIBCPP_STD_VER >= 17
0026
0027 _LIBCPP_BEGIN_NAMESPACE_FILESYSTEM
0028
0029 class _LIBCPP_EXPORTED_FROM_ABI path::iterator {
0030 public:
0031   enum _ParserState : unsigned char {
0032     _Singular,
0033     _BeforeBegin,
0034     _InRootName,
0035     _InRootDir,
0036     _InFilenames,
0037     _InTrailingSep,
0038     _AtEnd
0039   };
0040
0041 public:
0042   typedef input_iterator_tag iterator_category;
0043   typedef bidirectional_iterator_tag iterator_concept;
0044
0045   typedef path value_type;
0046   typedef ptrdiff_t difference_type;
0047   typedef const path* pointer;
0048   typedef path reference;
0049
0050 public:
0051   _LIBCPP_HIDE_FROM_ABI iterator() : __stashed_elem_(), __path_ptr_(nullptr), __entry_(), __state_(_Singular) {}
0052
0053   _LIBCPP_HIDE_FROM_ABI iterator(const iterator&) = default;
0054   _LIBCPP_HIDE_FROM_ABI ~iterator()               = default;
0055
0056   _LIBCPP_HIDE_FROM_ABI iterator& operator=(const iterator&) = default;
0057
0058   _LIBCPP_HIDE_FROM_ABI reference operator*() const { return __stashed_elem_; }
0059
0060   _LIBCPP_HIDE_FROM_ABI pointer operator->() const { return &__stashed_elem_; }
0061
0062   _LIBCPP_HIDE_FROM_ABI iterator& operator++() {
0063     _LIBCPP_ASSERT_NON_NULL(__state_ != _Singular, "attempting to increment a singular iterator");
0064     _LIBCPP_ASSERT_UNCATEGORIZED(__state_ != _AtEnd, "attempting to increment the end iterator");
0065     return __increment();
0066   }
0067
0068   _LIBCPP_HIDE_FROM_ABI iterator operator++(int) {
0069     iterator __it(*this);
0070     this->operator++();
0071     return __it;
0072   }
0073
0074   _LIBCPP_HIDE_FROM_ABI iterator& operator--() {
0075     _LIBCPP_ASSERT_NON_NULL(__state_ != _Singular, "attempting to decrement a singular iterator");
0076     _LIBCPP_ASSERT_UNCATEGORIZED(
0077         __entry_.data() != __path_ptr_->native().data(), "attempting to decrement the begin iterator");
0078     return __decrement();
0079   }
0080
0081   _LIBCPP_HIDE_FROM_ABI iterator operator--(int) {
0082     iterator __it(*this);
0083     this->operator--();
0084     return __it;
0085   }
0086
0087 private:
0088   friend class path;
0089
0090   inline _LIBCPP_HIDE_FROM_ABI friend bool operator==(const iterator&, const iterator&);
0091
0092   iterator& __increment();
0093   iterator& __decrement();
0094
0095   path __stashed_elem_;
0096   const path* __path_ptr_;
0097   path::__string_view __entry_;
0098   _ParserState __state_;
0099 };
0100
0101 _LIBCPP_AVAILABILITY_FILESYSTEM_LIBRARY
0102 inline _LIBCPP_HIDE_FROM_ABI bool operator==(const path::iterator& __lhs, const path::iterator& __rhs) {
0103   return __lhs.__path_ptr_ == __rhs.__path_ptr_ && __lhs.__entry_.data() == __rhs.__entry_.data();
0104 }
0105
0106 _LIBCPP_AVAILABILITY_FILESYSTEM_LIBRARY
0107 inline _LIBCPP_HIDE_FROM_ABI bool operator!=(const path::iterator& __lhs, const path::iterator& __rhs) {
0108   return !(__lhs == __rhs);
0109 }
0110
0111 _LIBCPP_END_NAMESPACE_FILESYSTEM
0112
0113 #endif // _LIBCPP_STD_VER >= 17
0114
0115 #endif // _LIBCPP___CXX03___FILESYSTEM_PATH_ITERATOR_H