std::ranges:: destroy
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
헤더 파일에 정의됨
<memory>
|
||
|
함수 시그니처
|
||
|
template
<
no-throw-input-iterator
I, no
-
throw
-
sentinel
-
for
<
I
>
S
>
requires
std::
destructible
<
std::
iter_value_t
<
I
>>
|
(1) | (C++20부터) |
|
template
<
no-throw-input-range
R
>
requires
std::
destructible
<
ranges::
range_value_t
<
R
>>
|
(2) | (C++20부터) |
[
first
,
last
)
내의 객체들을 다음과 같이 파괴합니다
for (; first != last; ++first) std::ranges::destroy_at(std::addressof(*first)); return first;
이 페이지에서 설명하는 함수형 개체들은 algorithm function objects (일반적으로 niebloids 로 알려진)입니다. 즉:
- 명시적 템플릿 인수 목록은 이들 중 어느 것을 호출할 때도 지정할 수 없습니다.
- 이들 중 어느 것도 인수 의존 이름 검색 에 보이지 않습니다.
- 이들 중 어느 것이 함수 호출 연산자의 왼쪽에 있는 이름으로 일반 비한정 이름 검색 에 의해 발견될 때, 인수 의존 이름 검색 이 억제됩니다.
목차 |
매개변수
| first, last | - | 파괴할 요소들의 범위 를 정의하는 반복자-감시자 쌍 |
| r | - |
파괴할
range
객체
|
반환값
반복자가 last 와 동일하게 비교됩니다.
복잡도
first 와 last 사이의 거리에 선형적으로 비례합니다.
가능한 구현
struct destroy_fn { template<no-throw-input-iterator I, no-throw-sentinel-for<I> S> requires std::destructible<std::iter_value_t<I>> constexpr I operator()(I first, S last) const noexcept { for (; first != last; ++first) std::ranges::destroy_at(std::addressof(*first)); return first; } template<no-throw-input-range R> requires std::destructible<std::ranges::range_value_t<R>> constexpr std::ranges::borrowed_iterator_t<R> operator()(R&& r) const noexcept { return operator()(std::ranges::begin(r), std::ranges::end(r)); } }; inline constexpr destroy_fn destroy{}; |
예제
다음 예제는 연속된 요소 시퀀스를 파괴하기 위해
ranges::destroy
를 사용하는 방법을 보여줍니다.
#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) * 8]; for (int i = 0; i != 8; ++i) new(buffer + sizeof(Tracer) * i) Tracer{i}; // manually construct objects auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer)); std::ranges::destroy(ptr, ptr + 8); }
출력:
0 destructed 1 destructed 2 destructed 3 destructed 4 destructed 5 destructed 6 destructed 7 destructed
참고 항목
|
(C++20)
|
범위 내의 여러 객체를 파괴함
(알고리즘 함수 객체) |
|
(C++20)
|
주어진 주소의 객체를 파괴함
(알고리즘 함수 객체) |
|
(C++17)
|
객체 범위를 파괴함
(함수 템플릿) |