std::ranges:: uninitialized_fill_n
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
헤더 파일에 정의됨
<memory>
|
||
|
호출 시그니처
|
||
|
template
<
no-throw-forward-range
I,
class
T
>
requires
std::
constructible_from
<
std::
iter_value_t
<
I
>
,
const
T
&
>
|
(C++20부터)
(C++26부터 constexpr) |
|
value
를 초기화되지 않은 메모리 영역
first
+
[
0
,
count
)
에 다음과 같이 복사합니다
return
ranges::
uninitialized_fill
(
std::
counted_iterator
(
first, count
)
,
std::
default_sentinel
, value
)
.
base
(
)
;
초기화 과정에서 예외가 발생하면, 이미 생성된 객체들은 지정되지 않은 순서로 파괴됩니다.
이 페이지에서 설명하는 함수형 개체들은 algorithm function objects (일반적으로 niebloids 로 알려진) 즉:
- 명시적 템플릿 인수 목록은 이들 중 어느 것을 호출할 때도 지정할 수 없습니다.
- 이들 중 어느 것도 인수 의존 이름 검색 에 보이지 않습니다.
- 이들 중 어느 것이 함수 호출 연산자의 왼쪽 이름으로 일반 비한정 이름 검색 에 의해 발견될 때, 인수 의존 이름 검색 이 억제됩니다.
목차 |
매개변수
| first | - | 초기화할 요소 범위의 시작 |
| count | - | 생성할 요소의 개수 |
| value | - | 요소를 생성할 때 사용할 값 |
반환값
위에서 설명한 바와 같습니다.
복잡도
count 에 선형적으로 비례합니다.
예외
대상 범위의 요소 생성 과정에서 발생하는 모든 예외.
참고 사항
구현체는 출력 범위의 값 타입이
TrivialType
인 경우, 예를 들어
ranges::fill_n
을 사용함으로써
ranges::uninitialized_fill_n
의 효율을 향상시킬 수 있습니다.
| 기능 테스트 매크로 | 값 | 표준 | 기능 |
|---|---|---|---|
__cpp_lib_raw_memory_algorithms
|
202411L
|
(C++26) | constexpr for 특수화된 메모리 알고리즘 |
가능한 구현
struct uninitialized_fill_n_fn { template<no-throw-forward-range I, class T> requires std::constructible_from<std::iter_value_t<I>, const T&> I operator()(I first, std::iter_difference_t<I> n, const T& x) const { I rollback{first}; try { for (; n-- > 0; ++first) ranges::construct_at(std::addressof(*first), x); return first; } catch (...) // 롤백: 생성된 요소들 파괴 { for (; rollback != first; ++rollback) ranges::destroy_at(std::addressof(*rollback)); throw; } } }; inline constexpr uninitialized_fill_n_fn uninitialized_fill_n{}; |
예제
#include <iostream> #include <memory> #include <string> int main() { constexpr int n{3}; alignas(alignof(std::string)) char out[n * sizeof(std::string)]; try { auto first{reinterpret_cast<std::string*>(out)}; auto last = std::ranges::uninitialized_fill_n(first, n, "cppreference"); for (auto it{first}; it != last; ++it) std::cout << *it << '\n'; std::ranges::destroy(first, last); } catch (...) { std::cout << "Exception!\n"; } }
출력:
cppreference cppreference cppreference
결함 보고서
다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.
| DR | 적용 대상 | 게시된 동작 | 올바른 동작 |
|---|---|---|---|
| LWG 3870 | C++20 | 이 알고리즘이 const 저장 공간에 객체를 생성할 수 있음 | 허용되지 않음으로 유지 |
참고 항목
|
(C++20)
|
객체를 범위로 정의된 초기화되지 않은 메모리 영역에 복사합니다
(알고리즘 함수 객체) |
|
객체를 시작점과 개수로 정의된 초기화되지 않은 메모리 영역에 복사합니다
(함수 템플릿) |