std::experimental::ranges::for_each

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

實驗性

技術規範

檔案系統庫 (檔案系統 TS)

庫基礎 (庫基礎 TS)

庫基礎 2 (庫基礎 TS v2)

庫基礎 3 (庫基礎 TS v3)

並行性擴充套件 (並行性 TS)

並行性擴充套件 2 (並行性 TS v2)

併發性擴充套件 (併發性 TS)

併發擴充套件 2 (併發 TS v2)

概念 (概念 TS)

範圍 (範圍 TS)

反射 (反射 TS)

數學特殊函式 (特殊函式 TR)

實驗性非 TS

模式匹配

線性代數

std::execution

契約

2D 圖形

 

Ranges

概念

通用工具

迭代器

Ranges

演算法

 

演算法庫

非修改序列操作
all_ofany_ofnone_of countcount_if	findfind_iffind_if_not find_end find_first_of	adjacent_find search search_n mismatch	equal for_each lexicographical_compare
修改序列操作
copycopy_if copy_n copy_backward move move_backward	fill fill_n generate generate_n swap_ranges shuffle transform	removeremove_if replacereplace_if reverse rotate unique	remove_copyremove_copy_if replace_copyreplace_copy_if reverse_copy rotate_copy unique_copy
劃分操作
is_partitioned partition_point	partition partition_copy	stable_partition
排序操作
is_sorted is_sorted_until	sort stable_sort	partial_sort partial_sort_copy	nth_element
二分搜尋操作
lower_bound	upper_bound	binary_search	equal_range
集合操作（於已排序範圍上）
merge inplace_merge	includes	set_difference set_intersection	set_symmetric_difference set_union
堆操作
is_heap is_heap_until	make_heap sort_heap	push_heap pop_heap
最小/最大值操作
max max_element	min min_element	minmax minmax_element
Permutations
is_permutation	next_permutation	prev_permutation

 

定義於標頭檔案 <experimental/ranges/algorithm>
template< InputIterator I, Sentinel<I> S, class Proj = ranges::identity,           IndirectUnaryInvocable<projected<I, Proj>> Fun > ranges::tagged_pair<tag::in(I), tag::fun(Fun)>     for_each( I first, S last, Fun f, Proj proj = Proj{} );	(1)	(ranges TS)
template< InputRange R, class Proj = ranges::identity,           IndirectUnaryInvocable<projected<ranges::iterator_t<R>, Proj>> Fun > ranges::tagged_pair<tag::in(ranges::safe_iterator_t<R>), tag::fun(Fun)>     for_each( R&& r, Fun f, Proj proj = Proj{} );	(2)	(ranges TS)

1) 對範圍 [first, last) 中解引用每個迭代器的結果（即 ranges::invoke(f, ranges::invoke(proj, *i))）按順序呼叫給定函式物件 f，並應用投影 proj。

2) 同 (1)，但使用 r 作為源範圍，如同使用 ranges::begin(r) 作為 first 且 ranges::end(r) 作為 last。

對於兩個過載，如果迭代器型別是可變的，則 f 可以透過解引用迭代器修改範圍的元素。如果 f 返回結果，則該結果被忽略。

與其餘演算法不同，即使序列中的元素是可平凡複製的，也不允許 for_each 複製它們。

與 std::for_each（僅要求 MoveConstructible）不同，這些函式要求 Fun 模擬 CopyConstructible。

儘管上述宣告所示，演算法宣告的實際模板引數數量和順序未指定。因此，如果在呼叫演算法時使用顯式模板引數，程式可能不可移植。

引數

first, last	-	要應用函式的範圍
r	-	要應用函式的範圍
f	-	要應用於範圍內每個投影元素的的可呼叫物件
proj	-	應用於元素的投影

返回值

一個 tagged_pair 物件，包含以下兩個成員

• 第一個成員，帶有標籤 tag::in，是源範圍的結束迭代器（即型別為 I 且與哨兵 last 比較相等的迭代器）。
• 第二個成員，帶有標籤 tag::fun，從 std::move(f) 初始化（在所有函式物件應用之後）。

複雜度

正好 last - first 次 f 和 proj 的應用。

可能的實現

template<InputIterator I, Sentinel<I> S, class Proj = ranges::identity, IndirectUnaryInvocable<ranges::projected<I, Proj>> Fun> auto for_each(I first, S last, Fun f, Proj proj = Proj{}) -> ranges::tagged_pair<tag::in(I), tag::fun(Fun)> { for (; first != last; ++first) ranges::invoke(f, ranges::invoke(proj, *first)); return {std::move(first), std::move(f)}; }

另請參閱

transform	對一個範圍的元素應用函式 (函式模板)
range-for 迴圈(C++11)	對範圍執行迴圈
for_each	對範圍中的元素應用一元函式物件 (函式模板)
for_each_n (C++17)	對序列中的前 N 個元素應用函式物件 (函式模板)