std::destroy_n
출처: ko.cppreference.net
| 헤더 <memory>
|
||
template< class ForwardIt, class Size >
ForwardIt destroy_n( ForwardIt first, Size count );
|
(1) | (since C++17) (constexpr since C++20) |
template< class ExecutionPolicy, class ForwardIt, class Size >
ForwardIt destroy_n( ExecutionPolicy&& policy, ForwardIt first, Size count );
|
(2) | (since C++17) |
1) 대상 범위의 처음
count 요소를 [first, last) as if by
for (; count > 0; (void) ++first, --count)
std::destroy_at(std::addressof(*first));
return first;
2) (1)과 동일하지만
policy에 따라 실행됩니다. 이 오버로드는 다음 표현식의 값이
true인 경우에만 오버로드 해결에 참여합니다:
|
|
(until C++20) |
|
|
(since C++20) |
매개변수
| first | - | 파괴할 요소 범위의 시작 |
| count | - | 파괴할 요소의 개수 |
| policy | - | 해당 execution policy 사용할 |
| 형식 요구 사항 | ||
-ForwardIt는 다음의 요구 사항을 충족해야 합니다: LegacyForwardIterator.
| ||
-유효한 인스턴스를 통한 어떠한 증가, 할당, 비교 또는 간접 참조도 ForwardIt 예외를 던질 수 없습니다.
| ||
반환값
위에서 설명한 대로.
예외
2) 실행 과정 중:
- 병렬화에 필요한 임시 메모리 자원을 사용할 수 없는 경우, std::bad_alloc이 발생합니다.
- 알고리즘 인수를 통해 객체에 접근하는 동안 처리되지 않은 예외가 발생하면, 동작은 실행 정책에 의해 결정됩니다(표준 정책, std::terminate가 호출됩니다).
예제
사용 방법을 보여줍니다 destroy_n 연속된 요소 시퀀스를 파괴하는 방법입니다.
이 코드 실행
#include <iostream>
#include <memory>
#include <new>
struct Tracer
{
int value;
~Tracer() { std::cout << value << " destructed\n"; }
};
int main()
{
alignas(Tracer) unsigned char buffer[sizeof(Tracer) * 4];
for (int i = 0; i < 4; ++i)
new (buffer + sizeof(Tracer) * i) Tracer{i}; // manually construct objects
auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer));
std::destroy_n(ptr, 4);
}
출력:
0 destructed
1 destructed
2 destructed
3 destructed
참고 항목
|
(C++17)
|
객체 범위를 파괴합니다
(함수 템플릿) |
|
(C++17)
|
주어진 주소의 객체를 파괴합니다
(함수 템플릿) |
|
(C++20)
|
범위 내 지정된 개수의 객체를 파괴합니다
(알고리즘 함수 객체) |