System::SmartPtr 클래스

SmartPtr class

힙에 할당되는 타입을 감싸는 포인터 클래스입니다. Object를 상속하는 클래스의 메모리를 관리하는 데 사용합니다. 이 포인터 타입은 침입형 포인터 의미론을 따릅니다. 참조 카운터는 Object 자체에 저장되거나 Object 인스턴스와 밀접하게 연결된 카운터 구조에 저장됩니다. 어떤 경우든 모든 SmartPtr 인스턴스는 생성 방식과 관계없이 단일 소유권 그룹을 형성하며, 이는 std::shared_ptr 클래스와 다릅니다. 원시 포인터를 SmartPtr으로 변환하는 것은 동일한 객체에 대한 공유 참조를 보유한 다른 SmartPtr 인스턴스가 존재하는 경우 안전합니다. SmartPtr 클래스 인스턴스는 두 가지 상태 중 하나일 수 있습니다: 공유 포인터와 약한 포인터. 객체를 살아 있게 유지하려면 공유 참조 카운트가 양수이어야 합니다. 약한 포인터와 공유 포인터 모두 객체에 접근(메서드 호출, 필드 읽기·쓰기 등)할 수 있지만, 약한 포인터는 공유 포인터 참조 카운팅에 참여하지 않습니다. Object는 마지막 ‘shared’ SmartPtr 포인터가 파괴될 때 삭제됩니다. 따라서 객체 생성 또는 소멸 중에 다른 공유 SmartPtr 포인터가 존재하지 않을 때 이런 일이 발생하지 않도록 해야 합니다. 이 문제를 해결하려면 C++ 코드에서는 System::Object::ThisProtector 감시 객체를 사용하거나, C# 코드(번역 중)에서는 CppCTORSelfReference 또는 CppSelfReference 속성을 사용하십시오. 또한 System::WeakPtr 포인터 클래스나 System::SmartPtrMode::Weak 포인터 모드(C++ 코드) 또는 CppWeakPtr 속성(C# 코드)을 사용하여 순환 참조를 끊어야 합니다. 두 개 이상의 객체가 ‘shared’ 포인터를 사용해 서로를 참조하면 절대 삭제되지 않습니다. 런타임에 포인터 타입(약한 또는 공유)을 전환해야 하면 System::SmartPtr::set_Mode() 메서드나 System::DynamicWeakPtr 클래스를 사용하십시오. SmartPtr 클래스에는 가상 메서드가 전혀 없습니다. 자체 메모리 관리 전략을 만들 때만 상속해야 합니다. 이 타입은 다른 객체의 삭제를 관리하는 포인터이며, 스택에 할당하고 C++에서는 값이나 const 참조로 함수를 호출할 때 전달해야 합니다.

template<class T>class SmartPtr

매개변수	설명
T	가리키는 객체의 타입. System::Object이거나 그 하위 클래스여야 합니다.

메서드

