std::vector<T,Allocator>::push_back

void push_back( const T& value );

void push_back( T&& value );

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

Если после операции новый size() больше старого capacity() происходит перераспределение, и в этом случае все итераторы (включая итератор end() итератор) и все ссылки на элементы становятся недействительными. В противном случае становится недействительным только итератор end() итератор становится недействительным.

Параметры

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

(нет)

Сложность

Амортизированная константа.

Исключения

Если возникает исключение (что может произойти из-за Allocator::allocate() или конструктора/оператора присваивания копирования/перемещения элемента), эта функция не имеет эффекта ( строгая гарантия безопасности исключений ).

Примечания

Некоторые реализации выбрасывают std::length_error когда push_back вызывает перераспределение памяти, превышающее max_size (из-за неявного вызова эквивалента reserve ( size () + 1)) .

Пример

#include <iomanip>
#include <iostream>
#include <string>
#include <vector>
int main()
{
    std::vector<std::string> letters;
    letters.push_back("abc");
    std::string s{"def"};
    letters.push_back(std::move(s));
    std::cout << "std::vector letters holds: ";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
    std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n';
}

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

Смотрите также