v1/__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___FILESYSTEM_PATH_ITERATOR_H
0011 #define _LIBCPP___FILESYSTEM_PATH_ITERATOR_H
0012
0013 #include <__assert>
0014 #include <__config>
0015 #include <__filesystem/path.h>
0016 #include <__iterator/iterator_traits.h>
0017
0018 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
0019 #  pragma GCC system_header
0020 #endif
0021
0022 #if _LIBCPP_STD_VER >= 17
0023
0024 _LIBCPP_BEGIN_NAMESPACE_FILESYSTEM
0025
0026 class _LIBCPP_EXPORTED_FROM_ABI path::iterator {
0027 public:
0028   enum _ParserState : unsigned char {
0029     _Singular,
0030     _BeforeBegin,
0031     _InRootName,
0032     _InRootDir,
0033     _InFilenames,
0034     _InTrailingSep,
0035     _AtEnd
0036   };
0037
0038 public:
0039   typedef input_iterator_tag iterator_category;
0040   typedef bidirectional_iterator_tag iterator_concept;
0041
0042   typedef path value_type;
0043   typedef ptrdiff_t difference_type;
0044   typedef const path* pointer;
0045   typedef path reference;
0046
0047 public:
0048   _LIBCPP_HIDE_FROM_ABI iterator() : __stashed_elem_(), __path_ptr_(nullptr), __entry_(), __state_(_Singular) {}
0049
0050   _LIBCPP_HIDE_FROM_ABI iterator(const iterator&) = default;
0051   _LIBCPP_HIDE_FROM_ABI ~iterator()               = default;
0052
0053   _LIBCPP_HIDE_FROM_ABI iterator& operator=(const iterator&) = default;
0054
0055   _LIBCPP_HIDE_FROM_ABI reference operator*() const { return __stashed_elem_; }
0056
0057   _LIBCPP_HIDE_FROM_ABI pointer operator->() const { return &__stashed_elem_; }
0058
0059   _LIBCPP_HIDE_FROM_ABI iterator& operator++() {
0060     _LIBCPP_ASSERT_NON_NULL(__state_ != _Singular, "attempting to increment a singular iterator");
0061     _LIBCPP_ASSERT_UNCATEGORIZED(__state_ != _AtEnd, "attempting to increment the end iterator");
0062     return __increment();
0063   }
0064
0065   _LIBCPP_HIDE_FROM_ABI iterator operator++(int) {
0066     iterator __it(*this);
0067     this->operator++();
0068     return __it;
0069   }
0070
0071   _LIBCPP_HIDE_FROM_ABI iterator& operator--() {
0072     _LIBCPP_ASSERT_NON_NULL(__state_ != _Singular, "attempting to decrement a singular iterator");
0073     _LIBCPP_ASSERT_UNCATEGORIZED(
0074         __entry_.data() != __path_ptr_->native().data(), "attempting to decrement the begin iterator");
0075     return __decrement();
0076   }
0077
0078   _LIBCPP_HIDE_FROM_ABI iterator operator--(int) {
0079     iterator __it(*this);
0080     this->operator--();
0081     return __it;
0082   }
0083
0084 private:
0085   friend class path;
0086
0087   inline _LIBCPP_HIDE_FROM_ABI friend bool operator==(const iterator&, const iterator&);
0088
0089   iterator& __increment();
0090   iterator& __decrement();
0091
0092   path __stashed_elem_;
0093   const path* __path_ptr_;
0094   path::__string_view __entry_;
0095   _ParserState __state_;
0096 };
0097
0098 _LIBCPP_AVAILABILITY_FILESYSTEM_LIBRARY
0099 inline _LIBCPP_HIDE_FROM_ABI bool operator==(const path::iterator& __lhs, const path::iterator& __rhs) {
0100   return __lhs.__path_ptr_ == __rhs.__path_ptr_ && __lhs.__entry_.data() == __rhs.__entry_.data();
0101 }
0102
0103 _LIBCPP_AVAILABILITY_FILESYSTEM_LIBRARY
0104 inline _LIBCPP_HIDE_FROM_ABI bool operator!=(const path::iterator& __lhs, const path::iterator& __rhs) {
0105   return !(__lhs == __rhs);
0106 }
0107
0108 _LIBCPP_END_NAMESPACE_FILESYSTEM
0109
0110 #endif // _LIBCPP_STD_VER >= 17
0111
0112 #endif // _LIBCPP___FILESYSTEM_PATH_ITERATOR_H