Namespaces
Variants

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

From cppreference.net
C++
Containers library
std::inplace_vector
Member types
Member functions
Non-member functions
template < class ... Args >
constexpr reference unchecked_emplace_back ( Args && ... args ) ;
(C++26부터)

컨테이너의 끝에 새로운 요소를 추가합니다. 일반적으로 요소는 컨테이너가 제공한 위치에서 제자리 생성(in-place)하기 위해 배치 new 를 사용하여 생성됩니다. 인수 args... 는 생성자에게 std:: forward < Args > ( args ) ... 로 전달됩니다. 다음과 동일합니다: return * try_emplace_back ( std:: forward < Args > ( args ) ... ) ; .

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

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

목차

매개변수

args - 요소의 생성자로 전달할 인수들
타입 요구사항
-
T 는 EmplaceConstructible 이어야 함 inplace_vector 내에서 std:: forward < Args > ( args ) ... 로부터.

반환값

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

복잡도

상수.

예외

삽입된 요소의 초기화 과정에서 발생하는 모든 예외. 어떤 이유로든 예외가 발생하면, 이 함수는 아무런 효과도 가지지 않습니다( 강력한 예외 안전성 보장 ).

참고 사항

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

예제

이 코드 실행 
#include <inplace_vector>
#include <new>
#include <print>
#include <string>
#include <utility>
int main()
{
    std::inplace_vector<std::pair<std::string, std::string>, 2> fauna;
    std::string dog{"\N{DOG}"};
    fauna.unchecked_emplace_back("\N{CAT}", dog);
    fauna.unchecked_emplace_back("\N{CAT}", std::move(dog));
    std::println("fauna = {}", fauna);
    // fauna.unchecked_emplace_back("BUG", "BUG"); // undefined behavior: no space
}

출력: 

fauna = [("🐈", "🐕"), ("🐈", "🐕")]

참고 항목

끝에 제자리에서 요소를 생성합니다
(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)