std::list<T,Allocator>:: insert_range
|
template
<
container-compatible-range
<
T
>
R
>
iterator insert_range ( const_iterator pos, R && rg ) ; |
(depuis C++23)
(constexpr depuis C++26) |
|
Insère, dans l'ordre non inversé, des copies des éléments de rg avant pos .
Aucun itérateur ou référence n'est invalidé.
Chaque itérateur dans la plage rg est déréférencé exactement une fois.
Si rg chevauche * this , le comportement est indéfini.
Table des matières |
Paramètres
| pos | - |
itérateur avant lequel le contenu sera inséré (
pos
peut être l'itérateur
end()
)
|
| rg | - |
un
intervalle compatible avec le 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.
|
||
Valeur de retour
Un itérateur vers le premier élément inséré dans * this , ou pos si rg est vide.
Notes
| Macro de test de fonctionnalité | Valeur | Std | Fonctionnalité |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Construction et insertion compatibles avec les Ranges |
Exemple
#include <algorithm> #include <cassert> #include <iterator> #include <list> #include <vector> int main() { auto container = std::list{1, 2, 3, 4}; auto pos = std::next(container.begin(), 2); assert(*pos == 3); const auto rg = std::vector{-1, -2, -3}; #ifdef __cpp_lib_containers_ranges container.insert_range(pos, rg); #else container.insert(pos, rg.cbegin(), rg.cend()); #endif assert(std::ranges::equal(container, std::list{1, 2, -1, -2, -3, 3, 4})); }
Voir aussi
|
insère des éléments
(fonction membre publique) |
|
|
(C++23)
|
ajoute une plage d'éléments au début
(fonction membre publique) |
|
(C++23)
|
ajoute une plage d'éléments à la fin
(fonction membre publique) |