Namespaces
Variants

std::inplace_vector<T,N>:: unchecked_push_back

From cppreference.net
C++
Containers library
std::inplace_vector
Member types
Member functions
Non-member functions
constexpr reference unchecked_push_back ( const T & value ) ;
(1) (C++26부터)
constexpr reference unchecked_push_back ( T && value ) ;
(2) (C++26부터)

주어진 요소 value 를 컨테이너의 끝에 추가합니다.

다음과 동일함: return * try_push_back ( std:: forward < decltype ( value ) > ( value ) ) ;

1) 새로운 요소는 value 의 복사본으로 초기화됩니다.
2) value 가 새로운 요소로 이동됩니다.

이러한 함수들을 호출하기 전에 size ( ) < capacity ( ) 가 true 여야 합니다. 그렇지 않으면 동작이 정의되지 않습니다.

반복자나 참조는 무효화되지 않습니다. 단, end() 는 삽입이 발생할 경우 무효화됩니다.

목차

매개변수

value - 추가할 요소의 값
타입 요구사항
-
T 는 오버로드 (1)을 사용하기 위해 CopyInsertable 요구사항을 충족해야 합니다.
-
T 는 오버로드 (2)를 사용하기 위해 MoveInsertable 요구사항을 충족해야 합니다.

반환값

back() , 즉 삽입된 요소에 대한 참조입니다.

복잡도

상수.

예외

삽입된 요소의 초기화 과정에서 발생하는 모든 예외.

어떤 이유로든 예외가 발생하면, 이 함수들은 아무런 효과를 가지지 않습니다( strong exception safety guarantee ).

참고 사항

이 섹션은 불완전합니다
이유: 이 API의 목적을 설명해야 합니다.

예제

이 코드 실행 
#include <cassert>
#include <inplace_vector>
#include <string>
int main()
{
    std::inplace_vector<std::string, 2> fauna;
    std::string dog{"dog"};
    auto& r1 = fauna.unchecked_push_back("cat"); // 오버로드 (1)
    assert(r1 == "cat" and fauna.size() == 1);
    auto& r2 = fauna.unchecked_push_back(std::move(dog)); // 오버로드 (2)
    assert(r2 == "dog" and fauna.size() == 2);
    assert(fauna[0] == "cat" and fauna[1] == "dog");
    // fauna.unchecked_push_back("bug"); // 정의되지 않은 동작: 공간이 부족함
}

참고 항목

끝에 요소를 추가함
(public member function)
끝에 제자리에서 요소를 생성함
(public member function)
끝에 요소들의 범위를 추가함
(public member function)
끝에 요소를 추가 시도함
(public member function)
끝에 제자리에서 요소 생성 시도함
(public member function)
끝에 요소들의 범위 추가 시도함
(public member function)
끝에 무조건 제자리에서 요소를 생성함
(public member function)
마지막 요소를 제거함
(public member function)
인자로부터 추론된 타입의 std::back_insert_iterator 를 생성함
(function template)