메서드	설명
begin()	기본 컬렉션의 begin() 메서드에 대한 접근자입니다. SmartPtr_이 begin() 메서드를 가진 특수화 타입인 경우에만 컴파일됩니다.
begin() const	기본 컬렉션의 begin() 메서드에 대한 접근자입니다. SmartPtr_이 begin() 메서드를 가진 특수화 타입인 경우에만 컴파일됩니다.
Cast() const	포인터를 해당 타입 자체로 캐스팅합니다.
Cast() const	static_cast를 사용해 포인터를 기본 타입으로 캐스팅합니다.
Cast() const	dynamic_cast를 사용해 포인터를 파생 타입으로 캐스팅합니다.
Cast() const	dynamic_cast를 사용해 포인터를 파생 타입으로 캐스팅합니다.
cbegin() const	기본 컬렉션의 cbegin() 메서드에 대한 접근자입니다. SmartPtr_이 cbegin() 메서드를 가진 특수화 타입인 경우에만 컴파일됩니다.
cend() const	기본 컬렉션의 cend() 메서드에 대한 접근자입니다. SmartPtr_이 cend() 메서드를 가진 특수화 타입인 경우에만 컴파일됩니다.
const_pointer_cast() const	const_cast를 사용해 가리키는 객체를 다른 타입으로 캐스팅합니다.
dynamic_pointer_cast() const	dynamic_cast를 사용해 가리키는 객체를 다른 타입으로 캐스팅합니다.
end()	기본 컬렉션의 end() 메서드에 대한 접근자입니다. SmartPtr_이 end() 메서드를 가진 특수화 타입인 경우에만 컴파일됩니다.
end() const	기본 컬렉션의 end() 메서드에 대한 접근자입니다. SmartPtr_이 end() 메서드를 가진 특수화 타입인 경우에만 컴파일됩니다.
get() const	가리키는 객체를 가져옵니다.
get_Mode() const	포인터 모드를 가져옵니다.
get_shared() const	포인터가 가리키는 객체를 가져오지만, 포인터가 공유 모드에 있음을 단언합니다.
get_shared_count() const	참조된 객체에 존재하는 공유 포인터의 수를 현재 포인터를 포함하여 가져옵니다. 현재 포인터가 공유 모드에 있음을 단언합니다.
GetHashCode() const	가리키는 객체에서 GetHashCode()를 호출합니다.
GetObjectNotNull() const	현재 참조된 객체를 가져옵니다(있는 경우) 또는 예외를 발생시킵니다.
GetObjectOrNull() const	가리키는 객체를 가져옵니다(있는 경우) 또는 nullptr를 반환합니다. get()와 동일합니다.
GetObjectOwner() const	참조된 객체를 가져옵니다.
GetPointer() const	가리키는 객체를 가져옵니다(있는 경우) 또는 nullptr를 반환합니다. get()와 동일합니다.
Is(const System::TypeInfo&) const	가리키는 객체가 특정 타입 또는 그 하위 타입인지 확인합니다. C#의 ‘is’ 의미론을 따릅니다.
IsAliasingPtr() const	포인터가 소유된 객체가 아닌 다른 객체(별칭 생성자를 통해 생성된)를 가리키는지 확인합니다.
IsShared() const	포인터가 공유 모드에 있는지 확인합니다.
IsWeak() const	포인터가 약한(weak) 모드에 있는지 확인합니다.
explicit operator bool() const	포인터가 null이 아닌지 확인합니다.
operator!() const	포인터가 null인지 확인합니다.
operator*() const	가리키는 객체에 대한 참조를 가져옵니다. 포인터가 null이 아님을 단언합니다.
operator->() const	참조된 객체의 멤버에 접근할 수 있게 합니다.
operator<(Y *) const	SmartPtr 클래스에 대해 less-compare 의미론을 제공합니다.
operator<(SmartPtr<Y> const&) const	SmartPtr 클래스에 대해 less-compare 의미론을 제공합니다.
operator=(SmartPtr_&&)	SmartPtr 객체를 이동 할당합니다. x는 사용 불가능해집니다.
operator=(const SmartPtr_&)	SmartPtr 객체를 복사 할당합니다.
operator=(const SmartPtr<Q>&)	SmartPtr 객체를 복사 할당합니다. 필요한 타입 변환을 수행합니다.
operator=(Pointee_ *)	원시 포인터를 SmartPtr 객체에 할당합니다.
operator=(std::nullptr_t)	포인터 값을 nullptr로 설정합니다.
operator==(std::nullptr_t) const	포인터가 nullptr를 가리키는지 확인합니다.
operator[](IdxType) const	배열 요소에 대한 접근자입니다. SmartPtr_가 System::Array의 특수화인 경우에만 컴파일됩니다.
RemoveAliasing() const	포인터에서 별칭(별칭 생성자를 통해 생성된)을 제거하고, 포인터가 가리키는 동일한 객체를 관리(공유인 경우)하거나 추적(약한 경우)하도록 보장합니다.
reset(Pointee_ *)	가리키는 객체를 설정합니다.
reset()	포인터가 nullptr를 가리키게 합니다.
set_Mode(SmartPtrMode)	포인터 모드를 설정합니다. 참조된 객체의 참조 카운트를 변경할 수 있습니다.
SetContainedTemplateWeakPtr(uint32_t) const	포인터가 가리키는 객체(있는 경우)에서 SetTemplateWeakPtr() 메서드를 호출합니다.
SmartPtr(SmartPtrMode)	필요한 모드의 SmartPtr 객체를 생성합니다.
SmartPtr(std::nullptr_t, SmartPtrMode)	필요한 모드의 널 포인터 SmartPtr 객체를 생성합니다.
SmartPtr(Pointee_ *, SmartPtrMode)	지정된 객체를 가리키는 SmartPtr을 생성하거나, 원시 포인터를 SmartPtr으로 변환합니다.
SmartPtr(const SmartPtr_&, SmartPtrMode)	SmartPtr 객체를 복사 생성합니다. 이후 두 포인터는 동일한 객체를 가리킵니다.
SmartPtr(const SmartPtr<Q>&, SmartPtrMode)	SmartPtr 객체를 복사 생성합니다. 이후 두 포인터는 동일한 객체를 가리킵니다. 허용되는 경우 타입 변환을 수행합니다.
SmartPtr(SmartPtr_&&, SmartPtrMode)	SmartPtr 객체를 이동 생성합니다. 실제로 두 포인터가 동일한 모드인 경우 포인터를 교환합니다. 호출 후 x는 사용할 수 없게 될 수 있습니다.
explicit SmartPtr(const SmartPtr<Array<Y>>&, SmartPtrMode)	다른 타입의 새 배열을 생성하여 참조된 배열의 타입을 변환합니다. C#에서 지원하지만 C++에서는 지원되지 않는 배열 타입 캐스트가 있을 때 유용합니다.
explicit SmartPtr(const Y&)	빈 배열을 초기화합니다. 일부 C# 코드 구조를 변환하는 데 사용됩니다.
SmartPtr(const SmartPtr<P>&, Pointee_ *, SmartPtrMode)	ptr의 초기값과 소유권 정보를 공유하지만, 관련 없고 관리되지 않는 포인터 p를 보유하는 SmartPtr을 생성합니다.
static_pointer_cast() const	가리키는 객체에 static_cast를 사용하여 포인터를 다른 타입으로 캐스팅합니다.
ToObjectPtr() const	모든 포인터 타입을 Object에 대한 포인터로 변환합니다. Pointee_ 타입이 완전할 필요는 없습니다.
static Type()	Pointee_ 타입에 대한 System::TypeInfo 객체를 얻는 바로가기입니다.
~SmartPtr()	SmartPtr 객체를 파괴합니다. 필요하면 가리키는 객체의 참조 카운터를 감소시키고 객체를 삭제합니다.

Typedefs

타입 정의	설명
ArrayType	System::Array의 특수화인 경우 Pointee_와 동일하고, 그렇지 않으면 void입니다.
Pointee_	가리키는 타입.
SmartPtr_	특수화된 스마트 포인터 타입입니다.
ValueType	가리키는 배열의 저장 타입입니다. T가 System::Array의 특수화인 경우에만 의미가 있습니다.

또 보기

• Namespace System
• Library Aspose.Page for C++