|
JUCE
|
A smart-pointer class which points to a reference-counted object. More...
Public Types | |
| typedef ReferenceCountedObjectClass | ReferencedType |
| The class being referenced by this pointer. More... | |
Public Member Functions | |
| ReferenceCountedObjectPtr () noexcept | |
| Creates a pointer to a null object. More... | |
| ReferenceCountedObjectPtr (ReferencedType *refCountedObject) noexcept | |
| Creates a pointer to an object. More... | |
| ReferenceCountedObjectPtr (const ReferenceCountedObjectPtr &other) noexcept | |
| Copies another pointer. More... | |
| template<class Convertible > | |
| ReferenceCountedObjectPtr (const ReferenceCountedObjectPtr< Convertible > &other) noexcept | |
| Copies another pointer. More... | |
| ReferenceCountedObjectPtr & | operator= (const ReferenceCountedObjectPtr &other) |
| Changes this pointer to point at a different object. More... | |
| template<class Convertible > | |
| ReferenceCountedObjectPtr & | operator= (const ReferenceCountedObjectPtr< Convertible > &other) |
| Changes this pointer to point at a different object. More... | |
| ReferenceCountedObjectPtr & | operator= (ReferencedType *const newObject) |
| Changes this pointer to point at a different object. More... | |
| ReferenceCountedObjectPtr (ReferenceCountedObjectPtr &&other) noexcept | |
| Takes-over the object from another pointer. More... | |
| ReferenceCountedObjectPtr & | operator= (ReferenceCountedObjectPtr &&other) |
| Takes-over the object from another pointer. More... | |
| ~ReferenceCountedObjectPtr () | |
| Destructor. More... | |
| operator ReferencedType * () const noexcept | |
| Returns the object that this pointer references. More... | |
| ReferencedType * | get () const noexcept |
| Returns the object that this pointer references. More... | |
| ReferencedType * | getObject () const noexcept |
| Returns the object that this pointer references. More... | |
| ReferencedType * | operator-> () const noexcept |
A smart-pointer class which points to a reference-counted object.
The template parameter specifies the class of the object you want to point to - the easiest way to make a class reference-countable is to simply make it inherit from ReferenceCountedObject or SingleThreadedReferenceCountedObject, but if you need to, you can roll your own reference-countable class by implementing a set of methods called incReferenceCount(), decReferenceCount(), and decReferenceCountWithoutDeleting(). See ReferenceCountedObject for examples of how these methods should behave.
When using this class, you'll probably want to create a typedef to abbreviate the full templated name - e.g.
| typedef ReferenceCountedObjectClass ReferenceCountedObjectPtr< ReferenceCountedObjectClass >::ReferencedType |
The class being referenced by this pointer.
|
noexcept |
Creates a pointer to a null object.
|
noexcept |
Creates a pointer to an object.
This will increment the object's reference-count.
|
noexcept |
Copies another pointer.
This will increment the object's reference-count.
|
noexcept |
Copies another pointer.
This will increment the object's reference-count (if it is non-null).
|
noexcept |
Takes-over the object from another pointer.
| ReferenceCountedObjectPtr< ReferenceCountedObjectClass >::~ReferenceCountedObjectPtr | ( | ) |
Destructor.
This will decrement the object's reference-count, which will cause the object to be deleted when the ref-count hits zero.
| ReferenceCountedObjectPtr& ReferenceCountedObjectPtr< ReferenceCountedObjectClass >::operator= | ( | const ReferenceCountedObjectPtr< ReferenceCountedObjectClass > & | other | ) |
Changes this pointer to point at a different object.
The reference count of the old object is decremented, and it might be deleted if it hits zero. The new object's count is incremented.
| ReferenceCountedObjectPtr& ReferenceCountedObjectPtr< ReferenceCountedObjectClass >::operator= | ( | const ReferenceCountedObjectPtr< Convertible > & | other | ) |
Changes this pointer to point at a different object.
The reference count of the old object is decremented, and it might be deleted if it hits zero. The new object's count is incremented.
| ReferenceCountedObjectPtr& ReferenceCountedObjectPtr< ReferenceCountedObjectClass >::operator= | ( | ReferencedType *const | newObject | ) |
Changes this pointer to point at a different object.
The reference count of the old object is decremented, and it might be deleted if it hits zero. The new object's count is incremented.
| ReferenceCountedObjectPtr& ReferenceCountedObjectPtr< ReferenceCountedObjectClass >::operator= | ( | ReferenceCountedObjectPtr< ReferenceCountedObjectClass > && | other | ) |
Takes-over the object from another pointer.
|
noexcept |
Returns the object that this pointer references.
The pointer returned may be null, of course.
|
noexcept |
Returns the object that this pointer references.
The pointer returned may be null, of course.
Referenced by WeakReference< InterprocessConnection >::get(), ReferenceCountedObjectPtr< ImagePixelData >::operator=(), and WeakReference< InterprocessConnection >::wasObjectDeleted().
|
noexcept |
Returns the object that this pointer references.
The pointer returned may be null, of course.
|
noexcept |
