std::deque<T,Allocator>:: append_range
|
template
<
container-compatible-range
<
T
>
R
>
void append_range ( R && rg ) ; |
(depuis C++23)
(constexpr depuis C++26) |
|
Insère des copies des éléments de la plage
rg
avant
end()
, dans l'ordre non inversé.
Tous les itérateurs (y compris l'itérateur
end()
) sont invalidés. Aucune référence n'est invalidée.
Chaque itérateur dans rg est déréférencé exactement une fois.
Table des matières |
Paramètres
| rg | - |
une
plage compatible avec les conteneurs
, c'est-à-dire une
input_range
dont les éléments sont convertibles en
T
|
| Exigences de type | ||
-
T
n'est pas
EmplaceConstructible
dans
deque
à partir de
*
ranges::
begin
(
rg
)
, le comportement est indéfini.
|
||
Complexité
Linéaire en fonction de la taille de
rg
. Le nombre d'appels au constructeur de
T
est exactement égal à
std
::
ranges::
size
(
rg
)
)
.
Exceptions
Si une exception est levée autrement que par le constructeur de copie, le constructeur de déplacement, l'opérateur d'affectation ou l'opérateur d'affectation de déplacement de
T
, il n'y a aucun effet. Si une exception est levée lors de l'insertion d'un seul élément à l'une ou l'autre extrémité, il n'y a aucun effet. Sinon, si une exception est levée par le constructeur de déplacement d'un
CopyInsertable
T
non conforme, les effets ne sont pas spécifiés.
Notes
| Macro de test de fonctionnalité | Valeur | Std | Fonctionnalité |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Construction et insertion compatibles avec les gammes |
Exemple
#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})); }
Voir aussi
|
(C++23)
|
ajoute une plage d'éléments au début
(fonction membre publique) |
|
(C++23)
|
insère une plage d'éléments
(fonction membre publique) |
|
ajoute un élément à la fin
(fonction membre publique) |
|
|
(C++11)
|
construit un élément en place à la fin
(fonction membre publique) |