Namespaces
Variants

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

From cppreference.net

void push_front ( const T & value ) ;
(1) (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.

Tous les itérateurs (y compris l'itérateur end() ) sont invalidés. Aucune référence n'est invalidée.

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 deque .
2) T n'est pas MoveInsertable dans deque .
(depuis C++11)

Complexité

Constante.

Exceptions

Si une exception est levée pour quelque raison que ce soit, ces fonctions n'ont aucun effet ( strong exception safety guarantee ).

Exemple

#include <deque>
#include <iomanip>
#include <iostream>
#include <string>
int main()
{
    std::deque<std::string> letters;
    letters.push_front("me"); // surcharge (1)
    std::string s{"send"};
    letters.push_front(std::move(s)); // surcharge (2)
    std::cout << "std::deque 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::deque letters holds: "send" "me"
Moved-from string s holds: ""

Voir aussi

construit un élément sur place au début
(fonction membre publique)
ajoute un élément à la fin
(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
(modèle de fonction)