2 //===-------------------------- iterator ----------------------------------===//
4 // The LLVM Compiler Infrastructure
6 // This file is dual licensed under the MIT and the University of Illinois Open
7 // Source Licenses. See LICENSE.TXT for details.
9 //===----------------------------------------------------------------------===//
11 #ifndef _LIBCPP_ITERATOR
12 #define _LIBCPP_ITERATOR
20 template<class Iterator>
21 struct iterator_traits
23 typedef typename Iterator::difference_type difference_type;
24 typedef typename Iterator::value_type value_type;
25 typedef typename Iterator::pointer pointer;
26 typedef typename Iterator::reference reference;
27 typedef typename Iterator::iterator_category iterator_category;
31 struct iterator_traits<T*>
33 typedef ptrdiff_t difference_type;
37 typedef random_access_iterator_tag iterator_category;
41 struct iterator_traits<const T*>
43 typedef ptrdiff_t difference_type;
45 typedef const T* pointer;
46 typedef const T& reference;
47 typedef random_access_iterator_tag iterator_category;
50 template<class Category, class T, class Distance = ptrdiff_t,
51 class Pointer = T*, class Reference = T&>
55 typedef Distance difference_type;
56 typedef Pointer pointer;
57 typedef Reference reference;
58 typedef Category iterator_category;
61 struct input_iterator_tag {};
62 struct output_iterator_tag {};
63 struct forward_iterator_tag : public input_iterator_tag {};
64 struct bidirectional_iterator_tag : public forward_iterator_tag {};
65 struct random_access_iterator_tag : public bidirectional_iterator_tag {};
67 // extension: second argument not conforming to C++03
68 template <class InputIterator>
69 void advance(InputIterator& i,
70 typename iterator_traits<InputIterator>::difference_type n);
72 template <class InputIterator>
73 typename iterator_traits<InputIterator>::difference_type
74 distance(InputIterator first, InputIterator last);
76 template <class Iterator>
77 class reverse_iterator
78 : public iterator<typename iterator_traits<Iterator>::iterator_category,
79 typename iterator_traits<Iterator>::value_type,
80 typename iterator_traits<Iterator>::difference_type,
81 typename iterator_traits<Iterator>::pointer,
82 typename iterator_traits<Iterator>::reference>
87 typedef Iterator iterator_type;
88 typedef typename iterator_traits<Iterator>::difference_type difference_type;
89 typedef typename iterator_traits<Iterator>::reference reference;
90 typedef typename iterator_traits<Iterator>::pointer pointer;
93 explicit reverse_iterator(Iterator x);
94 template <class U> reverse_iterator(const reverse_iterator<U>& u);
95 Iterator base() const;
96 reference operator*() const;
97 pointer operator->() const;
98 reverse_iterator& operator++();
99 reverse_iterator operator++(int);
100 reverse_iterator& operator--();
101 reverse_iterator operator--(int);
102 reverse_iterator operator+ (difference_type n) const;
103 reverse_iterator& operator+=(difference_type n);
104 reverse_iterator operator- (difference_type n) const;
105 reverse_iterator& operator-=(difference_type n);
106 reference operator[](difference_type n) const;
109 template <class Iterator1, class Iterator2>
111 operator==(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
113 template <class Iterator1, class Iterator2>
115 operator<(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
117 template <class Iterator1, class Iterator2>
119 operator!=(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
121 template <class Iterator1, class Iterator2>
123 operator>(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
125 template <class Iterator1, class Iterator2>
127 operator>=(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
129 template <class Iterator1, class Iterator2>
131 operator<=(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
133 template <class Iterator1, class Iterator2>
134 typename reverse_iterator<Iterator1>::difference_type
135 operator-(const reverse_iterator<Iterator1>& x, const reverse_iterator<Iterator2>& y);
137 template <class Iterator>
138 reverse_iterator<Iterator>
139 operator+(typename reverse_iterator<Iterator>::difference_type n, const reverse_iterator<Iterator>& x);
141 template <class Container>
142 class back_insert_iterator
145 Container* container;
147 typedef Container container_type;
148 typedef void value_type;
149 typedef void difference_type;
150 typedef back_insert_iterator<Cont>& reference;
151 typedef void pointer;
153 explicit back_insert_iterator(Container& x);
154 back_insert_iterator& operator=(const typename Container::value_type& value);
155 back_insert_iterator& operator*();
156 back_insert_iterator& operator++();
157 back_insert_iterator operator++(int);
160 template <class Container> back_insert_iterator<Container> back_inserter(Container& x);
162 template <class Container>
163 class front_insert_iterator
166 Container* container;
168 typedef Container container_type;
169 typedef void value_type;
170 typedef void difference_type;
171 typedef front_insert_iterator<Cont>& reference;
172 typedef void pointer;
174 explicit front_insert_iterator(Container& x);
175 front_insert_iterator& operator=(const typename Container::value_type& value);
176 front_insert_iterator& operator*();
177 front_insert_iterator& operator++();
178 front_insert_iterator operator++(int);
181 template <class Container> front_insert_iterator<Container> front_inserter(Container& x);
183 template <class Container>
184 class insert_iterator
187 Container* container;
188 typename Container::iterator iter;
190 typedef Container container_type;
191 typedef void value_type;
192 typedef void difference_type;
193 typedef insert_iterator<Cont>& reference;
194 typedef void pointer;
196 insert_iterator(Container& x, typename Container::iterator i);
197 insert_iterator& operator=(const typename Container::value_type& value);
198 insert_iterator& operator*();
199 insert_iterator& operator++();
200 insert_iterator& operator++(int);
203 template <class Container, class Iterator>
204 insert_iterator<Container> inserter(Container& x, Iterator i);
206 template <class T, class charT = char, class traits = char_traits<charT>, class Distance = ptrdiff_t>
207 class istream_iterator
208 : public iterator<input_iterator_tag, T, Distance, const T*, const T&>
211 typedef charT char_type;
212 typedef traits traits_type;
213 typedef basic_istream<charT,traits> istream_type;
216 istream_iterator(istream_type& s);
217 istream_iterator(const istream_iterator& x);
220 const T& operator*() const;
221 const T* operator->() const;
222 istream_iterator& operator++();
223 istream_iterator operator++(int);
226 template <class T, class charT, class traits, class Distance>
227 bool operator==(const istream_iterator<T,charT,traits,Distance>& x,
228 const istream_iterator<T,charT,traits,Distance>& y);
229 template <class T, class charT, class traits, class Distance>
230 bool operator!=(const istream_iterator<T,charT,traits,Distance>& x,
231 const istream_iterator<T,charT,traits,Distance>& y);
233 template <class T, class charT = char, class traits = char_traits<charT> >
234 class ostream_iterator
235 : public iterator<output_iterator_tag, void, void, void ,void>
238 typedef charT char_type;
239 typedef traits traits_type;
240 typedef basic_ostream<charT,traits> ostream_type;
242 ostream_iterator(ostream_type& s);
243 ostream_iterator(ostream_type& s, const charT* delimiter);
244 ostream_iterator(const ostream_iterator& x);
246 ostream_iterator& operator=(const T& value);
248 ostream_iterator& operator*();
249 ostream_iterator& operator++();
250 ostream_iterator& operator++(int);
253 template<class charT, class traits = char_traits<charT> >
254 class istreambuf_iterator
255 : public iterator<input_iterator_tag, charT,
256 typename traits::off_type, unspecified,
260 typedef charT char_type;
261 typedef traits traits_type;
262 typedef typename traits::int_type int_type;
263 typedef basic_streambuf<charT,traits> streambuf_type;
264 typedef basic_istream<charT,traits> istream_type;
266 istreambuf_iterator() noexcept;
267 istreambuf_iterator(istream_type& s) noexcept;
268 istreambuf_iterator(streambuf_type* s) noexcept;
269 istreambuf_iterator(a-private-type) noexcept;
271 charT operator*() const;
272 pointer operator->() const;
273 istreambuf_iterator& operator++();
274 a-private-type operator++(int);
276 bool equal(const istreambuf_iterator& b) const;
279 template <class charT, class traits>
280 bool operator==(const istreambuf_iterator<charT,traits>& a,
281 const istreambuf_iterator<charT,traits>& b);
282 template <class charT, class traits>
283 bool operator!=(const istreambuf_iterator<charT,traits>& a,
284 const istreambuf_iterator<charT,traits>& b);
286 template <class charT, class traits = char_traits<charT> >
287 class ostreambuf_iterator
288 : public iterator<output_iterator_tag, void, void, void, void>
291 typedef charT char_type;
292 typedef traits traits_type;
293 typedef basic_streambuf<charT,traits> streambuf_type;
294 typedef basic_ostream<charT,traits> ostream_type;
296 ostreambuf_iterator(ostream_type& s) noexcept;
297 ostreambuf_iterator(streambuf_type* s) noexcept;
298 ostreambuf_iterator& operator=(charT c);
299 ostreambuf_iterator& operator*();
300 ostreambuf_iterator& operator++();
301 ostreambuf_iterator& operator++(int);
302 bool failed() const noexcept;
305 template <class C> auto begin(C& c) -> decltype(c.begin());
306 template <class C> auto begin(const C& c) -> decltype(c.begin());
307 template <class C> auto end(C& c) -> decltype(c.end());
308 template <class C> auto end(const C& c) -> decltype(c.end());
309 template <class T, size_t N> T* begin(T (&array)[N]);
310 template <class T, size_t N> T* end(T (&array)[N]);
317 #include <type_traits>
321 #include <Availability.h>
328 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
329 #pragma GCC system_header
332 _LIBCPP_BEGIN_NAMESPACE_STD
334 struct _LIBCPP_TYPE_VIS input_iterator_tag {};
335 struct _LIBCPP_TYPE_VIS output_iterator_tag {};
336 struct _LIBCPP_TYPE_VIS forward_iterator_tag : public input_iterator_tag {};
337 struct _LIBCPP_TYPE_VIS bidirectional_iterator_tag : public forward_iterator_tag {};
338 struct _LIBCPP_TYPE_VIS random_access_iterator_tag : public bidirectional_iterator_tag {};
341 struct __has_iterator_category
344 struct __two {char __lx; char __lxx;};
345 template <class _Up> static __two __test(...);
346 template <class _Up> static char __test(typename _Up::iterator_category* = 0);
348 static const bool value = sizeof(__test<_Tp>(0)) == 1;
351 template <class _Iter, bool> struct ____iterator_traits {};
353 template <class _Iter>
354 struct ____iterator_traits<_Iter, true>
356 typedef typename _Iter::difference_type difference_type;
357 typedef typename _Iter::value_type value_type;
358 typedef typename _Iter::pointer pointer;
359 typedef typename _Iter::reference reference;
360 typedef typename _Iter::iterator_category iterator_category;
363 template <class _Iter, bool> struct __iterator_traits {};
365 template <class _Iter>
366 struct __iterator_traits<_Iter, true>
367 : ____iterator_traits
370 is_convertible<typename _Iter::iterator_category, input_iterator_tag>::value ||
371 is_convertible<typename _Iter::iterator_category, output_iterator_tag>::value
375 // iterator_traits<Iterator> will only have the nested types if Iterator::iterator_category
376 // exists. Else iterator_traits<Iterator> will be an empty class. This is a
377 // conforming extension which allows some programs to compile and behave as
378 // the client expects instead of failing at compile time.
380 template <class _Iter>
381 struct _LIBCPP_TYPE_VIS iterator_traits
382 : __iterator_traits<_Iter, __has_iterator_category<_Iter>::value> {};
385 struct _LIBCPP_TYPE_VIS iterator_traits<_Tp*>
387 typedef ptrdiff_t difference_type;
388 typedef typename remove_const<_Tp>::type value_type;
389 typedef _Tp* pointer;
390 typedef _Tp& reference;
391 typedef random_access_iterator_tag iterator_category;
394 template <class _Tp, class _Up, bool = __has_iterator_category<iterator_traits<_Tp> >::value>
395 struct __has_iterator_category_convertible_to
396 : public integral_constant<bool, is_convertible<typename iterator_traits<_Tp>::iterator_category, _Up>::value>
399 template <class _Tp, class _Up>
400 struct __has_iterator_category_convertible_to<_Tp, _Up, false> : public false_type {};
403 struct __is_input_iterator : public __has_iterator_category_convertible_to<_Tp, input_iterator_tag> {};
406 struct __is_forward_iterator : public __has_iterator_category_convertible_to<_Tp, forward_iterator_tag> {};
409 struct __is_bidirectional_iterator : public __has_iterator_category_convertible_to<_Tp, bidirectional_iterator_tag> {};
412 struct __is_random_access_iterator : public __has_iterator_category_convertible_to<_Tp, random_access_iterator_tag> {};
414 template<class _Category, class _Tp, class _Distance = ptrdiff_t,
415 class _Pointer = _Tp*, class _Reference = _Tp&>
416 struct _LIBCPP_TYPE_VIS iterator
418 typedef _Tp value_type;
419 typedef _Distance difference_type;
420 typedef _Pointer pointer;
421 typedef _Reference reference;
422 typedef _Category iterator_category;
425 template <class _InputIter>
426 inline _LIBCPP_INLINE_VISIBILITY
427 void __advance(_InputIter& __i,
428 typename iterator_traits<_InputIter>::difference_type __n, input_iterator_tag)
430 for (; __n > 0; --__n)
434 template <class _BiDirIter>
435 inline _LIBCPP_INLINE_VISIBILITY
436 void __advance(_BiDirIter& __i,
437 typename iterator_traits<_BiDirIter>::difference_type __n, bidirectional_iterator_tag)
440 for (; __n > 0; --__n)
443 for (; __n < 0; ++__n)
447 template <class _RandIter>
448 inline _LIBCPP_INLINE_VISIBILITY
449 void __advance(_RandIter& __i,
450 typename iterator_traits<_RandIter>::difference_type __n, random_access_iterator_tag)
455 template <class _InputIter>
456 inline _LIBCPP_INLINE_VISIBILITY
457 void advance(_InputIter& __i,
458 typename iterator_traits<_InputIter>::difference_type __n)
460 __advance(__i, __n, typename iterator_traits<_InputIter>::iterator_category());
463 template <class _InputIter>
464 inline _LIBCPP_INLINE_VISIBILITY
465 typename iterator_traits<_InputIter>::difference_type
466 __distance(_InputIter __first, _InputIter __last, input_iterator_tag)
468 typename iterator_traits<_InputIter>::difference_type __r(0);
469 for (; __first != __last; ++__first)
474 template <class _RandIter>
475 inline _LIBCPP_INLINE_VISIBILITY
476 typename iterator_traits<_RandIter>::difference_type
477 __distance(_RandIter __first, _RandIter __last, random_access_iterator_tag)
479 return __last - __first;
482 template <class _InputIter>
483 inline _LIBCPP_INLINE_VISIBILITY
484 typename iterator_traits<_InputIter>::difference_type
485 distance(_InputIter __first, _InputIter __last)
487 return __distance(__first, __last, typename iterator_traits<_InputIter>::iterator_category());
490 template <class _ForwardIter>
491 inline _LIBCPP_INLINE_VISIBILITY
493 next(_ForwardIter __x,
494 typename iterator_traits<_ForwardIter>::difference_type __n = 1,
495 typename enable_if<__is_forward_iterator<_ForwardIter>::value>::type* = 0)
497 _VSTD::advance(__x, __n);
501 template <class _BidiretionalIter>
502 inline _LIBCPP_INLINE_VISIBILITY
504 prev(_BidiretionalIter __x,
505 typename iterator_traits<_BidiretionalIter>::difference_type __n = 1,
506 typename enable_if<__is_bidirectional_iterator<_BidiretionalIter>::value>::type* = 0)
508 _VSTD::advance(__x, -__n);
512 template <class _Iter>
513 class _LIBCPP_TYPE_VIS reverse_iterator
514 : public iterator<typename iterator_traits<_Iter>::iterator_category,
515 typename iterator_traits<_Iter>::value_type,
516 typename iterator_traits<_Iter>::difference_type,
517 typename iterator_traits<_Iter>::pointer,
518 typename iterator_traits<_Iter>::reference>
525 typedef _Iter iterator_type;
526 typedef typename iterator_traits<_Iter>::difference_type difference_type;
527 typedef typename iterator_traits<_Iter>::reference reference;
528 typedef typename iterator_traits<_Iter>::pointer pointer;
530 _LIBCPP_INLINE_VISIBILITY reverse_iterator() : current() {}
531 _LIBCPP_INLINE_VISIBILITY explicit reverse_iterator(_Iter __x) : __t(__x), current(__x) {}
532 template <class _Up> _LIBCPP_INLINE_VISIBILITY reverse_iterator(const reverse_iterator<_Up>& __u)
533 : __t(__u.base()), current(__u.base()) {}
534 _LIBCPP_INLINE_VISIBILITY _Iter base() const {return current;}
535 _LIBCPP_INLINE_VISIBILITY reference operator*() const {__t = current; return *--__t;}
536 _LIBCPP_INLINE_VISIBILITY pointer operator->() const {return &(operator*());}
537 _LIBCPP_INLINE_VISIBILITY reverse_iterator& operator++() {--current; return *this;}
538 _LIBCPP_INLINE_VISIBILITY reverse_iterator operator++(int)
539 {reverse_iterator __tmp(*this); --current; return __tmp;}
540 _LIBCPP_INLINE_VISIBILITY reverse_iterator& operator--() {++current; return *this;}
541 _LIBCPP_INLINE_VISIBILITY reverse_iterator operator--(int)
542 {reverse_iterator __tmp(*this); ++current; return __tmp;}
543 _LIBCPP_INLINE_VISIBILITY reverse_iterator operator+ (difference_type __n) const
544 {return reverse_iterator(current - __n);}
545 _LIBCPP_INLINE_VISIBILITY reverse_iterator& operator+=(difference_type __n)
546 {current -= __n; return *this;}
547 _LIBCPP_INLINE_VISIBILITY reverse_iterator operator- (difference_type __n) const
548 {return reverse_iterator(current + __n);}
549 _LIBCPP_INLINE_VISIBILITY reverse_iterator& operator-=(difference_type __n)
550 {current += __n; return *this;}
551 _LIBCPP_INLINE_VISIBILITY reference operator[](difference_type __n) const
552 {return current[-__n-1];}
555 template <class _Iter1, class _Iter2>
556 inline _LIBCPP_INLINE_VISIBILITY
558 operator==(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
560 return __x.base() == __y.base();
563 template <class _Iter1, class _Iter2>
564 inline _LIBCPP_INLINE_VISIBILITY
566 operator<(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
568 return __x.base() > __y.base();
571 template <class _Iter1, class _Iter2>
572 inline _LIBCPP_INLINE_VISIBILITY
574 operator!=(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
576 return __x.base() != __y.base();
579 template <class _Iter1, class _Iter2>
580 inline _LIBCPP_INLINE_VISIBILITY
582 operator>(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
584 return __x.base() < __y.base();
587 template <class _Iter1, class _Iter2>
588 inline _LIBCPP_INLINE_VISIBILITY
590 operator>=(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
592 return __x.base() <= __y.base();
595 template <class _Iter1, class _Iter2>
596 inline _LIBCPP_INLINE_VISIBILITY
598 operator<=(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
600 return __x.base() >= __y.base();
603 template <class _Iter1, class _Iter2>
604 inline _LIBCPP_INLINE_VISIBILITY
605 typename reverse_iterator<_Iter1>::difference_type
606 operator-(const reverse_iterator<_Iter1>& __x, const reverse_iterator<_Iter2>& __y)
608 return __y.base() - __x.base();
611 template <class _Iter>
612 inline _LIBCPP_INLINE_VISIBILITY
613 reverse_iterator<_Iter>
614 operator+(typename reverse_iterator<_Iter>::difference_type __n, const reverse_iterator<_Iter>& __x)
616 return reverse_iterator<_Iter>(__x.base() - __n);
619 template <class _Container>
620 class _LIBCPP_TYPE_VIS back_insert_iterator
621 : public iterator<output_iterator_tag,
625 back_insert_iterator<_Container>&>
628 _Container* container;
630 typedef _Container container_type;
632 _LIBCPP_INLINE_VISIBILITY explicit back_insert_iterator(_Container& __x) : container(&__x) {}
633 _LIBCPP_INLINE_VISIBILITY back_insert_iterator& operator=(const typename _Container::value_type& __value_)
634 {container->push_back(__value_); return *this;}
635 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
636 _LIBCPP_INLINE_VISIBILITY back_insert_iterator& operator=(typename _Container::value_type&& __value_)
637 {container->push_back(_VSTD::move(__value_)); return *this;}
638 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
639 _LIBCPP_INLINE_VISIBILITY back_insert_iterator& operator*() {return *this;}
640 _LIBCPP_INLINE_VISIBILITY back_insert_iterator& operator++() {return *this;}
641 _LIBCPP_INLINE_VISIBILITY back_insert_iterator operator++(int) {return *this;}
644 template <class _Container>
645 inline _LIBCPP_INLINE_VISIBILITY
646 back_insert_iterator<_Container>
647 back_inserter(_Container& __x)
649 return back_insert_iterator<_Container>(__x);
652 template <class _Container>
653 class _LIBCPP_TYPE_VIS front_insert_iterator
654 : public iterator<output_iterator_tag,
658 front_insert_iterator<_Container>&>
661 _Container* container;
663 typedef _Container container_type;
665 _LIBCPP_INLINE_VISIBILITY explicit front_insert_iterator(_Container& __x) : container(&__x) {}
666 _LIBCPP_INLINE_VISIBILITY front_insert_iterator& operator=(const typename _Container::value_type& __value_)
667 {container->push_front(__value_); return *this;}
668 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
669 _LIBCPP_INLINE_VISIBILITY front_insert_iterator& operator=(typename _Container::value_type&& __value_)
670 {container->push_front(_VSTD::move(__value_)); return *this;}
671 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
672 _LIBCPP_INLINE_VISIBILITY front_insert_iterator& operator*() {return *this;}
673 _LIBCPP_INLINE_VISIBILITY front_insert_iterator& operator++() {return *this;}
674 _LIBCPP_INLINE_VISIBILITY front_insert_iterator operator++(int) {return *this;}
677 template <class _Container>
678 inline _LIBCPP_INLINE_VISIBILITY
679 front_insert_iterator<_Container>
680 front_inserter(_Container& __x)
682 return front_insert_iterator<_Container>(__x);
685 template <class _Container>
686 class _LIBCPP_TYPE_VIS insert_iterator
687 : public iterator<output_iterator_tag,
691 insert_iterator<_Container>&>
694 _Container* container;
695 typename _Container::iterator iter;
697 typedef _Container container_type;
699 _LIBCPP_INLINE_VISIBILITY insert_iterator(_Container& __x, typename _Container::iterator __i)
700 : container(&__x), iter(__i) {}
701 _LIBCPP_INLINE_VISIBILITY insert_iterator& operator=(const typename _Container::value_type& __value_)
702 {iter = container->insert(iter, __value_); ++iter; return *this;}
703 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
704 _LIBCPP_INLINE_VISIBILITY insert_iterator& operator=(typename _Container::value_type&& __value_)
705 {iter = container->insert(iter, _VSTD::move(__value_)); ++iter; return *this;}
706 #endif // _LIBCPP_HAS_NO_RVALUE_REFERENCES
707 _LIBCPP_INLINE_VISIBILITY insert_iterator& operator*() {return *this;}
708 _LIBCPP_INLINE_VISIBILITY insert_iterator& operator++() {return *this;}
709 _LIBCPP_INLINE_VISIBILITY insert_iterator& operator++(int) {return *this;}
712 template <class _Container>
713 inline _LIBCPP_INLINE_VISIBILITY
714 insert_iterator<_Container>
715 inserter(_Container& __x, typename _Container::iterator __i)
717 return insert_iterator<_Container>(__x, __i);
720 template <class _Tp, class _CharT = char,
721 class _Traits = char_traits<_CharT>, class _Distance = ptrdiff_t>
722 class _LIBCPP_TYPE_VIS istream_iterator
723 : public iterator<input_iterator_tag, _Tp, _Distance, const _Tp*, const _Tp&>
726 typedef _CharT char_type;
727 typedef _Traits traits_type;
728 typedef basic_istream<_CharT,_Traits> istream_type;
730 istream_type* __in_stream_;
733 _LIBCPP_INLINE_VISIBILITY istream_iterator() : __in_stream_(0) {}
734 _LIBCPP_INLINE_VISIBILITY istream_iterator(istream_type& __s) : __in_stream_(&__s)
736 if (!(*__in_stream_ >> __value_))
740 _LIBCPP_INLINE_VISIBILITY const _Tp& operator*() const {return __value_;}
741 _LIBCPP_INLINE_VISIBILITY const _Tp* operator->() const {return &(operator*());}
742 _LIBCPP_INLINE_VISIBILITY istream_iterator& operator++()
744 if (!(*__in_stream_ >> __value_))
748 _LIBCPP_INLINE_VISIBILITY istream_iterator operator++(int)
749 {istream_iterator __t(*this); ++(*this); return __t;}
751 friend _LIBCPP_INLINE_VISIBILITY
752 bool operator==(const istream_iterator& __x, const istream_iterator& __y)
753 {return __x.__in_stream_ == __y.__in_stream_;}
755 friend _LIBCPP_INLINE_VISIBILITY
756 bool operator!=(const istream_iterator& __x, const istream_iterator& __y)
757 {return !(__x == __y);}
760 template <class _Tp, class _CharT = char, class _Traits = char_traits<_CharT> >
761 class _LIBCPP_TYPE_VIS ostream_iterator
762 : public iterator<output_iterator_tag, void, void, void, void>
765 typedef _CharT char_type;
766 typedef _Traits traits_type;
767 typedef basic_ostream<_CharT,_Traits> ostream_type;
769 ostream_type* __out_stream_;
770 const char_type* __delim_;
772 _LIBCPP_INLINE_VISIBILITY ostream_iterator(ostream_type& __s)
773 : __out_stream_(&__s), __delim_(0) {}
774 _LIBCPP_INLINE_VISIBILITY ostream_iterator(ostream_type& __s, const _CharT* __delimiter)
775 : __out_stream_(&__s), __delim_(__delimiter) {}
776 _LIBCPP_INLINE_VISIBILITY ostream_iterator& operator=(const _Tp& __value_)
778 *__out_stream_ << __value_;
780 *__out_stream_ << __delim_;
784 _LIBCPP_INLINE_VISIBILITY ostream_iterator& operator*() {return *this;}
785 _LIBCPP_INLINE_VISIBILITY ostream_iterator& operator++() {return *this;}
786 _LIBCPP_INLINE_VISIBILITY ostream_iterator& operator++(int) {return *this;}
789 template<class _CharT, class _Traits>
790 class _LIBCPP_TYPE_VIS istreambuf_iterator
791 : public iterator<input_iterator_tag, _CharT,
792 typename _Traits::off_type, _CharT*,
796 typedef _CharT char_type;
797 typedef _Traits traits_type;
798 typedef typename _Traits::int_type int_type;
799 typedef basic_streambuf<_CharT,_Traits> streambuf_type;
800 typedef basic_istream<_CharT,_Traits> istream_type;
802 mutable streambuf_type* __sbuf_;
807 streambuf_type* __sbuf_;
808 _LIBCPP_INLINE_VISIBILITY __proxy(char_type __c, streambuf_type* __s)
809 : __keep_(__c), __sbuf_(__s) {}
810 friend class istreambuf_iterator;
812 _LIBCPP_INLINE_VISIBILITY char_type operator*() const {return __keep_;}
815 _LIBCPP_INLINE_VISIBILITY
816 bool __test_for_eof() const
818 if (__sbuf_ && traits_type::eq_int_type(__sbuf_->sgetc(), traits_type::eof()))
823 _LIBCPP_INLINE_VISIBILITY _LIBCPP_CONSTEXPR istreambuf_iterator() _NOEXCEPT : __sbuf_(0) {}
824 _LIBCPP_INLINE_VISIBILITY istreambuf_iterator(istream_type& __s) _NOEXCEPT
825 : __sbuf_(__s.rdbuf()) {}
826 _LIBCPP_INLINE_VISIBILITY istreambuf_iterator(streambuf_type* __s) _NOEXCEPT
828 _LIBCPP_INLINE_VISIBILITY istreambuf_iterator(const __proxy& __p) _NOEXCEPT
829 : __sbuf_(__p.__sbuf_) {}
831 _LIBCPP_INLINE_VISIBILITY char_type operator*() const
832 {return static_cast<char_type>(__sbuf_->sgetc());}
833 _LIBCPP_INLINE_VISIBILITY char_type* operator->() const {return nullptr;}
834 _LIBCPP_INLINE_VISIBILITY istreambuf_iterator& operator++()
839 _LIBCPP_INLINE_VISIBILITY __proxy operator++(int)
841 return __proxy(__sbuf_->sbumpc(), __sbuf_);
844 _LIBCPP_INLINE_VISIBILITY bool equal(const istreambuf_iterator& __b) const
845 {return __test_for_eof() == __b.__test_for_eof();}
848 template <class _CharT, class _Traits>
849 inline _LIBCPP_INLINE_VISIBILITY
850 bool operator==(const istreambuf_iterator<_CharT,_Traits>& __a,
851 const istreambuf_iterator<_CharT,_Traits>& __b)
852 {return __a.equal(__b);}
854 template <class _CharT, class _Traits>
855 inline _LIBCPP_INLINE_VISIBILITY
856 bool operator!=(const istreambuf_iterator<_CharT,_Traits>& __a,
857 const istreambuf_iterator<_CharT,_Traits>& __b)
858 {return !__a.equal(__b);}
860 template <class _CharT, class _Traits>
861 class _LIBCPP_TYPE_VIS ostreambuf_iterator
862 : public iterator<output_iterator_tag, void, void, void, void>
865 typedef _CharT char_type;
866 typedef _Traits traits_type;
867 typedef basic_streambuf<_CharT,_Traits> streambuf_type;
868 typedef basic_ostream<_CharT,_Traits> ostream_type;
870 streambuf_type* __sbuf_;
872 _LIBCPP_INLINE_VISIBILITY ostreambuf_iterator(ostream_type& __s) _NOEXCEPT
873 : __sbuf_(__s.rdbuf()) {}
874 _LIBCPP_INLINE_VISIBILITY ostreambuf_iterator(streambuf_type* __s) _NOEXCEPT
876 _LIBCPP_INLINE_VISIBILITY ostreambuf_iterator& operator=(_CharT __c)
878 if (__sbuf_ && traits_type::eq_int_type(__sbuf_->sputc(__c), traits_type::eof()))
882 _LIBCPP_INLINE_VISIBILITY ostreambuf_iterator& operator*() {return *this;}
883 _LIBCPP_INLINE_VISIBILITY ostreambuf_iterator& operator++() {return *this;}
884 _LIBCPP_INLINE_VISIBILITY ostreambuf_iterator& operator++(int) {return *this;}
885 _LIBCPP_INLINE_VISIBILITY bool failed() const _NOEXCEPT {return __sbuf_ == 0;}
887 #if !defined(__APPLE__) || \
888 (defined(__MAC_OS_X_VERSION_MIN_REQUIRED) && __MAC_OS_X_VERSION_MIN_REQUIRED > __MAC_10_8) || \
889 (defined(__IPHONE_OS_VERSION_MIN_REQUIRED) && __IPHONE_OS_VERSION_MIN_REQUIRED > __IPHONE_6_0)
891 template <class _Ch, class _Tr>
894 ostreambuf_iterator<_Ch, _Tr>
895 __pad_and_output(ostreambuf_iterator<_Ch, _Tr> __s,
896 const _Ch* __ob, const _Ch* __op, const _Ch* __oe,
897 ios_base& __iob, _Ch __fl);
901 template <class _Iter>
902 class _LIBCPP_TYPE_VIS move_iterator
907 typedef _Iter iterator_type;
908 typedef typename iterator_traits<iterator_type>::iterator_category iterator_category;
909 typedef typename iterator_traits<iterator_type>::value_type value_type;
910 typedef typename iterator_traits<iterator_type>::difference_type difference_type;
911 typedef typename iterator_traits<iterator_type>::pointer pointer;
912 #ifndef _LIBCPP_HAS_NO_RVALUE_REFERENCES
913 typedef value_type&& reference;
915 typedef typename iterator_traits<iterator_type>::reference reference;
918 _LIBCPP_INLINE_VISIBILITY move_iterator() : __i() {}
919 _LIBCPP_INLINE_VISIBILITY explicit move_iterator(_Iter __x) : __i(__x) {}
920 template <class _Up> _LIBCPP_INLINE_VISIBILITY move_iterator(const move_iterator<_Up>& __u)
922 _LIBCPP_INLINE_VISIBILITY _Iter base() const {return __i;}
923 _LIBCPP_INLINE_VISIBILITY reference operator*() const {
924 return static_cast<reference>(*__i);
926 _LIBCPP_INLINE_VISIBILITY pointer operator->() const {
927 typename iterator_traits<iterator_type>::reference __ref = *__i;
930 _LIBCPP_INLINE_VISIBILITY move_iterator& operator++() {++__i; return *this;}
931 _LIBCPP_INLINE_VISIBILITY move_iterator operator++(int)
932 {move_iterator __tmp(*this); ++__i; return __tmp;}
933 _LIBCPP_INLINE_VISIBILITY move_iterator& operator--() {--__i; return *this;}
934 _LIBCPP_INLINE_VISIBILITY move_iterator operator--(int)
935 {move_iterator __tmp(*this); --__i; return __tmp;}
936 _LIBCPP_INLINE_VISIBILITY move_iterator operator+ (difference_type __n) const
937 {return move_iterator(__i + __n);}
938 _LIBCPP_INLINE_VISIBILITY move_iterator& operator+=(difference_type __n)
939 {__i += __n; return *this;}
940 _LIBCPP_INLINE_VISIBILITY move_iterator operator- (difference_type __n) const
941 {return move_iterator(__i - __n);}
942 _LIBCPP_INLINE_VISIBILITY move_iterator& operator-=(difference_type __n)
943 {__i -= __n; return *this;}
944 _LIBCPP_INLINE_VISIBILITY reference operator[](difference_type __n) const
946 return static_cast<reference>(__i[__n]);
950 template <class _Iter1, class _Iter2>
951 inline _LIBCPP_INLINE_VISIBILITY
953 operator==(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
955 return __x.base() == __y.base();
958 template <class _Iter1, class _Iter2>
959 inline _LIBCPP_INLINE_VISIBILITY
961 operator<(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
963 return __x.base() < __y.base();
966 template <class _Iter1, class _Iter2>
967 inline _LIBCPP_INLINE_VISIBILITY
969 operator!=(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
971 return __x.base() != __y.base();
974 template <class _Iter1, class _Iter2>
975 inline _LIBCPP_INLINE_VISIBILITY
977 operator>(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
979 return __x.base() > __y.base();
982 template <class _Iter1, class _Iter2>
983 inline _LIBCPP_INLINE_VISIBILITY
985 operator>=(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
987 return __x.base() >= __y.base();
990 template <class _Iter1, class _Iter2>
991 inline _LIBCPP_INLINE_VISIBILITY
993 operator<=(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
995 return __x.base() <= __y.base();
998 template <class _Iter1, class _Iter2>
999 inline _LIBCPP_INLINE_VISIBILITY
1000 typename move_iterator<_Iter1>::difference_type
1001 operator-(const move_iterator<_Iter1>& __x, const move_iterator<_Iter2>& __y)
1003 return __x.base() - __y.base();
1006 template <class _Iter>
1007 inline _LIBCPP_INLINE_VISIBILITY
1008 move_iterator<_Iter>
1009 operator+(typename move_iterator<_Iter>::difference_type __n, const move_iterator<_Iter>& __x)
1011 return move_iterator<_Iter>(__x.base() + __n);
1014 template <class _Iter>
1015 inline _LIBCPP_INLINE_VISIBILITY
1016 move_iterator<_Iter>
1017 make_move_iterator(const _Iter& __i)
1019 return move_iterator<_Iter>(__i);
1024 template <class _Iter> class __wrap_iter;
1026 template <class _Iter1, class _Iter2>
1027 _LIBCPP_INLINE_VISIBILITY
1029 operator==(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1031 template <class _Iter1, class _Iter2>
1032 _LIBCPP_INLINE_VISIBILITY
1034 operator<(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1036 template <class _Iter1, class _Iter2>
1037 _LIBCPP_INLINE_VISIBILITY
1039 operator!=(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1041 template <class _Iter1, class _Iter2>
1042 _LIBCPP_INLINE_VISIBILITY
1044 operator>(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1046 template <class _Iter1, class _Iter2>
1047 _LIBCPP_INLINE_VISIBILITY
1049 operator>=(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1051 template <class _Iter1, class _Iter2>
1052 _LIBCPP_INLINE_VISIBILITY
1054 operator<=(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1056 template <class _Iter1, class _Iter2>
1057 _LIBCPP_INLINE_VISIBILITY
1058 typename __wrap_iter<_Iter1>::difference_type
1059 operator-(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1061 template <class _Iter>
1062 _LIBCPP_INLINE_VISIBILITY
1064 operator+(typename __wrap_iter<_Iter>::difference_type, __wrap_iter<_Iter>) _NOEXCEPT;
1066 template <class _Ip, class _Op> _Op _LIBCPP_INLINE_VISIBILITY copy(_Ip, _Ip, _Op);
1067 template <class _B1, class _B2> _B2 _LIBCPP_INLINE_VISIBILITY copy_backward(_B1, _B1, _B2);
1068 template <class _Ip, class _Op> _Op _LIBCPP_INLINE_VISIBILITY move(_Ip, _Ip, _Op);
1069 template <class _B1, class _B2> _B2 _LIBCPP_INLINE_VISIBILITY move_backward(_B1, _B1, _B2);
1071 template <class _Tp>
1072 _LIBCPP_INLINE_VISIBILITY
1075 is_trivially_copy_assignable<_Tp>::value,
1078 __unwrap_iter(__wrap_iter<_Tp*>);
1080 template <class _Iter>
1084 typedef _Iter iterator_type;
1085 typedef typename iterator_traits<iterator_type>::iterator_category iterator_category;
1086 typedef typename iterator_traits<iterator_type>::value_type value_type;
1087 typedef typename iterator_traits<iterator_type>::difference_type difference_type;
1088 typedef typename iterator_traits<iterator_type>::pointer pointer;
1089 typedef typename iterator_traits<iterator_type>::reference reference;
1093 _LIBCPP_INLINE_VISIBILITY __wrap_iter() _NOEXCEPT
1095 #if _LIBCPP_DEBUG_LEVEL >= 2
1096 __get_db()->__insert_i(this);
1099 template <class _Up> _LIBCPP_INLINE_VISIBILITY __wrap_iter(const __wrap_iter<_Up>& __u,
1100 typename enable_if<is_convertible<_Up, iterator_type>::value>::type* = 0) _NOEXCEPT
1103 #if _LIBCPP_DEBUG_LEVEL >= 2
1104 __get_db()->__iterator_copy(this, &__u);
1107 #if _LIBCPP_DEBUG_LEVEL >= 2
1108 _LIBCPP_INLINE_VISIBILITY
1109 __wrap_iter(const __wrap_iter& __x)
1112 __get_db()->__iterator_copy(this, &__x);
1114 _LIBCPP_INLINE_VISIBILITY
1115 __wrap_iter& operator=(const __wrap_iter& __x)
1119 __get_db()->__iterator_copy(this, &__x);
1124 _LIBCPP_INLINE_VISIBILITY
1127 __get_db()->__erase_i(this);
1130 _LIBCPP_INLINE_VISIBILITY reference operator*() const _NOEXCEPT
1132 #if _LIBCPP_DEBUG_LEVEL >= 2
1133 _LIBCPP_ASSERT(__get_const_db()->__dereferenceable(this),
1134 "Attempted to dereference a non-dereferenceable iterator");
1138 _LIBCPP_INLINE_VISIBILITY pointer operator->() const _NOEXCEPT
1140 #if _LIBCPP_DEBUG_LEVEL >= 2
1141 _LIBCPP_ASSERT(__get_const_db()->__dereferenceable(this),
1142 "Attempted to dereference a non-dereferenceable iterator");
1144 return (pointer)&reinterpret_cast<const volatile char&>(*__i);
1146 _LIBCPP_INLINE_VISIBILITY __wrap_iter& operator++() _NOEXCEPT
1148 #if _LIBCPP_DEBUG_LEVEL >= 2
1149 _LIBCPP_ASSERT(__get_const_db()->__dereferenceable(this),
1150 "Attempted to increment non-incrementable iterator");
1155 _LIBCPP_INLINE_VISIBILITY __wrap_iter operator++(int) _NOEXCEPT
1156 {__wrap_iter __tmp(*this); ++(*this); return __tmp;}
1157 _LIBCPP_INLINE_VISIBILITY __wrap_iter& operator--() _NOEXCEPT
1159 #if _LIBCPP_DEBUG_LEVEL >= 2
1160 _LIBCPP_ASSERT(__get_const_db()->__decrementable(this),
1161 "Attempted to decrement non-decrementable iterator");
1166 _LIBCPP_INLINE_VISIBILITY __wrap_iter operator--(int) _NOEXCEPT
1167 {__wrap_iter __tmp(*this); --(*this); return __tmp;}
1168 _LIBCPP_INLINE_VISIBILITY __wrap_iter operator+ (difference_type __n) const _NOEXCEPT
1169 {__wrap_iter __w(*this); __w += __n; return __w;}
1170 _LIBCPP_INLINE_VISIBILITY __wrap_iter& operator+=(difference_type __n) _NOEXCEPT
1172 #if _LIBCPP_DEBUG_LEVEL >= 2
1173 _LIBCPP_ASSERT(__get_const_db()->__addable(this, __n),
1174 "Attempted to add/subtract iterator outside of valid range");
1179 _LIBCPP_INLINE_VISIBILITY __wrap_iter operator- (difference_type __n) const _NOEXCEPT
1180 {return *this + (-__n);}
1181 _LIBCPP_INLINE_VISIBILITY __wrap_iter& operator-=(difference_type __n) _NOEXCEPT
1182 {*this += -__n; return *this;}
1183 _LIBCPP_INLINE_VISIBILITY reference operator[](difference_type __n) const _NOEXCEPT
1185 #if _LIBCPP_DEBUG_LEVEL >= 2
1186 _LIBCPP_ASSERT(__get_const_db()->__subscriptable(this, __n),
1187 "Attempted to subscript iterator outside of valid range");
1192 _LIBCPP_INLINE_VISIBILITY iterator_type base() const _NOEXCEPT {return __i;}
1195 _LIBCPP_INLINE_VISIBILITY __wrap_iter(iterator_type __x) _NOEXCEPT : __i(__x) {}
1196 #if _LIBCPP_DEBUG_LEVEL >= 2
1197 _LIBCPP_INLINE_VISIBILITY __wrap_iter(const void* __p, iterator_type __x) : __i(__x)
1199 __get_db()->__insert_ic(this, __p);
1203 template <class _Up> friend class __wrap_iter;
1204 template <class _CharT, class _Traits, class _Alloc> friend class basic_string;
1205 template <class _Tp, class _Alloc> friend class vector;
1207 template <class _Iter1, class _Iter2>
1210 operator==(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1212 template <class _Iter1, class _Iter2>
1215 operator<(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1217 template <class _Iter1, class _Iter2>
1220 operator!=(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1222 template <class _Iter1, class _Iter2>
1225 operator>(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1227 template <class _Iter1, class _Iter2>
1230 operator>=(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1232 template <class _Iter1, class _Iter2>
1235 operator<=(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1237 template <class _Iter1, class _Iter2>
1239 typename __wrap_iter<_Iter1>::difference_type
1240 operator-(const __wrap_iter<_Iter1>&, const __wrap_iter<_Iter2>&) _NOEXCEPT;
1242 template <class _Iter1>
1245 operator+(typename __wrap_iter<_Iter1>::difference_type, __wrap_iter<_Iter1>) _NOEXCEPT;
1247 template <class _Ip, class _Op> friend _Op copy(_Ip, _Ip, _Op);
1248 template <class _B1, class _B2> friend _B2 copy_backward(_B1, _B1, _B2);
1249 template <class _Ip, class _Op> friend _Op move(_Ip, _Ip, _Op);
1250 template <class _B1, class _B2> friend _B2 move_backward(_B1, _B1, _B2);
1252 template <class _Tp>
1256 is_trivially_copy_assignable<_Tp>::value,
1259 __unwrap_iter(__wrap_iter<_Tp*>);
1262 template <class _Iter1, class _Iter2>
1263 inline _LIBCPP_INLINE_VISIBILITY
1265 operator==(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1267 #if _LIBCPP_DEBUG_LEVEL >= 2
1268 _LIBCPP_ASSERT(__get_const_db()->__comparable(&__x, &__y),
1269 "Attempted to compare incomparable iterators");
1271 return __x.base() == __y.base();
1274 template <class _Iter1, class _Iter2>
1275 inline _LIBCPP_INLINE_VISIBILITY
1277 operator<(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1279 #if _LIBCPP_DEBUG_LEVEL >= 2
1280 _LIBCPP_ASSERT(__get_const_db()->__comparable(&__x, &__y),
1281 "Attempted to compare incomparable iterators");
1283 return __x.base() < __y.base();
1286 template <class _Iter1, class _Iter2>
1287 inline _LIBCPP_INLINE_VISIBILITY
1289 operator!=(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1291 return !(__x == __y);
1294 template <class _Iter1, class _Iter2>
1295 inline _LIBCPP_INLINE_VISIBILITY
1297 operator>(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1302 template <class _Iter1, class _Iter2>
1303 inline _LIBCPP_INLINE_VISIBILITY
1305 operator>=(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1307 return !(__x < __y);
1310 template <class _Iter1, class _Iter2>
1311 inline _LIBCPP_INLINE_VISIBILITY
1313 operator<=(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1315 return !(__y < __x);
1318 template <class _Iter1>
1319 inline _LIBCPP_INLINE_VISIBILITY
1321 operator!=(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter1>& __y) _NOEXCEPT
1323 return !(__x == __y);
1326 template <class _Iter1>
1327 inline _LIBCPP_INLINE_VISIBILITY
1329 operator>(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter1>& __y) _NOEXCEPT
1334 template <class _Iter1>
1335 inline _LIBCPP_INLINE_VISIBILITY
1337 operator>=(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter1>& __y) _NOEXCEPT
1339 return !(__x < __y);
1342 template <class _Iter1>
1343 inline _LIBCPP_INLINE_VISIBILITY
1345 operator<=(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter1>& __y) _NOEXCEPT
1347 return !(__y < __x);
1350 template <class _Iter1, class _Iter2>
1351 inline _LIBCPP_INLINE_VISIBILITY
1352 typename __wrap_iter<_Iter1>::difference_type
1353 operator-(const __wrap_iter<_Iter1>& __x, const __wrap_iter<_Iter2>& __y) _NOEXCEPT
1355 #if _LIBCPP_DEBUG_LEVEL >= 2
1356 _LIBCPP_ASSERT(__get_const_db()->__comparable(&__x, &__y),
1357 "Attempted to subtract incompatible iterators");
1359 return __x.base() - __y.base();
1362 template <class _Iter>
1363 inline _LIBCPP_INLINE_VISIBILITY
1365 operator+(typename __wrap_iter<_Iter>::difference_type __n,
1366 __wrap_iter<_Iter> __x) _NOEXCEPT
1372 #ifdef _LIBCPP_DEBUG
1376 template <class _Container, class _Iter> class __debug_iter;
1378 template <class _Container, class _Iter1, class _Iter2>
1379 _LIBCPP_INLINE_VISIBILITY
1381 operator==(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1383 template <class _Container, class _Iter1, class _Iter2>
1384 _LIBCPP_INLINE_VISIBILITY
1386 operator<(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1388 template <class _Container, class _Iter1, class _Iter2>
1389 _LIBCPP_INLINE_VISIBILITY
1391 operator!=(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1393 template <class _Container, class _Iter1, class _Iter2>
1394 _LIBCPP_INLINE_VISIBILITY
1396 operator>(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1398 template <class _Container, class _Iter1, class _Iter2>
1399 _LIBCPP_INLINE_VISIBILITY
1401 operator>=(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1403 template <class _Container, class _Iter1, class _Iter2>
1404 _LIBCPP_INLINE_VISIBILITY
1406 operator<=(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1408 template <class _Container, class _Iter1, class _Iter2>
1409 _LIBCPP_INLINE_VISIBILITY
1410 typename __debug_iter<_Container, _Iter1>::difference_type
1411 operator-(const __debug_iter<_Container, _Iter1>&, const __debug_iter<_Container, _Iter2>&);
1413 template <class _Container, class _Iter>
1414 _LIBCPP_INLINE_VISIBILITY
1415 __debug_iter<_Container, _Iter>
1416 operator+(typename __debug_iter<_Container, _Iter>::difference_type, const __debug_iter<_Container, _Iter>&);
1418 template <class _Container, class _Iter>
1422 typedef _Iter iterator_type;
1423 typedef _Container __container_type;
1424 typedef typename iterator_traits<iterator_type>::iterator_category iterator_category;
1425 typedef typename iterator_traits<iterator_type>::value_type value_type;
1426 typedef typename iterator_traits<iterator_type>::difference_type difference_type;
1427 typedef typename iterator_traits<iterator_type>::pointer pointer;
1428 typedef typename iterator_traits<iterator_type>::reference reference;
1431 __debug_iter* __next;
1432 __container_type* __cont;
1435 _LIBCPP_INLINE_VISIBILITY __debug_iter() : __next(0), __cont(0) {}
1436 _LIBCPP_INLINE_VISIBILITY __debug_iter(const __debug_iter& __x)
1437 : __i(__x.base()), __next(0), __cont(0) {__set_owner(__x.__cont);}
1438 __debug_iter& operator=(const __debug_iter& __x);
1439 template <class _Up> _LIBCPP_INLINE_VISIBILITY __debug_iter(const __debug_iter<_Container, _Up>& __u,
1440 typename enable_if<is_convertible<_Up, iterator_type>::value>::type* = 0)
1441 : __i(__u.base()), __next(0), __cont(0) {__set_owner(__u.__cont);}
1442 _LIBCPP_INLINE_VISIBILITY ~__debug_iter() {__remove_owner();}
1443 _LIBCPP_INLINE_VISIBILITY reference operator*() const {assert(__is_deref()); return *__i;}
1444 _LIBCPP_INLINE_VISIBILITY pointer operator->() const {return &(operator*());}
1445 _LIBCPP_INLINE_VISIBILITY __debug_iter& operator++() {assert(__can_increment()); ++__i; return *this;}
1446 _LIBCPP_INLINE_VISIBILITY __debug_iter operator++(int)
1447 {__debug_iter __tmp(*this); operator++(); return __tmp;}
1448 _LIBCPP_INLINE_VISIBILITY __debug_iter& operator--() {assert(__can_decrement()); --__i; return *this;}
1449 _LIBCPP_INLINE_VISIBILITY __debug_iter operator--(int)
1450 {__debug_iter __tmp(*this); operator--(); return __tmp;}
1451 _LIBCPP_INLINE_VISIBILITY __debug_iter operator+ (difference_type __n) const
1452 {__debug_iter __t(*this); __t += __n; return __t;}
1453 __debug_iter& operator+=(difference_type __n);
1454 _LIBCPP_INLINE_VISIBILITY __debug_iter operator- (difference_type __n) const
1455 {__debug_iter __t(*this); __t -= __n; return __t;}
1456 _LIBCPP_INLINE_VISIBILITY __debug_iter& operator-=(difference_type __n)
1457 {*this += -__n; return *this;}
1458 _LIBCPP_INLINE_VISIBILITY reference operator[](difference_type __n) const
1459 {return *(*this + __n);}
1462 _LIBCPP_INLINE_VISIBILITY __debug_iter(const __container_type* __c, iterator_type __x)
1463 : __i(__x), __next(0), __cont(0) {__set_owner(__c);}
1464 _LIBCPP_INLINE_VISIBILITY iterator_type base() const {return __i;}
1466 void __set_owner(const __container_type* __c);
1467 void __remove_owner();
1468 static void __remove_all(__container_type* __c);
1469 static void swap(__container_type* __x, __container_type* __y);
1471 _LIBCPP_INLINE_VISIBILITY bool __is_deref() const
1472 {return __is_deref(__is_random_access_iterator<iterator_type>());}
1473 bool __is_deref(false_type) const;
1474 bool __is_deref(true_type) const;
1475 _LIBCPP_INLINE_VISIBILITY bool __can_decrement() const
1476 {return __can_decrement(integral_constant<int, is_pointer<iterator_type>::value ? 2:
1477 __is_random_access_iterator<iterator_type>::value ? 1 : 0>());}
1478 bool __can_decrement(integral_constant<int, 0>) const;
1479 bool __can_decrement(integral_constant<int, 1>) const;
1480 bool __can_decrement(integral_constant<int, 2>) const;
1481 _LIBCPP_INLINE_VISIBILITY bool __can_increment() const
1482 {return __can_increment(integral_constant<int, is_pointer<iterator_type>::value ? 2:
1483 __is_random_access_iterator<iterator_type>::value ? 1 : 0>());}
1484 bool __can_increment(integral_constant<int, 0>) const;
1485 bool __can_increment(integral_constant<int, 1>) const;
1486 bool __can_increment(integral_constant<int, 2>) const;
1488 _LIBCPP_INLINE_VISIBILITY bool __can_add(difference_type __n) const
1489 {return __can_add(__n, is_pointer<iterator_type>());}
1490 bool __can_add(difference_type __n, false_type) const;
1491 bool __can_add(difference_type __n, true_type) const;
1493 template <class _Cp, class _Up> friend class __debug_iter;
1494 friend class _Container::__self;
1496 template <class _Cp, class _Iter1, class _Iter2>
1499 operator==(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1501 template <class _Cp, class _Iter1, class _Iter2>
1504 operator<(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1506 template <class _Cp, class _Iter1, class _Iter2>
1509 operator!=(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1511 template <class _Cp, class _Iter1, class _Iter2>
1514 operator>(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1516 template <class _Cp, class _Iter1, class _Iter2>
1519 operator>=(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1521 template <class _Cp, class _Iter1, class _Iter2>
1524 operator<=(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1526 template <class _Cp, class _Iter1, class _Iter2>
1528 typename __debug_iter<_Cp, _Iter1>::difference_type
1529 operator-(const __debug_iter<_Cp, _Iter1>&, const __debug_iter<_Cp, _Iter2>&);
1531 template <class _Cp, class _Iter1>
1533 __debug_iter<_Cp, _Iter1>
1534 operator+(typename __debug_iter<_Cp, _Iter1>::difference_type, const __debug_iter<_Cp, _Iter1>&);
1537 template <class _Container, class _Iter>
1538 __debug_iter<_Container, _Iter>&
1539 __debug_iter<_Container, _Iter>::operator=(const __debug_iter& __x)
1545 __set_owner(__x.__cont);
1550 template <class _Container, class _Iter>
1552 __debug_iter<_Container, _Iter>::__set_owner(const __container_type* __c)
1554 __cont = const_cast<__container_type*>(__c);
1555 __debug_iter*& __head = __cont->__get_iterator_list(this);
1560 template <class _Container, class _Iter>
1562 __debug_iter<_Container, _Iter>::__remove_owner()
1566 __debug_iter*& __head = __cont->__get_iterator_list(this);
1571 __debug_iter* __prev = __head;
1572 for (__debug_iter* __p = __head->__next; __p != this; __p = __p->__next)
1574 __prev->__next = __next;
1580 template <class _Container, class _Iter>
1582 __debug_iter<_Container, _Iter>::__remove_all(__container_type* __c)
1584 __debug_iter*& __head = __c->__get_iterator_list((__debug_iter*)0);
1585 __debug_iter* __p = __head;
1590 __debug_iter* __n = __p->__next;
1596 template <class _Container, class _Iter>
1598 __debug_iter<_Container, _Iter>::swap(__container_type* __x, __container_type* __y)
1600 __debug_iter*& __head_x = __x->__get_iterator_list((__debug_iter*)0);
1601 __debug_iter*& __head_y = __y->__get_iterator_list((__debug_iter*)0);
1602 __debug_iter* __p = __head_x;
1603 __head_x = __head_y;
1605 for (__p = __head_x; __p; __p = __p->__next)
1607 for (__p = __head_y; __p; __p = __p->__next)
1611 template <class _Container, class _Iter>
1613 __debug_iter<_Container, _Iter>::__is_deref(false_type) const
1617 return __i != __cont->end().base();
1620 template <class _Container, class _Iter>
1622 __debug_iter<_Container, _Iter>::__is_deref(true_type) const
1626 return __i < __cont->end().base();
1629 template <class _Container, class _Iter>
1631 __debug_iter<_Container, _Iter>::__can_decrement(integral_constant<int, 0>) const
1635 return __i != __cont->begin().base();
1638 template <class _Container, class _Iter>
1640 __debug_iter<_Container, _Iter>::__can_decrement(integral_constant<int, 1>) const
1644 iterator_type __b = __cont->begin().base();
1645 return __b < __i && __i <= __b + __cont->size();
1648 template <class _Container, class _Iter>
1650 __debug_iter<_Container, _Iter>::__can_decrement(integral_constant<int, 2>) const
1654 iterator_type __b = __cont->begin().base();
1655 return __b < __i && __i <= __b + __cont->size();
1658 template <class _Container, class _Iter>
1660 __debug_iter<_Container, _Iter>::__can_increment(integral_constant<int, 0>) const
1664 return __i != __cont->end().base();
1667 template <class _Container, class _Iter>
1669 __debug_iter<_Container, _Iter>::__can_increment(integral_constant<int, 1>) const
1673 iterator_type __b = __cont->begin().base();
1674 return __b <= __i && __i < __b + __cont->size();
1677 template <class _Container, class _Iter>
1679 __debug_iter<_Container, _Iter>::__can_increment(integral_constant<int, 2>) const
1683 iterator_type __b = __cont->begin().base();
1684 return __b <= __i && __i < __b + __cont->size();
1687 template <class _Container, class _Iter>
1689 __debug_iter<_Container, _Iter>::__can_add(difference_type __n, false_type) const
1693 iterator_type __b = __cont->begin().base();
1694 iterator_type __j = __i + __n;
1695 return __b <= __j && __j <= __b + __cont->size();
1698 template <class _Container, class _Iter>
1700 __debug_iter<_Container, _Iter>::__can_add(difference_type __n, true_type) const
1704 iterator_type __b = __cont->begin().base();
1705 iterator_type __j = __i + __n;
1706 return __b <= __j && __j <= __b + __cont->size();
1709 template <class _Container, class _Iter>
1710 __debug_iter<_Container, _Iter>&
1711 __debug_iter<_Container, _Iter>::operator+=(difference_type __n)
1713 assert(__can_add(__n));
1718 template <class _Container, class _Iter1, class _Iter2>
1719 inline _LIBCPP_INLINE_VISIBILITY
1721 operator==(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1723 assert(__x.__cont && __x.__cont == __y.__cont);
1724 return __x.base() == __y.base();
1727 template <class _Container, class _Iter1, class _Iter2>
1728 inline _LIBCPP_INLINE_VISIBILITY
1730 operator!=(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1732 return !(__x == __y);
1735 template <class _Container, class _Iter1, class _Iter2>
1736 inline _LIBCPP_INLINE_VISIBILITY
1738 operator<(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1740 assert(__x.__cont && __x.__cont == __y.__cont);
1741 return __x.base() < __y.base();
1744 template <class _Container, class _Iter1, class _Iter2>
1745 inline _LIBCPP_INLINE_VISIBILITY
1747 operator>(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1752 template <class _Container, class _Iter1, class _Iter2>
1753 inline _LIBCPP_INLINE_VISIBILITY
1755 operator>=(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1757 return !(__x < __y);
1760 template <class _Container, class _Iter1, class _Iter2>
1761 inline _LIBCPP_INLINE_VISIBILITY
1763 operator<=(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1765 return !(__y < __x);
1768 template <class _Container, class _Iter1, class _Iter2>
1769 inline _LIBCPP_INLINE_VISIBILITY
1770 typename __debug_iter<_Container, _Iter1>::difference_type
1771 operator-(const __debug_iter<_Container, _Iter1>& __x, const __debug_iter<_Container, _Iter2>& __y)
1773 assert(__x.__cont && __x.__cont == __y.__cont);
1774 return __x.base() - __y.base();
1777 template <class _Container, class _Iter>
1778 inline _LIBCPP_INLINE_VISIBILITY
1779 __debug_iter<_Container, _Iter>
1780 operator+(typename __debug_iter<_Container, _Iter>::difference_type __n,
1781 const __debug_iter<_Container, _Iter>& __x)
1786 #endif // _LIBCPP_DEBUG
1788 #if !defined(_LIBCPP_HAS_NO_RVALUE_REFERENCES) && !defined(_LIBCPP_HAS_NO_TRAILING_RETURN)
1790 template <class _Cp>
1791 inline _LIBCPP_INLINE_VISIBILITY
1793 begin(_Cp& __c) -> decltype(__c.begin())
1798 template <class _Cp>
1799 inline _LIBCPP_INLINE_VISIBILITY
1801 begin(const _Cp& __c) -> decltype(__c.begin())
1806 template <class _Cp>
1807 inline _LIBCPP_INLINE_VISIBILITY
1809 end(_Cp& __c) -> decltype(__c.end())
1814 template <class _Cp>
1815 inline _LIBCPP_INLINE_VISIBILITY
1817 end(const _Cp& __c) -> decltype(__c.end())
1822 #else // !defined(_LIBCPP_HAS_NO_RVALUE_REFERENCES) && !defined(_LIBCPP_HAS_NO_TRAILING_RETURN)
1824 template <class _Cp>
1825 inline _LIBCPP_INLINE_VISIBILITY
1826 typename _Cp::iterator
1832 template <class _Cp>
1833 inline _LIBCPP_INLINE_VISIBILITY
1834 typename _Cp::const_iterator
1835 begin(const _Cp& __c)
1840 template <class _Cp>
1841 inline _LIBCPP_INLINE_VISIBILITY
1842 typename _Cp::iterator
1848 template <class _Cp>
1849 inline _LIBCPP_INLINE_VISIBILITY
1850 typename _Cp::const_iterator
1856 #endif // !defined(_LIBCPP_HAS_NO_RVALUE_REFERENCES) && !defined(_LIBCPP_HAS_NO_TRAILING_RETURN)
1858 template <class _Tp, size_t _Np>
1859 inline _LIBCPP_INLINE_VISIBILITY
1861 begin(_Tp (&__array)[_Np])
1866 template <class _Tp, size_t _Np>
1867 inline _LIBCPP_INLINE_VISIBILITY
1869 end(_Tp (&__array)[_Np])
1871 return __array + _Np;
1874 _LIBCPP_END_NAMESPACE_STD
1876 #endif // _LIBCPP_ITERATOR