Init
This commit is contained in:
294
cppdraft/range/transform/iterator.md
Normal file
294
cppdraft/range/transform/iterator.md
Normal file
File diff suppressed because one or more lines are too long
32
cppdraft/range/transform/overview.md
Normal file
32
cppdraft/range/transform/overview.md
Normal file
@@ -0,0 +1,32 @@
|
||||
[range.transform.overview]
|
||||
|
||||
# 25 Ranges library [[ranges]](./#ranges)
|
||||
|
||||
## 25.7 Range adaptors [[range.adaptors]](range.adaptors#range.transform.overview)
|
||||
|
||||
### 25.7.9 Transform view [[range.transform]](range.transform#overview)
|
||||
|
||||
#### 25.7.9.1 Overview [range.transform.overview]
|
||||
|
||||
[1](#1)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5177)
|
||||
|
||||
transform_view presents
|
||||
a view of an underlying sequence after
|
||||
applying a transformation function to each element[.](#1.sentence-1)
|
||||
|
||||
[2](#2)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5182)
|
||||
|
||||
The name views::transform denotes a
|
||||
range adaptor object ([[range.adaptor.object]](range.adaptor.object "25.7.2 Range adaptor objects"))[.](#2.sentence-1)
|
||||
|
||||
Given subexpressions E and F, the expressionviews::transform(E, F) is expression-equivalent totransform_view(E, F)[.](#2.sentence-2)
|
||||
|
||||
[3](#3)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5190)
|
||||
|
||||
[*Example [1](#example-1)*: vector<int> is{ 0, 1, 2, 3, 4 };auto squares = views::transform(is, [](int i) { return i * i; });for (int i : squares) cout << i << ' '; // prints 0 1 4 9 16 â *end example*]
|
||||
88
cppdraft/range/transform/sentinel.md
Normal file
88
cppdraft/range/transform/sentinel.md
Normal file
@@ -0,0 +1,88 @@
|
||||
[range.transform.sentinel]
|
||||
|
||||
# 25 Ranges library [[ranges]](./#ranges)
|
||||
|
||||
## 25.7 Range adaptors [[range.adaptors]](range.adaptors#range.transform.sentinel)
|
||||
|
||||
### 25.7.9 Transform view [[range.transform]](range.transform#sentinel)
|
||||
|
||||
#### 25.7.9.4 Class template transform_view::*sentinel* [range.transform.sentinel]
|
||||
|
||||
[ð](#lib:transform_view::sentinel)
|
||||
|
||||
namespace std::ranges {template<[input_range](range.refinements#concept:input_range "25.4.6 Other range refinements [range.refinements]") V, [move_constructible](concept.moveconstructible#concept:move_constructible "18.4.13 Concept move_constructible [concept.moveconstructible]") F>requires [view](range.view#concept:view "25.4.5 Views [range.view]")<V> && is_object_v<F> &&[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<F&, range_reference_t<V>> &&[*can-reference*](iterator.synopsis#concept:can-reference "24.2 Header <iterator> synopsis [iterator.synopsis]")<invoke_result_t<F&, range_reference_t<V>>>template<bool Const>class transform_view<V, F>::*sentinel* {private:using *Parent* = *maybe-const*<Const, transform_view>; // *exposition only*using *Base* = *maybe-const*<Const, V>; // *exposition only* sentinel_t<*Base*> *end_* = sentinel_t<*Base*>(); // *exposition only*public:*sentinel*() = default; constexpr explicit *sentinel*(sentinel_t<*Base*> end); constexpr *sentinel*(*sentinel*<!Const> i)requires Const && [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_to [concept.convertible]")<sentinel_t<V>, sentinel_t<*Base*>>; constexpr sentinel_t<*Base*> base() const; template<bool OtherConst>requires [sentinel_for](iterator.concept.sentinel#concept:sentinel_for "24.3.4.7 Concept sentinel_for [iterator.concept.sentinel]")<sentinel_t<*Base*>, iterator_t<*maybe-const*<OtherConst, V>>>friend constexpr bool operator==(const *iterator*<OtherConst>& x, const *sentinel*& y); template<bool OtherConst>requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_sentinel_for [iterator.concept.sizedsentinel]")<sentinel_t<*Base*>, iterator_t<*maybe-const*<OtherConst, V>>>friend constexpr range_difference_t<*maybe-const*<OtherConst, V>>operator-(const *iterator*<OtherConst>& x, const *sentinel*& y); template<bool OtherConst>requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_sentinel_for [iterator.concept.sizedsentinel]")<sentinel_t<*Base*>, iterator_t<*maybe-const*<OtherConst, V>>>friend constexpr range_difference_t<*maybe-const*<OtherConst, V>>operator-(const *sentinel*& y, const *iterator*<OtherConst>& x); };}
|
||||
|
||||
[ð](#lib:transform_view::sentinel,constructor)
|
||||
|
||||
`constexpr explicit sentinel(sentinel_t<Base> end);
|
||||
`
|
||||
|
||||
[1](#1)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5791)
|
||||
|
||||
*Effects*: Initializes *end_* with end[.](#1.sentence-1)
|
||||
|
||||
[ð](#lib:transform_view::sentinel,constructor_)
|
||||
|
||||
`constexpr sentinel(sentinel<!Const> i)
|
||||
requires Const && [convertible_to](concept.convertible#concept:convertible_to "18.4.4 Concept convertible_to [concept.convertible]")<sentinel_t<V>, sentinel_t<Base>>;
|
||||
`
|
||||
|
||||
[2](#2)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5803)
|
||||
|
||||
*Effects*: Initializes *end_* with std::move(i.*end_*)[.](#2.sentence-1)
|
||||
|
||||
[ð](#lib:base,transform_view::sentinel)
|
||||
|
||||
`constexpr sentinel_t<Base> base() const;
|
||||
`
|
||||
|
||||
[3](#3)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5814)
|
||||
|
||||
*Effects*: Equivalent to: return *end_*;
|
||||
|
||||
[ð](#lib:operator==,transform_view::sentinel)
|
||||
|
||||
`template<bool OtherConst>
|
||||
requires [sentinel_for](iterator.concept.sentinel#concept:sentinel_for "24.3.4.7 Concept sentinel_for [iterator.concept.sentinel]")<sentinel_t<Base>, iterator_t<maybe-const<OtherConst, V>>>
|
||||
friend constexpr bool operator==(const iterator<OtherConst>& x, const sentinel& y);
|
||||
`
|
||||
|
||||
[4](#4)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5827)
|
||||
|
||||
*Effects*: Equivalent to: return x.*current_* == y.*end_*;
|
||||
|
||||
[ð](#lib:operator-,transform_view::sentinel)
|
||||
|
||||
`template<bool OtherConst>
|
||||
requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_sentinel_for [iterator.concept.sizedsentinel]")<sentinel_t<Base>, iterator_t<maybe-const<OtherConst, V>>>
|
||||
friend constexpr range_difference_t<maybe-const<OtherConst, V>>
|
||||
operator-(const iterator<OtherConst>& x, const sentinel& y);
|
||||
`
|
||||
|
||||
[5](#5)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5841)
|
||||
|
||||
*Effects*: Equivalent to: return x.*current_* - y.*end_*;
|
||||
|
||||
[ð](#lib:operator-,transform_view::sentinel_)
|
||||
|
||||
`template<bool OtherConst>
|
||||
requires [sized_sentinel_for](iterator.concept.sizedsentinel#concept:sized_sentinel_for "24.3.4.8 Concept sized_sentinel_for [iterator.concept.sizedsentinel]")<sentinel_t<Base>, iterator_t<maybe-const<OtherConst, V>>>
|
||||
friend constexpr range_difference_t<maybe-const<OtherConst, V>>
|
||||
operator-(const sentinel& y, const iterator<OtherConst>& x);
|
||||
`
|
||||
|
||||
[6](#6)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5855)
|
||||
|
||||
*Effects*: Equivalent to: return y.*end_* - x.*current_*;
|
||||
96
cppdraft/range/transform/view.md
Normal file
96
cppdraft/range/transform/view.md
Normal file
@@ -0,0 +1,96 @@
|
||||
[range.transform.view]
|
||||
|
||||
# 25 Ranges library [[ranges]](./#ranges)
|
||||
|
||||
## 25.7 Range adaptors [[range.adaptors]](range.adaptors#range.transform.view)
|
||||
|
||||
### 25.7.9 Transform view [[range.transform]](range.transform#view)
|
||||
|
||||
#### 25.7.9.2 Class template transform_view [range.transform.view]
|
||||
|
||||
[ð](#lib:transform_view)
|
||||
|
||||
namespace std::ranges {template<[input_range](range.refinements#concept:input_range "25.4.6 Other range refinements [range.refinements]") V, [move_constructible](concept.moveconstructible#concept:move_constructible "18.4.13 Concept move_constructible [concept.moveconstructible]") F>requires [view](range.view#concept:view "25.4.5 Views [range.view]")<V> && is_object_v<F> &&[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<F&, range_reference_t<V>> &&[*can-reference*](iterator.synopsis#concept:can-reference "24.2 Header <iterator> synopsis [iterator.synopsis]")<invoke_result_t<F&, range_reference_t<V>>>class transform_view : public view_interface<transform_view<V, F>> {private:// [[range.transform.iterator]](range.transform.iterator "25.7.9.3 Class template transform_view::iterator"), class template transform_view::*iterator*template<bool> struct *iterator*; // *exposition only*// [[range.transform.sentinel]](range.transform.sentinel "25.7.9.4 Class template transform_view::sentinel"), class template transform_view::*sentinel*template<bool> struct *sentinel*; // *exposition only* V *base_* = V(); // *exposition only**movable-box*<F> *fun_*; // *exposition only*public: transform_view() requires [default_initializable](concept.default.init#concept:default_initializable "18.4.12 Concept default_initializable [concept.default.init]")<V> && [default_initializable](concept.default.init#concept:default_initializable "18.4.12 Concept default_initializable [concept.default.init]")<F> = default; constexpr explicit transform_view(V base, F fun); constexpr V base() const & requires [copy_constructible](concept.copyconstructible#concept:copy_constructible "18.4.14 Concept copy_constructible [concept.copyconstructible]")<V> { return *base_*; }constexpr V base() && { return std::move(*base_*); }constexpr *iterator*<false> begin(); constexpr *iterator*<true> begin() constrequires [range](range.range#concept:range "25.4.2 Ranges [range.range]")<const V> &&[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<const F&, range_reference_t<const V>>; constexpr *sentinel*<false> end(); constexpr *iterator*<false> end() requires [common_range](range.refinements#concept:common_range "25.4.6 Other range refinements [range.refinements]")<V>; constexpr *sentinel*<true> end() constrequires [range](range.range#concept:range "25.4.2 Ranges [range.range]")<const V> &&[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<const F&, range_reference_t<const V>>; constexpr *iterator*<true> end() constrequires [common_range](range.refinements#concept:common_range "25.4.6 Other range refinements [range.refinements]")<const V> &&[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<const F&, range_reference_t<const V>>; constexpr auto size() requires [sized_range](range.sized#concept:sized_range "25.4.4 Sized ranges [range.sized]")<V> { return ranges::size(*base_*); }constexpr auto size() const requires [sized_range](range.sized#concept:sized_range "25.4.4 Sized ranges [range.sized]")<const V>{ return ranges::size(*base_*); }constexpr auto reserve_hint() requires [approximately_sized_range](range.approximately.sized#concept:approximately_sized_range "25.4.3 Approximately sized ranges [range.approximately.sized]")<V>{ return ranges::reserve_hint(*base_*); }constexpr auto reserve_hint() const requires [approximately_sized_range](range.approximately.sized#concept:approximately_sized_range "25.4.3 Approximately sized ranges [range.approximately.sized]")<const V>{ return ranges::reserve_hint(*base_*); }}; template<class R, class F> transform_view(R&&, F) -> transform_view<views::all_t<R>, F>;}
|
||||
|
||||
[ð](#lib:transform_view,constructor)
|
||||
|
||||
`constexpr explicit transform_view(V base, F fun);
|
||||
`
|
||||
|
||||
[1](#1)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5264)
|
||||
|
||||
*Effects*: Initializes *base_* with std::move(base) and*fun_* with std::move(fun)[.](#1.sentence-1)
|
||||
|
||||
[ð](#lib:begin,transform_view)
|
||||
|
||||
`constexpr iterator<false> begin();
|
||||
`
|
||||
|
||||
[2](#2)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5276)
|
||||
|
||||
*Effects*: Equivalent to:return *iterator*<false>{*this, ranges::begin(*base_*)};
|
||||
|
||||
[ð](#lib:begin,transform_view_)
|
||||
|
||||
`constexpr iterator<true> begin() const
|
||||
requires [range](range.range#concept:range "25.4.2 Ranges [range.range]")<const V> &&
|
||||
[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<const F&, range_reference_t<const V>>;
|
||||
`
|
||||
|
||||
[3](#3)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5292)
|
||||
|
||||
*Effects*: Equivalent to:return *iterator*<true>{*this, ranges::begin(*base_*)};
|
||||
|
||||
[ð](#lib:end,transform_view)
|
||||
|
||||
`constexpr sentinel<false> end();
|
||||
`
|
||||
|
||||
[4](#4)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5306)
|
||||
|
||||
*Effects*: Equivalent to:return *sentinel*<false>{ranges::end(*base_*)};
|
||||
|
||||
[ð](#lib:end,transform_view_)
|
||||
|
||||
`constexpr iterator<false> end() requires [common_range](range.refinements#concept:common_range "25.4.6 Other range refinements [range.refinements]")<V>;
|
||||
`
|
||||
|
||||
[5](#5)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5320)
|
||||
|
||||
*Effects*: Equivalent to:return *iterator*<false>{*this, ranges::end(*base_*)};
|
||||
|
||||
[ð](#lib:end,transform_view__)
|
||||
|
||||
`constexpr sentinel<true> end() const
|
||||
requires [range](range.range#concept:range "25.4.2 Ranges [range.range]")<const V> &&
|
||||
[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<const F&, range_reference_t<const V>>;
|
||||
`
|
||||
|
||||
[6](#6)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5336)
|
||||
|
||||
*Effects*: Equivalent to:return *sentinel*<true>{ranges::end(*base_*)};
|
||||
|
||||
[ð](#lib:end,transform_view___)
|
||||
|
||||
`constexpr iterator<true> end() const
|
||||
requires [common_range](range.refinements#concept:common_range "25.4.6 Other range refinements [range.refinements]")<const V> &&
|
||||
[regular_invocable](concept.regularinvocable#concept:regular_invocable "18.7.3 Concept regular_invocable [concept.regularinvocable]")<const F&, range_reference_t<const V>>;
|
||||
`
|
||||
|
||||
[7](#7)
|
||||
|
||||
[#](http://github.com/Eelis/draft/tree/9adde4bc1c62ec234483e63ea3b70a59724c745a/source/ranges.tex#L5352)
|
||||
|
||||
*Effects*: Equivalent to:return *iterator*<true>{*this, ranges::end(*base_*)};
|
||||
Reference in New Issue
Block a user