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

Добавляет копию 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: ""

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