std::list<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é.
Aucun itérateur ou référence n'est invalidé.
Chaque itérateur dans rg est déréférencé exactement une fois.
Table des matières |
Paramètres
| rg | - |
un
intervalle compatible avec un conteneur
, c'est-à-dire un
input_range
dont les éléments sont convertibles en
T
|
| Exigences de type | ||
-
T
n'est pas
EmplaceConstructible
dans
list
à 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 pour quelque raison que ce soit, cette fonction n'a aucun effet ( garantie forte de sûreté face aux exceptions ).
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 <list> #include <vector> int main() { auto head = std::list{1, 2, 3, 4}; const auto tail = std::vector{-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::list{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) |