Namespaces
Variants

std::forward_list<T,Allocator>:: push_front

From cppreference.net

void push_front ( const T & value ) ;
(1) (depuis C++11)
(constexpr depuis C++26)
void push_front ( T && value ) ;
(2) (depuis C++11)
(constexpr depuis C++26)

Ajoute une copie de value au début du conteneur.

Aucun itérateur ou référence n'est invalidé.

Table des matières

Paramètres

value - la valeur de l'élément à préfixer
Exigences de type
-
Si la condition suivante est satisfaite, le comportement est indéfini :
1) T n'est pas CopyInsertable dans forward_list .
2) T n'est pas MoveInsertable dans forward_list .

Complexité

Constante.

Exceptions

Si une exception est levée pour quelque raison que ce soit, ces fonctions n'ont aucun effet ( garantie de sécurité d'exception forte ).

Exemple

#include <forward_list>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::forward_list<std::string> letters;
    letters.push_front("me"); // surcharge (1)
    std::string s{"send"};
    letters.push_front(std::move(s)); // surcharge (2)
    std::cout << "std::forward_list letters holds: ";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
    std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n';
}

Sortie possible :

std::forward_list letters holds: "send" "me"
Moved-from string s holds: ""

Voir aussi

construit un élément sur place au début
(fonction membre publique)
supprime le premier élément
(fonction membre publique)
crée un std::front_insert_iterator du type déduit de l'argument
(fonction template)