iter_move (std::counted_iterator)
| Iterator concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator primitives | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Algorithm concepts and utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Indirect callable concepts | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Common algorithm requirements | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Utilities | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Iterator adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
| Non-member functions | ||||
|
(C++20)
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
(C++20)
|
||||
|
iter_move
(C++20)
|
||||
|
(C++20)
|
||||
| Helper classes | ||||
|
friend
constexpr
decltype
(
auto
)
iter_move
(
const
std::
counted_iterator
&
i
)
noexcept
(
noexcept
(
ranges::
iter_move
(
i.
base
(
)
)
)
)
|
(начиная с C++20) | |
Приводит результат разыменования базового итератора к соответствующему типу rvalue-ссылки.
Тело функции эквивалентно return ranges:: iter_move ( i. base ( ) ) ; .
Эта функция не видна при обычном unqualified или qualified lookup , и может быть найдена только с помощью argument-dependent lookup , когда std:: counted_iterator < I > является ассоциированным классом аргументов.
Если i. count ( ) равно 0 , поведение не определено.
Содержание |
Параметры
| i | - | адаптер исходного итератора |
Возвращаемое значение
Ссылка на rvalue или временный объект prvalue.
Сложность
Константа.
Пример
#include <iomanip> #include <iostream> #include <iterator> #include <string> #include <vector> void print(auto const& rem, auto const& v) { std::cout << rem << '[' << size(v) << "] {"; for (char comma[]{0, ' ', 0}; auto const& s : v) std::cout << comma << std::quoted(s), *comma = ','; std::cout << "}\n"; } int main() { std::vector<std::string> p{"Alpha", "Bravo", "Charlie"}, q; print("p", p); print("q", q); using RI = std::counted_iterator<std::vector<std::string>::iterator>; for (RI iter{p.begin(), 2}; iter != std::default_sentinel; ++iter) q.emplace_back(/* ADL */ iter_move(iter)); print("p", p); print("q", q); }
Возможный вывод:
p[3] {"Alpha", "Bravo", "Charlie"}
q[0] {}
p[3] {"", "", "Charlie"}
q[2] {"Alpha", "Bravo"}
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применяется к | Поведение в опубликованной версии | Исправленное поведение |
|---|---|---|---|
| LWG 3953 | C++20 | тип возвращаемого значения был std:: iter_rvalue_reference_t < I > | изменён на decltype ( auto ) |
Смотрите также
|
(C++20)
|
преобразует результат разыменования объекта в связанный тип rvalue-ссылки
(объект точки кастомизации) |
|
(C++20)
|
обменивает объекты, на которые указывают два базовых итератора
(шаблон функции) |
|
(C++11)
|
преобразует аргумент в xvalue
(шаблон функции) |
|
(C++11)
|
преобразует аргумент в xvalue, если конструктор перемещения не генерирует исключений
(шаблон функции) |
|
(C++11)
|
передает аргумент функции и использует тип шаблонного аргумента для сохранения его категории значения
(шаблон функции) |
|
(C++20)
|
перемещает диапазон элементов в новое местоположение
(функциональный объект алгоритма) |
|
(C++20)
|
перемещает диапазон элементов в новое местоположение в обратном порядке
(функциональный объект алгоритма) |