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

void push_front( const T& value );	(1)
void push_front( T&& value );	(2)	(since C++11)

Добавляет заданный элемент value в начало контейнера.

Все итераторы (включая итератор end()) становятся недействительными. Ссылки не становятся недействительными.

Параметры

value

значение добавляемого элемента

Возвращаемое значение

(ничего)

Сложность

Постоянная.

Исключения

Если выбрасывается исключение по любой причине, эти функции не имеют эффекта (гарантия исключительной безопасности).

Пример

#include <deque>
#include <iomanip>
#include <iostream>
#include <string>
 
int main()
{
    std::deque<std::string> letters;
 
    letters.push_front("abc");
    std::string s{"def"};
    letters.push_front(std::move(s));
 
    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';
}

Возможный вывод:

std::deque letters holds: "def" "abc"
Moved-from string s holds: ""

См. также

emplace_front (C++11)	создаёт элемент на месте в начале (публичный член-функция)
push_back	добавляет элемент в конец (публичный член-функция)
pop_front	удаляет первый элемент (публичный член-функция)
front_inserter	создаёт `std::front_insert_iterator` типа, определяемого из аргумента (шаблонная функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/deque/push_front