Init

cppdraft/common/iter/access.md

@@ -0,0 +1,65 @@
+[common.iter.access]
+
+# 24 Iterators library [[iterators]](./#iterators)
+
+## 24.5 Iterator adaptors [[predef.iterators]](predef.iterators#common.iter.access)
+
+### 24.5.5 Common iterators [[iterators.common]](iterators.common#common.iter.access)
+
+#### 24.5.5.4 Accessors [common.iter.access]
+
+[🔗](#lib:operator*,common_iterator)
+
+`constexpr decltype(auto) operator*();
+constexpr decltype(auto) operator*() const
+  requires [dereferenceable](iterator.synopsis#concept:dereferenceable "24.2 Header <iterator>&nbsp;synopsis [iterator.synopsis]")<const I>;
+`
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5623)
+
+*Hardened preconditions*: holds_alternative<I>(v_) is true[.](#1.sentence-1)
+
+[2](#2)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5627)
+
+*Effects*: Equivalent to: return *get<I>(v_);
+
+[🔗](#lib:operator-%3e,common_iterator)
+
+`constexpr auto operator->() const
+  requires see below;
+`
+
+[3](#3)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5639)
+
+The expression in the [*requires-clause*](temp.pre#nt:requires-clause "13.1 Preamble [temp.pre]") is equivalent to:[indirectly_readable](iterator.concept.readable#concept:indirectly_readable "24.3.4.2 Concept indirectly_­readable [iterator.concept.readable]")<const I> &&(requires(const I& i) { i.operator->(); } || is_reference_v<iter_reference_t<I>> ||[constructible_from](concept.constructible#concept:constructible_from "18.4.11 Concept constructible_­from [concept.constructible]")<iter_value_t<I>, iter_reference_t<I>>)
+
+[4](#4)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5648)
+
+*Hardened preconditions*: holds_alternative<I>(v_) is true[.](#4.sentence-1)
+
+[5](#5)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5652)
+
+*Effects*: 
+
+- [(5.1)](#5.1)
+
+If I is a pointer type or if the expressionget<I>(v_).operator->() is
+well-formed, equivalent to: return get<I>(v_);
+
+- [(5.2)](#5.2)
+
+Otherwise, if iter_reference_t<I> is a reference type, equivalent to:auto&& tmp = *get<I>(v_);return addressof(tmp);
+
+- [(5.3)](#5.3)
+
+Otherwise, equivalent to:return *proxy*(*get<I>(v_)); where*proxy* is the exposition-only class:class *proxy* { iter_value_t<I> keep_; constexpr *proxy*(iter_reference_t<I>&& x): keep_(std::move(x)) {}public:constexpr const iter_value_t<I>* operator->() const noexcept {return addressof(keep_); }};

cppdraft/common/iter/cmp.md

@@ -0,0 +1,71 @@
+[common.iter.cmp]
+
+# 24 Iterators library [[iterators]](./#iterators)
+
+## 24.5 Iterator adaptors [[predef.iterators]](predef.iterators#common.iter.cmp)
+
+### 24.5.5 Common iterators [[iterators.common]](iterators.common#common.iter.cmp)
+
+#### 24.5.5.6 Comparisons [common.iter.cmp]
+
+[🔗](#lib:operator==,common_iterator)
+
+`template<class I2, [sentinel_for](iterator.concept.sentinel#concept:sentinel_for "24.3.4.7 Concept sentinel_­for [iterator.concept.sentinel]")<I> S2>
+  requires [sentinel_for](iterator.concept.sentinel#concept:sentinel_for "24.3.4.7 Concept sentinel_­for [iterator.concept.sentinel]")<S, I2>
+friend constexpr bool operator==(
+  const common_iterator& x, const common_iterator<I2, S2>& y);
+`
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5767)
+
+*Hardened preconditions*: x.v_.valueless_by_exception() and y.v_.valueless_by_exception() are each false[.](#1.sentence-1)
+
+[2](#2)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5772)
+
+*Returns*: true if i == j,
+and otherwise get<i>(x.v_) == get<j>(y.v_),
+where i is x.v_.index() and j is y.v_.index()[.](#2.sentence-1)
+
+[🔗](#lib:operator==,common_iterator_)
+
+`template<class I2, [sentinel_for](iterator.concept.sentinel#concept:sentinel_for "24.3.4.7 Concept sentinel_­for [iterator.concept.sentinel]")<I> S2>
+  requires [sentinel_for](iterator.concept.sentinel#concept:sentinel_for "24.3.4.7 Concept sentinel_­for [iterator.concept.sentinel]")<S, I2> && [equality_comparable_with](concept.equalitycomparable#concept:equality_comparable_with "18.5.4 Concept equality_­comparable [concept.equalitycomparable]")<I, I2>
+friend constexpr bool operator==(
+  const common_iterator& x, const common_iterator<I2, S2>& y);
+`
+
+[3](#3)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5788)
+
+*Hardened preconditions*: x.v_.valueless_by_exception() and y.v_.valueless_by_exception() are each false[.](#3.sentence-1)
+
+[4](#4)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5793)
+
+*Returns*: true if i and j are each 1, and otherwiseget<i>(x.v_) == get<j>(y.v_), wherei is x.v_.index() and j is y.v_.index()[.](#4.sentence-1)
+
+[🔗](#lib:operator-,common_iterator)
+
+`template<[sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_­sentinel_­for [iterator.concept.sizedsentinel]")<I> I2, [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_­sentinel_­for [iterator.concept.sizedsentinel]")<I> S2>
+  requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_­sentinel_­for [iterator.concept.sizedsentinel]")<S, I2>
+friend constexpr iter_difference_t<I2> operator-(
+  const common_iterator& x, const common_iterator<I2, S2>& y);
+`
+
+[5](#5)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5809)
+
+*Hardened preconditions*: x.v_.valueless_by_exception() and y.v_.valueless_by_exception() are each false[.](#5.sentence-1)
+
+[6](#6)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5814)
+
+*Returns*: 0 if i and j are each 1, and otherwiseget<i>(x.v_) - get<j>(y.v_), wherei is x.v_.index() and j is y.v_.index()[.](#6.sentence-1)

cppdraft/common/iter/const.md

@@ -0,0 +1,87 @@
+[common.iter.const]
+
+# 24 Iterators library [[iterators]](./#iterators)
+
+## 24.5 Iterator adaptors [[predef.iterators]](predef.iterators#common.iter.const)
+
+### 24.5.5 Common iterators [[iterators.common]](iterators.common#common.iter.const)
+
+#### 24.5.5.3 Constructors and conversions [common.iter.const]
+
+[🔗](#lib:common_iterator,constructor)
+
+`constexpr common_iterator(I i);
+`
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5548)
+
+*Effects*: Initializes v_ as if by v_{in_place_type<I>, std​::​move(i)}[.](#1.sentence-1)
+
+[🔗](#lib:common_iterator,constructor_)
+
+`constexpr common_iterator(S s);
+`
+
+[2](#2)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5559)
+
+*Effects*: Initializes v_ as if byv_{in_place_type<S>, std​::​move(s)}[.](#2.sentence-1)
+
+[🔗](#lib:common_iterator,constructor__)
+
+`template<class I2, class S2>
+  requires [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_­to [concept.convertible]")<const I2&, I> && [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_­to [concept.convertible]")<const S2&, S>
+    constexpr common_iterator(const common_iterator<I2, S2>& x);
+`
+
+[3](#3)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5573)
+
+*Hardened preconditions*: x.v_.valueless_by_exception() is false[.](#3.sentence-1)
+
+[4](#4)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5577)
+
+*Effects*: Initializes v_ as if byv_{in_place_index<i>, get<i>(x.v_)},
+where i is x.v_.index()[.](#4.sentence-1)
+
+[🔗](#lib:operator=,common_iterator)
+
+`template<class I2, class S2>
+  requires [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_­to [concept.convertible]")<const I2&, I> && [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_­to [concept.convertible]")<const S2&, S> &&
+           [assignable_from](concept.assignable#concept:assignable_from "18.4.8 Concept assignable_­from [concept.assignable]")<I&, const I2&> && [assignable_from](concept.assignable#concept:assignable_from "18.4.8 Concept assignable_­from [concept.assignable]")<S&, const S2&>
+    constexpr common_iterator& operator=(const common_iterator<I2, S2>& x);
+`
+
+[5](#5)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5593)
+
+*Hardened preconditions*: x.v_.valueless_by_exception() is false[.](#5.sentence-1)
+
+[6](#6)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5597)
+
+*Effects*: Equivalent to:
+
+- [(6.1)](#6.1)
+
+  If v_.index() == x.v_.index(), thenget<i>(v_) = get<i>(x.v_)[.](#6.1.sentence-1)
+
+- [(6.2)](#6.2)
+
+  Otherwise, v_.emplace<i>(get<i>(x.v_))[.](#6.2.sentence-1)
+
+where i is x.v_.index()[.](#6.sentence-2)
+
+[7](#7)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5608)
+
+*Returns*: *this[.](#7.sentence-1)

cppdraft/common/iter/cust.md

@@ -0,0 +1,47 @@
+[common.iter.cust]
+
+# 24 Iterators library [[iterators]](./#iterators)
+
+## 24.5 Iterator adaptors [[predef.iterators]](predef.iterators#common.iter.cust)
+
+### 24.5.5 Common iterators [[iterators.common]](iterators.common#common.iter.cust)
+
+#### 24.5.5.7 Customizations [common.iter.cust]
+
+[🔗](#lib:iter_move,common_iterator)
+
+`friend constexpr decltype(auto) iter_move(const common_iterator& i)
+  noexcept(noexcept(ranges::iter_move(declval<const I&>())))
+    requires [input_iterator](iterator.concept.input#concept:input_iterator "24.3.4.9 Concept input_­iterator [iterator.concept.input]")<I>;
+`
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5831)
+
+*Hardened preconditions*: holds_alternative<I>(i.v_) is true[.](#1.sentence-1)
+
+[2](#2)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5835)
+
+*Effects*: Equivalent to: return ranges​::​iter_move(get<I>(i.v_));
+
+[🔗](#lib:iter_swap,common_iterator)
+
+`template<[indirectly_swappable](alg.req.ind.swap#concept:indirectly_swappable "24.3.7.4 Concept indirectly_­swappable [alg.req.ind.swap]")<I> I2, class S2>
+  friend constexpr void iter_swap(const common_iterator& x, const common_iterator<I2, S2>& y)
+    noexcept(noexcept(ranges::iter_swap(declval<const I&>(), declval<const I2&>())));
+`
+
+[3](#3)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5848)
+
+*Hardened preconditions*: holds_alternative<I>(x.v_) and holds_alternative<I2>(y.v_) are each true[.](#3.sentence-1)
+
+[4](#4)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5853)
+
+*Effects*: Equivalent to ranges​::​iter_swap(get<I>(x.v_), get<I2>(y.v_))[.](#4.sentence-1)

cppdraft/common/iter/nav.md

@@ -0,0 +1,54 @@
+[common.iter.nav]
+
+# 24 Iterators library [[iterators]](./#iterators)
+
+## 24.5 Iterator adaptors [[predef.iterators]](predef.iterators#common.iter.nav)
+
+### 24.5.5 Common iterators [[iterators.common]](iterators.common#common.iter.nav)
+
+#### 24.5.5.5 Navigation [common.iter.nav]
+
+[🔗](#lib:operator++,common_iterator)
+
+`constexpr common_iterator& operator++();
+`
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5693)
+
+*Hardened preconditions*: holds_alternative<I>(v_) is true[.](#1.sentence-1)
+
+[2](#2)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5697)
+
+*Effects*: Equivalent to ++get<I>(v_)[.](#2.sentence-1)
+
+[3](#3)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5701)
+
+*Returns*: *this[.](#3.sentence-1)
+
+[🔗](#lib:operator++,common_iterator_)
+
+`constexpr decltype(auto) operator++(int);
+`
+
+[4](#4)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5712)
+
+*Hardened preconditions*: holds_alternative<I>(v_) is true[.](#4.sentence-1)
+
+[5](#5)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5716)
+
+*Effects*: If I models [forward_iterator](iterator.concept.forward#concept:forward_iterator "24.3.4.11 Concept forward_­iterator [iterator.concept.forward]"), equivalent to:common_iterator tmp = *this;++*this;return tmp;
+
+Otherwise, ifrequires(I& i) { { *i++ } -> [*can-reference*](iterator.synopsis#concept:can-reference "24.2 Header <iterator>&nbsp;synopsis [iterator.synopsis]"); } is true or[indirectly_readable](iterator.concept.readable#concept:indirectly_readable "24.3.4.2 Concept indirectly_­readable [iterator.concept.readable]")<I> && [constructible_from](concept.constructible#concept:constructible_from "18.4.11 Concept constructible_­from [concept.constructible]")<iter_value_t<I>, iter_reference_t<I>> &&[move_constructible](concept.moveconstructible#concept:move_constructible "18.4.13 Concept move_­constructible [concept.moveconstructible]")<iter_value_t<I>> is false,
+equivalent to:return get<I>(v_)++;
+
+Otherwise, equivalent to:*postfix-proxy* p(**this);++*this;return p; where *postfix-proxy* is the exposition-only class:class *postfix-proxy* { iter_value_t<I> keep_; constexpr *postfix-proxy*(iter_reference_t<I>&& x): keep_(std::forward<iter_reference_t<I>>(x)) {}public:constexpr const iter_value_t<I>& operator*() const noexcept {return keep_; }};

cppdraft/common/iter/types.md

@@ -0,0 +1,39 @@
+[common.iter.types]
+
+# 24 Iterators library [[iterators]](./#iterators)
+
+## 24.5 Iterator adaptors [[predef.iterators]](predef.iterators#common.iter.types)
+
+### 24.5.5 Common iterators [[iterators.common]](iterators.common#common.iter.types)
+
+#### 24.5.5.2 Associated types [common.iter.types]
+
+[1](#1)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5513)
+
+The nested [*typedef-name*](dcl.typedef#nt:typedef-name "9.2.4 The typedef specifier [dcl.typedef]") iterator_category of
+the specialization of iterator_traits for common_iterator<I, S> is defined if and only if iter_difference_t<I> is an integral type[.](#1.sentence-1)
+
+In that case,iterator_category denotes forward_iterator_tag if
+the [*qualified-id*](expr.prim.id.qual#nt:qualified-id "7.5.5.3 Qualified names [expr.prim.id.qual]") iterator_traits<I>​::​iterator_category is valid and denotes a type that
+models [derived_from](concept.derived#concept:derived_from "18.4.3 Concept derived_­from [concept.derived]")<forward_iterator_tag>;
+otherwise it denotes input_iterator_tag[.](#1.sentence-2)
+
+[2](#2)
+
+[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/iterators.tex#L5524)
+
+The remaining nested [*typedef-name*](dcl.typedef#nt:typedef-name "9.2.4 The typedef specifier [dcl.typedef]")*s* of the specialization ofiterator_traits for common_iterator<I, S> are defined as follows:
+
+- [(2.1)](#2.1)
+
+  iterator_concept denotes forward_iterator_tag if I models [forward_iterator](iterator.concept.forward#concept:forward_iterator "24.3.4.11 Concept forward_­iterator [iterator.concept.forward]");
+otherwise it denotes input_iterator_tag[.](#2.1.sentence-1)
+
+- [(2.2)](#2.2)
+
+  Let a denote an lvalue of type const common_iterator<I, S>[.](#2.2.sentence-1)
+  If the expression a.operator->() is well-formed,
+then pointer denotes decltype(a.operator->())[.](#2.2.sentence-2)
+  Otherwise, pointer denotes void[.](#2.2.sentence-3)