VTK  9.1.0
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
vtkSmartPointer< T > Class Template Reference

Hold a reference to a vtkObjectBase instance. More...

#include <vtkSmartPointer.h>

Inherits vtkSmartPointerBase.

Collaboration diagram for vtkSmartPointer< T >:
[legend]

Public Member Functions

 vtkSmartPointer () noexcept
 Initialize smart pointer to nullptr.
 
template<typename U >
 vtkSmartPointer (vtkNew< U > &&r) noexcept
 Move the pointer from the vtkNew smart pointer to the new vtkSmartPointer, stealing its reference and resetting the vtkNew object to nullptr.
 
template<typename U >
vtkSmartPointeroperator= (const vtkNew< U > &r)
 Assign object to reference.
 
template<typename U >
vtkSmartPointeroperator= (U *r)
 Assign object to reference.
 
 operator T* () const noexcept
 Get the contained pointer.
 
T & operator* () const noexcept
 Dereference the pointer and return a reference to the contained object.
 
T * operator-> () const noexcept
 Provides normal pointer target member access using operator ->.
 
void TakeReference (T *t)
 Transfer ownership of one reference to the given VTK object to this smart pointer.
 
 vtkSmartPointer (const vtkSmartPointer &r)
 Initialize smart pointer with a new reference to the same object referenced by given smart pointer.
 
template<class U >
 vtkSmartPointer (const vtkSmartPointer< U > &r)
 Initialize smart pointer with a new reference to the same object referenced by given smart pointer.
 
 vtkSmartPointer (vtkSmartPointer &&r) noexcept
 Move the contents of r into this.
 
template<class U >
 vtkSmartPointer (vtkSmartPointer< U > &&r) noexcept
 Initialize smart pointer with a new reference to the same object referenced by given smart pointer.
 
 vtkSmartPointer (T *r)
 Initialize smart pointer to given object.
 
template<typename U >
 vtkSmartPointer (const vtkNew< U > &r)
 Initialize smart pointer to given object.
 
vtkSmartPointeroperator= (const vtkSmartPointer &r)
 Assign object to reference.
 
template<class U >
vtkSmartPointeroperator= (const vtkSmartPointer< U > &r)
 Assign object to reference.
 
T * GetPointer () const noexcept
 Get the contained pointer.
 
T * Get () const noexcept
 Get the contained pointer.
 
- Public Member Functions inherited from vtkSmartPointerBase
 vtkSmartPointerBase () noexcept
 Initialize smart pointer to nullptr.
 
 vtkSmartPointerBase (vtkObjectBase *r)
 Initialize smart pointer to given object.
 
 vtkSmartPointerBase (const vtkSmartPointerBase &r)
 Initialize smart pointer with a new reference to the same object referenced by given smart pointer.
 
 vtkSmartPointerBase (vtkSmartPointerBase &&r) noexcept
 Move the pointee from r into this and reset @ r.
 
 ~vtkSmartPointerBase ()
 Destroy smart pointer and remove the reference to its object.
 
vtkObjectBaseGetPointer () const noexcept
 Get the contained pointer.
 
void Report (vtkGarbageCollector *collector, const char *desc)
 Report the reference held by the smart pointer to a collector.
 
vtkSmartPointerBaseoperator= (vtkObjectBase *r)
 Assign object to reference.
 
vtkSmartPointerBaseoperator= (const vtkSmartPointerBase &r)
 Assign object to reference.
 

Static Public Member Functions

static vtkSmartPointer< T > New ()
 Create an instance of a VTK object.
 
static vtkSmartPointer< T > ExtendedNew ()
 Create an instance of a VTK object in a memkind extended memory space.
 
static vtkSmartPointer< T > NewInstance (T *t)
 Create a new instance of the given VTK object.
 
static vtkSmartPointer< T > Take (T *t)
 Transfer ownership of one reference to the given VTK object to a new smart pointer.
 

Protected Member Functions

 vtkSmartPointer (T *r, const NoReference &n)
 
- Protected Member Functions inherited from vtkSmartPointerBase
 vtkSmartPointerBase (vtkObjectBase *r, const NoReference &)
 

Additional Inherited Members

- Protected Attributes inherited from vtkSmartPointerBase
vtkObjectBaseObject
 

Detailed Description

template<class T>
class vtkSmartPointer< T >

Hold a reference to a vtkObjectBase instance.

vtkSmartPointer is a class template that provides automatic casting for objects held by the vtkSmartPointerBase superclass.

Online Examples:

Definition at line 144 of file vtkSmartPointer.h.

Constructor & Destructor Documentation

◆ vtkSmartPointer() [1/9]

template<class T >
vtkSmartPointer< T >::vtkSmartPointer ( )
inlinenoexcept

Initialize smart pointer to nullptr.

Definition at line 171 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [2/9]

template<class T >
vtkSmartPointer< T >::vtkSmartPointer ( const vtkSmartPointer< T > &  r)
inline

Initialize smart pointer with a new reference to the same object referenced by given smart pointer.

Definition at line 182 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [3/9]

template<class T >
template<class U >
vtkSmartPointer< T >::vtkSmartPointer ( const vtkSmartPointer< U > &  r)
inline

Initialize smart pointer with a new reference to the same object referenced by given smart pointer.

Definition at line 188 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [4/9]

template<class T >
vtkSmartPointer< T >::vtkSmartPointer ( vtkSmartPointer< T > &&  r)
inlinenoexcept

Move the contents of r into this.

Definition at line 200 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [5/9]

