unique_ptr 수업
소유한 개체 또는 배열에 대한 포인터를 저장합니다. 개체/배열은 다른 unique_ptr이 소유하지 않습니다. 개체/배열은 unique_ptr이 소멸될 때 소멸됩니다.
구문
class unique_ptr {
public:
unique_ptr();
unique_ptr(nullptr_t Nptr);
explicit unique_ptr(pointer Ptr);
unique_ptr(pointer Ptr,
typename conditional<is_reference<Del>::value, Del,
typename add_reference<const Del>::type>::type Deleter);
unique_ptr(pointer Ptr,
typename remove_reference<Del>::type&& Deleter);
unique_ptr(unique_ptr&& Right);
template <class T2, Class Del2>
unique_ptr(unique_ptr<T2, Del2>&& Right);
unique_ptr(const unique_ptr& Right) = delete;
unique_ptr& operator=(const unique_ptr& Right) = delete;
};
//Specialization for arrays:
template <class T, class D>
class unique_ptr<T[], D> {
public:
typedef pointer;
typedef T element_type;
typedef D deleter_type;
constexpr unique_ptr() noexcept;
template <class U>
explicit unique_ptr(U p) noexcept;
template <class U>
unique_ptr(U p, see below d) noexcept;
template <class U>
unique_ptr(U p, see below d) noexcept;
unique_ptr(unique_ptr&& u) noexcept;
constexpr unique_ptr(nullptr_t) noexcept : unique_ptr() { } template <class U, class E>
unique_ptr(unique_ptr<U, E>&& u) noexcept;
~unique_ptr();
unique_ptr& operator=(unique_ptr&& u) noexcept;
template <class U, class E>
unique_ptr& operator=(unique_ptr<U, E>&& u) noexcept;
unique_ptr& operator=(nullptr_t) noexcept;
T& operator[](size_t i) const;
pointer get() const noexcept;
deleter_type& get_deleter() noexcept;
const deleter_type& get_deleter() const noexcept;
explicit operator bool() const noexcept;
pointer release() noexcept;
void reset(pointer p = pointer()) noexcept;
void reset(nullptr_t = nullptr) noexcept;
template <class U>
void reset(U p) noexcept = delete;
void swap(unique_ptr& u) noexcept; // disable copy from lvalue unique_ptr(const unique_ptr&) = delete;
unique_ptr& operator=(const unique_ptr&) = delete;
};
매개 변수
Right
unique_ptr.
Nptr
rvalue 형식의 std::nullptr_t입니다.
Ptr
pointer.
Deleter
deleter에 바인딩되는 unique_ptr 함수.
예외
unique_ptr에는 예외가 생성되지 않았습니다.
설명
unique_ptr 클래스는 auto_ptr을 대체하며 C++ 표준 라이브러리 컨테이너의 요소로 사용할 수 있습니다.
도우미 함수를 make_unique 사용하여 새 인스턴스를 unique_ptr효율적으로 만듭니다.
unique_ptr은 리소스를 고유하게 관리합니다. 각 unique_ptr 개체는 null 포인터를 소유 또는 저장하는 개체에 대해 포인터를 저장합니다. 리소스는 둘 이상의 unique_ptr 개체가 소유할 수 없으며, 특정 리소스를 소유하는 unique_ptr 개체가 제거되면 리소스가 해제됩니다. 개체를 unique_ptr 이동할 수 있지만 복사할 수는 없습니다. 자세한 내용은 Rvalue 참조 선언자를 참조 하세요 &&.
리소스는 특정 deleter에 대해 리소스가 할당된 방식을 알고 있는 Del 형식의 저장된 unique_ptr 개체를 호출하여 해제됩니다. 기본값 deleter default_delete<T> 은 가리키는 ptr 리소스가 할당 new되고 호출하여 delete _Ptr해제될 수 있다고 가정합니다. (부분 특수화 unique_ptr<T[]>는 할당된 new[]배열 개체를 관리하며 기본값 deleter default_delete<T[]>은 호출 delete[] ptr하도록 특수화되어 있습니다.)
소유한 리소스에 대한 저장된 포인터, stored_ptr에는 pointer가 있습니다. Del::pointer 정의된 경우이며 T * 그렇지 않은 경우입니다. deleter가 상태 비저장일 경우 저장된 stored_deleter 개체 deleter는 개체에서 공간을 차지하지 않습니다. Del는 참조 형식이 될 수 있습니다.
멤버
생성자
| 속성 | 설명 |
|---|---|
unique_ptr |
unique_ptr의 8가지 생성자가 있습니다. |
Typedef
| 속성 | 설명 |
|---|---|
deleter_type |
템플릿 매개 변수 Del의 동의어. |
element_type |
템플릿 매개 변수 T의 동의어. |
pointer |
Del::pointer의 동의어(정의된 경우)이며 그렇지 않은 경우 T *. |
함수
| 속성 | 설명 |
|---|---|
get |
stored_ptr을(를) 반환합니다. |
get_deleter |
stored_deleter에 대한 참조를 반환합니다. |
release |
pointer()에 stored_ptr를 반환하고 이전 내용을 반환합니다. |
reset |
현재 소유한 리소스를 해제하고 새 리소스를 허용합니다. |
swap |
리소스를 교환하고 deleter를 제공된 unique_ptr로 교환합니다. |
연산자
| 속성 | 설명 |
|---|---|
operator bool |
연산자는 bool로 변환 가능한 형식의 값을 반환합니다. bool일 경우 true로 변환한 결과는 get() != pointer()입니다. 그렇지 않으면 false입니다. |
operator-> |
멤버 함수는 stored_ptr를 반환합니다. |
operator* |
멤버 함수는 *stored_ptr를 반환합니다. |
operator= |
unique_ptr 또는 pointer-type의 값을 현재 unique_ptr에 할당합니다. |
deleter_type
이 형식은 템플릿 매개 변수 Del의 동의어입니다.
typedef Del deleter_type;
설명
이 형식은 템플릿 매개 변수 Del의 동의어입니다.
element_type
이 형식은 템플릿 매개 변수 Type의 동의어입니다.
typedef Type element_type;
설명
이 형식은 템플릿 매개 변수 Ty의 동의어입니다.
get
stored_ptr을(를) 반환합니다.
pointer get() const;
설명
멤버 함수는 stored_ptr를 반환합니다.
get_deleter
stored_deleter에 대한 참조를 반환합니다.
Del& get_deleter();
const Del& get_deleter() const;
설명
멤버 함수는 stored_deleter에 대한 참조를 반환합니다.
operator=
제공된 unique_ptr의 주소를 현재 항목에 할당합니다.
unique_ptr& operator=(unique_ptr&& right);
template <class U, Class Del2>
unique_ptr& operator=(unique_ptr<Type, Del>&& right);
unique_ptr& operator=(pointer-type);
매개 변수
현재 unique_ptr의 값을 할당하는 데 사용된 unique_ptr 참조입니다.
설명
구성원 함수는 reset(right.release())를 호출하고 right.stored_deleter를 stored_deleter로 이동한 다음 *this를 반환합니다.
pointer
Del::pointer의 동의어(정의된 경우)이며 그렇지 않은 경우 Type *.
typedef T1 pointer;
설명
형식은 Del::pointer의 동의어(정의된 경우)이며 그렇지 않은 경우 Type *입니다.
release
호출자에 대해 저장된 포인터가 반환되면 소유권을 해제하고 저장된 포인터 값을 nullptr로 설정합니다.
pointer release();
설명
release를 사용하여 unique_ptr이 저장한 원시 포인터의 소유권을 가져올 수 있습니다. 호출자는 반환된 포인터를 삭제해야 합니다. unique-ptr은 비어 있는 기본 생성 상태로 설정됩니다. unique_ptr 호출 후에 호환되는 형식의 다른 포인터를 release에 할당할 수 있습니다.
예시
이 예에서는 릴리스의 호출자가 반환된 개체를 책임지는 방식을 보여 줍니다.
// stl_release_unique.cpp
// Compile by using: cl /W4 /EHsc stl_release_unique.cpp
#include <iostream>
#include <memory>
struct Sample {
int content_;
Sample(int content) : content_(content) {
std::cout << "Constructing Sample(" << content_ << ")" << std::endl;
}
~Sample() {
std::cout << "Deleting Sample(" << content_ << ")" << std::endl;
}
};
void ReleaseUniquePointer() {
// Use make_unique function when possible.
auto up1 = std::make_unique<Sample>(3);
auto up2 = std::make_unique<Sample>(42);
// Take over ownership from the unique_ptr up2 by using release
auto ptr = up2.release();
if (up2) {
// This statement does not execute, because up2 is empty.
std::cout << "up2 is not empty." << std::endl;
}
// We are now responsible for deletion of ptr.
delete ptr;
// up1 deletes its stored pointer when it goes out of scope.
}
int main() {
ReleaseUniquePointer();
}
Constructing Sample(3)
Constructing Sample(42)
Deleting Sample(42)
Deleting Sample(3)
reset
포인터 매개 변수의 소유권을 가져온 후 원래 저장된 포인터를 삭제합니다. 새 포인터가 원래 저장된 포인터와 동일한 경우 reset은 포인터를 삭제하고 저장된 포인터를 nullptr로 설정합니다.
void reset(pointer ptr = pointer());
void reset(nullptr_t ptr);
매개 변수
ptr
소유권을 가져올 리소스에 대한 포인터입니다.
설명
to ptr에서 소유한 저장된 pointer 포인터를 unique_ptr 변경한 다음 원래 저장된 포인터를 삭제하는 데 사용합니다reset. unique_ptr 비어 reset 있지 않은 경우 원래 저장된 포인터에서 반환된 get_deleter deleter 함수를 호출합니다.
reset 먼저 새 포인터ptr를 저장한 다음 원래 저장된 포인터를 삭제하므로 원래 저장된 포인터와 동일한 경우 즉시 삭제 ptr 할 수 reset 있습니다.
swap
두 unique_ptr 개체 간에 포인터를 교환합니다.
void swap(unique_ptr& right);
매개 변수
right
포인터를 교환하는 데 사용되는 unique_ptr입니다.
설명
멤버 함수는 stored_ptr을 right.stored_ptr로 교환하고 stored_deleter를 right.stored_deleter로 교환합니다.
unique_ptr
unique_ptr의 8가지 생성자가 있습니다.
unique_ptr();
unique_ptr(nullptr_t);
explicit unique_ptr(pointer ptr);
unique_ptr(
Type* ptr,
typename conditional<
is_reference<Del>::value,
Del,
typename add_reference<const Del>::type>::type _Deleter);
unique_ptr(pointer ptr, typename remove_reference<Del>::type&& _Deleter);
unique_ptr(unique_ptr&& right);
template <class Ty2, Class Del2>
unique_ptr(unique_ptr<Ty2, Del2>&& right);
매개 변수
ptr
에 할당할 리소스에 대한 포인터입니다 unique_ptr.
_Deleter
unique_ptr에 할당할 deleter입니다.
right
unique_ptr 필드가 새로 생성된 unique_ptr에 이동 할당되는 unique_ptr에 대한 rvalue reference입니다.
설명
처음 두 생성자가 리소스를 관리하지 않는 개체를 생성합니다. 세 번째 생성자는 ptr을 저장합니다 stored_ptr. 네 번째 생성자는 ptr을 stored_ptr에 저장하고 deleter을 stored_deleter에 저장합니다.
다섯 번째 생성자는 ptr을 stored_ptr에 저장하고 deleter을 stored_deleter로 이동합니다. 여섯 번째와 일곱 번째 생성자는 right.release()을 stored_ptr에 저장하고 right.get_deleter()을 stored_deleter로 이동합니다.
~unique_ptr
unique_ptr에 대한 소멸자는 unique_ptr 개체를 삭제합니다.
~unique_ptr();
설명
이 소멸자는 get_deleter()(stored_ptr)을 호출합니다.