std::deque<T,Allocator>:: append_range
|
template
<
container-compatible-range
<
T
>
R
>
void append_range ( R && rg ) ; |
(начиная с C++23)
(constexpr начиная с C++26) |
|
Вставляет копии элементов из диапазона
rg
перед
end()
, в прямом порядке.
Все итераторы (включая
end()
итератор) инвалидируются. Никакие ссылки не инвалидируются.
Каждый итератор в rg разыменовывается ровно один раз.
Содержание |
Параметры
| rg | - |
a
container compatible range
, that is, an
input_range
whose elements are convertible to
T
|
| Type requirements | ||
-
T
is not
EmplaceConstructible
into
deque
from
*
ranges::
begin
(
rg
)
, the behavior is undefined.
|
||
Сложность
Линейно по размеру
rg
. Количество вызовов конструктора
T
точно равно
std
::
ranges::
size
(
rg
)
)
.
Исключения
Если исключение выброшено не конструктором копирования, конструктором перемещения, оператором присваивания или оператором перемещающего присваивания
T
, эффекты отсутствуют. Если исключение выброшено при вставке единственного элемента в любой конец, эффекты отсутствуют. В противном случае, если исключение выброшено конструктором перемещения не-
CopyInsertable
T
, эффекты не определены.
Примечания
| Макрос тестирования возможностей | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Ориентированное на диапазоны создание и вставка |
Пример
#include <cassert> #include <deque> #include <list> int main() { auto head = std::deque{1, 2, 3, 4}; const auto tail = std::list{-5, -6, -7}; #ifdef __cpp_lib_containers_ranges head.append_range(tail); #else head.insert(head.end(), tail.cbegin(), tail.cend()); #endif assert((head == std::deque{1, 2, 3, 4, -5, -6, -7})); }
Смотрите также
|
(C++23)
|
добавляет диапазон элементов в начало
(public member function) |
|
(C++23)
|
вставляет диапазон элементов
(public member function) |
|
добавляет элемент в конец
(public member function) |
|
|
(C++11)
|
конструирует элемент на месте в конце
(public member function) |