template<class T >
template<class U >
vtkSmartPointer< T >::vtkSmartPointer ( vtkSmartPointer< U > &&  r)
inlinenoexcept

Initialize smart pointer with a new reference to the same object referenced by given smart pointer.

Definition at line 206 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [6/9]

template<class T >
vtkSmartPointer< T >::vtkSmartPointer ( T *  r)
inline

Initialize smart pointer to given object.

Definition at line 217 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [7/9]

template<class T >
template<typename U >
vtkSmartPointer< T >::vtkSmartPointer ( const vtkNew< U > &  r)
inline

Initialize smart pointer to given object.

Definition at line 224 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [8/9]

template<class T >
template<typename U >
vtkSmartPointer< T >::vtkSmartPointer ( vtkNew< U > &&  r)
inlinenoexcept

Move the pointer from the vtkNew smart pointer to the new vtkSmartPointer, stealing its reference and resetting the vtkNew object to nullptr.

Definition at line 236 of file vtkSmartPointer.h.

◆ vtkSmartPointer() [9/9]

template<class T >
vtkSmartPointer< T >::vtkSmartPointer ( T *  r,
const NoReference n 
)
inlineprotected

Definition at line 392 of file vtkSmartPointer.h.

Member Function Documentation

◆ operator=() [1/4]

template<class T >
vtkSmartPointer & vtkSmartPointer< T >::operator= ( const vtkSmartPointer< T > &  r)
inline

Assign object to reference.

This removes any reference to an old object.

Definition at line 251 of file vtkSmartPointer.h.

◆ operator=() [2/4]

template<class T >
template<class U >
vtkSmartPointer & vtkSmartPointer< T >::operator= ( const vtkSmartPointer< U > &  r)
inline

Assign object to reference.

This removes any reference to an old object.

Definition at line 258 of file vtkSmartPointer.h.

◆ operator=() [3/4]

template<class T >
template<typename U >
vtkSmartPointer & vtkSmartPointer< T >::operator= ( const vtkNew< U > &  r)
inline

Assign object to reference.

This removes any reference to an old object.

Definition at line 272 of file vtkSmartPointer.h.

◆ operator=() [4/4]

template<class T >
template<typename U >
vtkSmartPointer & vtkSmartPointer< T >::operator= ( U *  r)
inline

Assign object to reference.

This adds a new reference to an old object.

Definition at line 285 of file vtkSmartPointer.h.

◆ GetPointer()

template<class T >
T * vtkSmartPointer< T >::GetPointer ( ) const
inlinenoexcept

Get the contained pointer.

Definition at line 297 of file vtkSmartPointer.h.

◆ Get()

template<class T >
T * vtkSmartPointer< T >::Get ( ) const
inlinenoexcept

Get the contained pointer.

Definition at line 298 of file vtkSmartPointer.h.

◆ operator T*()

template<class T >
vtkSmartPointer< T >::operator T* ( ) const
inlinenoexcept

Get the contained pointer.

Definition at line 304 of file vtkSmartPointer.h.

◆ operator*()

template<class T >
T & vtkSmartPointer< T >::operator* ( ) const
inlinenoexcept

Dereference the pointer and return a reference to the contained object.

Definition at line 310 of file vtkSmartPointer.h.

◆ operator->()

template<class T >
T * vtkSmartPointer< T >::operator-> ( ) const
inlinenoexcept

Provides normal pointer target member access using operator ->.

Definition at line 315 of file vtkSmartPointer.h.

◆ TakeReference()

template<class T >
void vtkSmartPointer< T >::TakeReference ( T *  t)
inline

Transfer ownership of one reference to the given VTK object to this smart pointer.

This does not increment the reference count of the object, but will decrement it later. The caller is effectively passing ownership of one reference to the smart pointer. This is useful for code like:

vtkSmartPointer<vtkFoo> foo; foo.TakeReference(bar->NewFoo());

The input argument may not be another smart pointer.

Definition at line 329 of file vtkSmartPointer.h.

◆ New()

template<class T >
static vtkSmartPointer< T > vtkSmartPointer< T >::New ( )
inlinestatic

Create an instance of a VTK object.

Definition at line 334 of file vtkSmartPointer.h.

◆ ExtendedNew()

template<class T >
static vtkSmartPointer< T > vtkSmartPointer< T >::ExtendedNew ( )
inlinestatic

Create an instance of a VTK object in a memkind extended memory space.

Note that not all vtkObjects support this yet and that VTK needs to be compiled with VTK_USE_MEMKIND to enable those that do. If not enabled, this is equivalent to calling New()

Definition at line 340 of file vtkSmartPointer.h.

◆ NewInstance()

template<class T >
static vtkSmartPointer< T > vtkSmartPointer< T >::NewInstance ( T *  t)
inlinestatic

Create a new instance of the given VTK object.

Definition at line 348 of file vtkSmartPointer.h.

◆ Take()

template<class T >
static vtkSmartPointer< T > vtkSmartPointer< T >::Take ( T *  t)
inlinestatic

Transfer ownership of one reference to the given VTK object to a new smart pointer.

The returned smart pointer does not increment the reference count of the object on construction but will decrement it on destruction. The caller is effectively passing ownership of one reference to the smart pointer. This is useful for code like:

vtkSmartPointer<vtkFoo> foo = vtkSmartPointer<vtkFoo>::Take(bar->NewFoo());

The input argument may not be another smart pointer.

Definition at line 366 of file vtkSmartPointer.h.


The documentation for this class was generated from the following files: