pytde/extra/kde330/ksharedptr.h

176 lines
5.3 KiB

/* This file is part of the KDE libraries
Copyright (c) 1999 Waldo Bastian <bastian@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License version 2 as published by the Free Software Foundation.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
12 years ago
#ifndef TDESharedPTR_H
#define TDESharedPTR_H
/**
* Reference counting for shared objects. If you derive your object
* from this class, then you may use it in conjunction with
12 years ago
* TDESharedPtr to control the lifetime of your object.
*
12 years ago
* Specifically, all classes that derive from TDEShared have an internal
* counter keeping track of how many other objects have a reference to
12 years ago
* their object. If used with TDESharedPtr, then your object will
* not be deleted until all references to the object have been
* released.
*
* You should probably not ever use any of the methods in this class
12 years ago
* directly -- let the TDESharedPtr take care of that. Just derive
* your class from TDEShared and forget about it.
*
* @author Waldo Bastian <bastian@kde.org>
* @version $Id: ksharedptr.h,v 1.23 2004/02/04 12:16:03 raabe Exp $
*/
12 years ago
class TDEShared {
public:
/**
* Standard constructor. This will initialize the reference count
* on this object to 0.
*/
12 years ago
TDEShared() : count(0) { }
/**
* Copy constructor. This will @em not actually copy the objects
* but it will initialize the reference count on this object to 0.
*/
12 years ago
TDEShared( const TDEShared & ) : count(0) { }
/**
* Overloaded assignment operator.
*/
12 years ago
TDEShared &operator=(const TDEShared & ) { return *this; }
/**
* Increases the reference count by one.
*/
12 years ago
void _TDEShared_ref() const { count++; }
/**
* Releases a reference (decreases the reference count by one). If
* the count goes to 0, this object will delete itself.
*/
12 years ago
void _TDEShared_unref() const { if (!--count) delete this; }
/**
* Return the current number of references held.
*
* @return Number of references
*/
12 years ago
int _TDEShared_count() const { return count; }
protected:
12 years ago
virtual ~TDEShared() { }
private:
mutable int count;
};
/**
* Can be used to control the lifetime of an object that has derived
12 years ago
* TDEShared. As long a someone holds a TDESharedPtr on some TDEShared
* object it won't become deleted but is deleted once its reference
* count is 0. This struct emulates C++ pointers virtually perfectly.
* So just use it like a simple C++ pointer.
*
12 years ago
* TDEShared and TDESharedPtr are preferred over TQShared / TQSharedPtr
* since they are more safe.
*
* WARNING: Please note that this class template provides an implicit
* conversion to T*. Do *not* change this pointer or the pointee (don't
12 years ago
* call delete on it, for instance) behind TDESharedPtr's back.
*
* @author Waldo Bastian <bastian@kde.org>
* @version $Id: ksharedptr.h,v 1.23 2004/02/04 12:16:03 raabe Exp $
*/
template< class T >
12 years ago
struct TDESharedPtr
{
public:
/**
* Creates a null pointer.
*/
12 years ago
TDESharedPtr()
: ptr(0) { }
/**
* Creates a new pointer.
* @param t the pointer
*/
12 years ago
TDESharedPtr( T* t )
: ptr(t) { if ( ptr ) ptr->_TDEShared_ref(); }
/**
* Copies a pointer.
* @param p the pointer to copy
*/
12 years ago
TDESharedPtr( const TDESharedPtr& p )
: ptr(p.ptr) { if ( ptr ) ptr->_TDEShared_ref(); }
/**
* Unreferences the object that this pointer points to. If it was
* the last reference, the object will be deleted.
*/
12 years ago
~TDESharedPtr() { if ( ptr ) ptr->_TDEShared_unref(); }
12 years ago
TDESharedPtr<T>& operator= ( const TDESharedPtr<T>& p ) {
if ( ptr == p.ptr ) return *this;
12 years ago
if ( ptr ) ptr->_TDEShared_unref();
ptr = p.ptr;
12 years ago
if ( ptr ) ptr->_TDEShared_ref();
return *this;
}
12 years ago
TDESharedPtr<T>& operator= ( T* p ) {
if ( ptr == p ) return *this;
12 years ago
if ( ptr ) ptr->_TDEShared_unref();
ptr = p;
12 years ago
if ( ptr ) ptr->_TDEShared_ref();
return *this;
}
12 years ago
bool operator== ( const TDESharedPtr<T>& p ) const { return ( ptr == p.ptr ); }
bool operator!= ( const TDESharedPtr<T>& p ) const { return ( ptr != p.ptr ); }
bool operator== ( const T* p ) const { return ( ptr == p ); }
bool operator!= ( const T* p ) const { return ( ptr != p ); }
bool operator!() const { return ( ptr == 0 ); }
operator T*() const { return ptr; }
/**
* Returns the pointer.
* @return the pointer
*/
T* data() { return ptr; }
/**
* Returns the pointer.
* @return the pointer
*/
const T* data() const { return ptr; }
const T& operator*() const { return *ptr; }
T& operator*() { return *ptr; }
const T* operator->() const { return ptr; }
T* operator->() { return ptr; }
/**
* Returns the number of references.
* @return the number of references
*/
12 years ago
int count() const { return ptr->_TDEShared_count(); } // for debugging purposes
private:
T* ptr;
};
#endif