memory_uninitialized_value_construct_n

memory_uninitialized_value_construct_n (std::uninitialized_value_construct_n)

<memory> 헤더에 정의되어 있어요. first에서 시작하는 대상 범위의 처음 count개 요소를 값 초기화(value-initialization)로 구성해요. C++17부터 도입됐어요.

출처: cppreference

본문

template< class NoThrowForwardIt, class Size >
NoThrowForwardIt uninitialized_value_construct_n ( NoThrowForwardIt first, Size count );  // (1) since C++17, constexpr since C++26

template< class ExecutionPolicy, class NoThrowForwardIt, class Size >
NoThrowForwardIt uninitialized_value_construct_n ( ExecutionPolicy&& policy, NoThrowForwardIt first, Size count );  // (2) since C++17
  • (1) 대상 범위 first + [0, count)count개 요소를 값 초기화로 구성해요. 값 초기화는 스칼라 타입이면 0으로 초기화해요. 초기화 중 예외가 발생하면 이미 구성된 객체들이 미지정 순서로 파괴돼요.
  • (2) (1)과 같지만 policy에 따라 실행돼요.

매개변수

  • first: 초기화할 요소 범위의 시작
  • count: 구성할 요소 수
  • policy: 사용할 실행 정책

반환값

마지막으로 구성한 요소 다음의 반복자.

std::uninitialized_default_construct_n과 달리 값 초기화는 기본 생성 전에 객체를 0으로 초기화해, 스칼라 타입의 경우 안전하게 0으로 채워진다.

alignas(int) unsigned char buf[4 * sizeof(int)];
int* p = reinterpret_cast<int*>(buf);
std::uninitialized_value_construct_n(p, 4);   // 4개 int 를 0으로 초기화

더 알아보기 (Learn more)

cppreference