Make sure all files have the correct header

[libs/core.git] / source / core / refptr.h

diff --git a/source/core/refptr.h b/source/core/refptr.h
index ee020e0eb8783f3af6579f8960b4ae1707b9b18d..dd07256d79d45ca1fa1ff558eacab32ca925ed79 100644 (file)
--- a/source/core/refptr.h
+++ b/source/core/refptr.h
@@ -4,11 +4,16 @@ This file is part of libmspcore
 Copyright © 2006-2007 Mikko Rasa, Mikkosoft Productions
 Distributed under the LGPL
 */
+
 #ifndef MSP_CORE_REFPTR_H_
 #define MSP_CORE_REFPTR_H_
 
 namespace Msp {
 
+/**
+A reference counting smart pointer.  When the last RefPtr for the data gets
+destroyed, the data is deleted as well.
+*/
 template<typename T>
 class RefPtr
 {
@@ -16,8 +21,6 @@ public:
        RefPtr(): data(0), count(0) { }
        RefPtr(T *d): data(d), count(0) { if(data) count=new unsigned(1); }
        RefPtr(const RefPtr &p): data(p.data), count(p.count) { incref(); }
-       ~RefPtr() { decref(); }
-
        RefPtr &operator=(const RefPtr &p)
        {
                decref();
@@ -26,6 +29,22 @@ public:
                incref();
                return *this;
        }
+       
+       ~RefPtr() { decref(); }
+
+       /**
+       Makes the RefPtr release its reference of the data.  Note that if there are
+       other RefPtrs left with the same data, it might still get deleted
+       automatically.
+       */
+       T *release()
+       {
+               T *d=data;
+               data=0;
+               decref();
+               count=0;
+               return d;
+       }
 
        T *get() const        { return data; }
        T &operator*() const  { return *data; }
@@ -33,7 +52,7 @@ public:
        operator bool() const { return data!=0; }
 
        template<typename U>
-       static RefPtr<T> cast_dynamic(const RefPtr<U> &p)  { return RefPtr<T>(dynamic_cast<T *>(p.get()), p.count); }
+       static RefPtr<T> cast_dynamic(const RefPtr<U> &p)  { return RefPtr<T>(dynamic_cast<T *>(p.data), p.count); }
        template<typename U> friend class RefPtr;
 private:
        T        *data;