std::list<T,Allocator>:: prepend_range
From cppreference.net
|
template
<
container-compatible-range
<
T
>
R
>
void prepend_range ( R && rg ) ; |
(depuis C++23)
(constexpr depuis C++26) |
|
Insère, dans un ordre non inversé, des copies des éléments de
rg
avant
begin()
. Chaque itérateur dans la plage
rg
est déréférencé exactement une fois.
Aucun itérateur ou référence n'est invalidé.
Table des matières |
Paramètres
| rg | - |
un
intervalle compatible avec les conteneurs
, 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 taille de rg .
Notes
| Macro de test de fonctionnalité | Valeur | Std | Fonctionnalité |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Construction et insertion compatibles avec les gammes |
Exemple
Exécuter ce code
#include <algorithm> #include <cassert> #include <list> #include <vector> int main() { auto container = std::list{0, 1, 2, 3}; const auto rg = std::vector{-3, -2, -1}; #if __cpp_lib_containers_ranges container.prepend_range(rg); #else container.insert(container.begin(), rg.cbegin(), rg.cend()); #endif assert(std::ranges::equal(container, std::list{-3, -2, -1, 0, 1, 2, 3})); }
Voir aussi
|
(C++23)
|
ajoute une plage d'éléments à la fin
(fonction membre publique) |
|
(C++23)
|
insère une plage d'éléments
(fonction membre publique) |
|
insère un élément au début
(fonction membre publique) |
|
|
(C++11)
|
construit un élément en place au début
(fonction membre publique) |