Detailed Description
The QExplicitlySharedDataPointer class represents a pointer to an explicitly shared object.
QExplicitlySharedDataPointer<T> makes writing your own explicitly shared classes easy. QExplicitlySharedDataPointre implements thread-safe reference counting, ensuring that adding QExplicitlySharedDataPointers to your reentrant classes won't make them non-reentrant.
Except for one big difference, QExplicitlySharedDataPointer is just like QSharedDataPointer. The big difference is that member functions of QExplicitlySharedDataPointer do not do the automatic copy on write operation (detach()) that non-const members of QSharedDataPointer do before allowing the shared data object to be modified. There is a detach() function available, but if you really want to detach(), you have to call it yourself. This means that QExplicitlySharedDataPointers behave like regular C++ pointers, except that by doing reference counting and not deleting the shared data object until the reference count is 0, they avoid the dangling pointer problem.
It is instructive to compare QExplicitlySharedDataPointer with QSharedDataPointer by way of an example. Consider the Employee example in QSharedDataPointer, modified to use explicit sharing as explained in the discussion Implicit vs Explicit Sharing.
Note that if you use this class but find you are calling detach() a lot, you probably should be using QSharedDataPointer instead.
In the member function documentation, d pointer always refers to the internal pointer to the shared data object.
See also QSharedData and QSharedDataPointer.
Member Type Documentation
typedef QExplicitlySharedDataPointer::Type
This is the type of the shared data object. The d pointer points to an object of this type.
Member Function Documentation
QExplicitlySharedDataPointer::QExplicitlySharedDataPointer ()
Constructs a QExplicitlySharedDataPointer initialized with a null d pointer.
QExplicitlySharedDataPointer::QExplicitlySharedDataPointer ( T * sharedData )
Constructs a QExplicitlySharedDataPointer with d pointer set to sharedData and increments sharedData's reference count.
QExplicitlySharedDataPointer::QExplicitlySharedDataPointer ( const QExplicitlySharedDataPointer<T> & other )
This standard copy constructor sets the d pointer of this to the d pointer in other and increments the reference count of the shared data object.
QExplicitlySharedDataPointer::QExplicitlySharedDataPointer ( const QExplicitlySharedDataPointer<X> & other )
This copy constructor is different in that it allows other to be a different type of explicitly shared data pointer but one that has a compatible shared data object. It performs a static cast of the d pointer in other and sets the d pointer of this to the converted d pointer. It increments the reference count of the shared data object.
QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer ()
Decrements the reference count of the shared data object. If the reference count becomes 0, the shared data object is deleted. This is then destroyed.
const T * QExplicitlySharedDataPointer::constData () const
Returns a const pointer to the shared data object.
See also data().
T * QExplicitlySharedDataPointer::data () const
Returns a pointer to the shared data object.
void QExplicitlySharedDataPointer::detach ()
If the shared data object's reference count is greater than 1, this function creates a deep copy of the shared data object and sets the d pointer of this to the copy.
Because QExplicitlySharedDataPointer does not do the automatic copy on write operations that members of QSharedDataPointer do, detach() is not called automatically anywhere in the member functions of this class. If you find that you are calling detach() everywhere in your code, consider using QSharedDataPointer instead.
void QExplicitlySharedDataPointer::reset ()
Resets this to be null. i.e., this function sets the d pointer of this to 0, but first it decrements the reference count of the shared data object and deletes the shared data object if the reference count became 0.
QExplicitlySharedDataPointer::operator bool () const
Returns true if the d pointer of this is not null.
bool QExplicitlySharedDataPointer::operator! () const
Returns true if the d pointer of this is null.
bool QExplicitlySharedDataPointer::operator!= ( const QExplicitlySharedDataPointer<T> & other ) const
Returns true if other and this do not have the same d pointer.
bool QExplicitlySharedDataPointer::operator!= ( const T * ptr ) const
This is an overloaded member function, provided for convenience.
Returns true if the d pointer of this is not ptr.
T & QExplicitlySharedDataPointer::operator* ()
Provides access to the shared data object's members.
const T & QExplicitlySharedDataPointer::operator* () const
This is an overloaded member function, provided for convenience.
Provides const access to the shared data object's members.
T * QExplicitlySharedDataPointer::operator-> ()
Provides access to the shared data object's members.
T * QExplicitlySharedDataPointer::operator-> () const
This is an overloaded member function, provided for convenience.
Provides const access to the shared data object's members.
QExplicitlySharedDataPointer<T> & QExplicitlySharedDataPointer::operator= ( const QExplicitlySharedDataPointer<T> & other )
Sets the d pointer of this to the d pointer of other and increments the reference count of the shared data object. The reference count of the old shared data object of this is decremented. If the reference count of the old shared data object becomes 0, the old shared data object is deleted.
QExplicitlySharedDataPointer & QExplicitlySharedDataPointer::operator= ( T * sharedData )
This is an overloaded member function, provided for convenience.
Sets the d pointer of this to sharedData and increments sharedData's reference count. The reference count of the old shared data object of this is decremented. If the reference count of the old shared data object becomes 0, the old shared data object is deleted.
bool QExplicitlySharedDataPointer::operator== ( const QExplicitlySharedDataPointer<T> & other ) const
Returns true if other and this have the same d pointer.
bool QExplicitlySharedDataPointer::operator== ( const T * ptr ) const
This is an overloaded member function, provided for convenience.
Returns true if the d pointer of this is ptr.
