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

컨테이너의 끝에 새로운 요소를 추가합니다. 요소는 std::allocator_traits::construct 를 통해 생성되며, 일반적으로 placement new 를 사용하여 컨테이너가 제공한 위치에서 제자리(in-place)에 요소를 생성합니다. 인수 args... 는 생성자에게 std:: forward < Args > ( args ) ... 형태로 전달됩니다.

만약 연산 후 새로운 size() 가 기존 capacity() 보다 크면 재할당이 발생하며, 이 경우 모든 반복자(including the end() iterator)와 모든 요소에 대한 참조가 무효화됩니다. 그렇지 않으면 end() 반복자만 무효화됩니다.

매개변수

반환값

복잡도

분할 상환 상수 시간.

예외

어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과를 가지지 않습니다( 강력한 예외 안전성 보장 ). T 의 이동 생성자가 noexcept 가 아니고 CopyInsertable 가 * this 에 대해 아닌 경우, vector 는 예외를 발생시키는 이동 생성자를 사용합니다. 만약 예외가 발생하면, 보장은 무효화되며 그 효과는 명시되지 않습니다.

참고 사항

재할당이 발생할 수 있으므로, emplace_back 은 요소 타입이 MoveInsertable 되어야 vector 에 사용 가능합니다.

예제

#include <vector>
#include <cassert>
#include <iostream>
#include <string>
struct President
{
    std::string name;
    std::string country;
    int year;
    President(std::string p_name, std::string p_country, int p_year)
        : name(std::move(p_name)), country(std::move(p_country)), year(p_year)
    {
        std::cout << "I am being constructed.\n";
    }
    President(President&& other)
        : name(std::move(other.name)), country(std::move(other.country)), year(other.year)
    {
        std::cout << "I am being moved.\n";
    }
    President& operator=(const President& other) = default;
};
int main()
{
    std::vector<President> elections;
    std::cout << "emplace_back:\n";
    auto& ref = elections.emplace_back("Nelson Mandela", "South Africa", 1994);
    assert(ref.year == 1994 && "uses a reference to the created object (C++17)");
    std::vector<President> reElections;
    std::cout << "\npush_back:\n";
    reElections.push_back(President("Franklin Delano Roosevelt", "the USA", 1936));
    std::cout << "\nContents:\n";
    for (const President& president: elections)
        std::cout << president.name << " was elected president of "
                  << president.country << " in " << president.year << ".\n";
    for (const President& president: reElections)
        std::cout << president.name << " was re-elected president of "
                  << president.country << " in " << president.year << ".\n";
}

emplace_back:
I am being constructed.
push_back:
I am being constructed.
I am being moved.
Contents:
Nelson Mandela was elected president of South Africa in 1994.
Franklin Delano Roosevelt was re-elected president of the USA in 1936.

참고 항목