/usr/include/ClanLib-1.0/ClanLib/Core/System/sharedptr.h is in libclanlib-dev 1.0~svn3827-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 | /*
** ClanLib SDK
** Copyright (c) 1997-2005 The ClanLib Team
**
** This software is provided 'as-is', without any express or implied
** warranty. In no event will the authors be held liable for any damages
** arising from the use of this software.
**
** Permission is granted to anyone to use this software for any purpose,
** including commercial applications, and to alter it and redistribute it
** freely, subject to the following restrictions:
**
** 1. The origin of this software must not be misrepresented; you must not
** claim that you wrote the original software. If you use this software
** in a product, an acknowledgment in the product documentation would be
** appreciated but is not required.
** 2. Altered source versions must be plainly marked as such, and must not be
** misrepresented as being the original software.
** 3. This notice may not be removed or altered from any source distribution.
**
** Note: Some of the libraries ClanLib may link to may have additional
** requirements or restrictions.
**
** File Author(s):
**
** Magnus Norddahl
** (if your name is missing here, please add it)
*/
//! clanCore="System"
//! header=core.h
#ifndef clanlib_sharedptr_header
#define clanlib_sharedptr_header
template <typename TEvil>
class CL_SharedPtr_Generic
{
public:
CL_SharedPtr_Generic() : ptr(0), ref_count(1) { return; }
virtual ~CL_SharedPtr_Generic() { return; }
public:
//: Pointer to new-allocated data, or else 0:
TEvil *ptr;
//: reference count:
unsigned int ref_count;
};
template <typename T, typename TEvil>
class CL_SharedPtr_Deleter : public CL_SharedPtr_Generic<T>
{
public:
CL_SharedPtr_Deleter(TEvil *e) { this->ptr = e; }
~CL_SharedPtr_Deleter() { delete this->ptr; }
};
//: Shared pointer class (automatically deletes data when all CL_SharedPtrs to data are gone).
//- !group=Core/System!
//- !header=core.h!
//- <p> Use CL_SharedPtr when you have data that's intended to be shared between
//- multiple users without each user needing an individual copy. </p>
//- <p> Note that CL_SharedPtr uses a very simple reference counting system, so is susecptible
//- to circular loop issues. </p>
template <typename T, typename U = T>
class CL_SharedPtr
{
//! Construction:
public:
//: Constructs a CL_SharedPtr.
//param t: A pointer which was the return value of a 'new' call.
//- <p> After the CL_SharedPtr has been constructed based on a passed pointer,
//- the CL_SharedPtr takes full control over that data. The original pointer shouldn't
//- be used to access or delete the data anymore; instead, use the CL_SharedPtr. </p>
CL_SharedPtr() : impl(0) { return; }
CL_SharedPtr(const CL_SharedPtr<T, U>& other) : impl(other.impl) { increment(); }
template <typename D>
explicit CL_SharedPtr(D* ptr) : impl(new CL_SharedPtr_Deleter<T, D>(ptr)) { return; }
explicit CL_SharedPtr(CL_SharedPtr_Generic<T> *impl) : impl(impl) { increment(); }
~CL_SharedPtr() { decrement(); }
//! Attributes:
public:
//: Returns true if this CL_SharedPtr is not dereferencable.
bool is_null() const { return impl ? (impl->ptr == 0) : true; }
//: Returns number of references (including this one) to the data cache.
//- <p> Returns 0 if this pointer is null. </p>
int get_ref_count() const { if (impl == 0) return 0; return impl->ref_count; }
//: Gives access to the pointer itself.
//- <p> Be careful not to keep the returned pointer around after doing any
//- non-const operations on the CL_LazyCopyPtr; it could be invalid
//- after that.</p>
U* get() { return (U*) ((impl != 0) ? impl->ptr : 0); }
U const* get() const { return (const U*) ((impl != 0) ? impl->ptr : 0); }
//: Return the pointer.
operator U*() { return get(); }
//: Returns the pointer.
operator U const*() const { return get(); }
//: Pointer equality check operator.
//- <p> This will return true if the CL_SharedPtrs point to the same data. It doesn't
//- check the data itself for equality. </p>
bool operator==(const T* other) const { return other == ((impl != 0) ? impl->ptr : 0); }
bool operator==(const CL_SharedPtr<T, U>& other) const { return other.impl == impl; }
//: reelase the content of the CL_SharedPtr
//- <p> Decrements the reference count and sets the data pointer to null.
//- This is usefull for solving circular references</p>
void release (void)
{
if (impl!= 0)
{
decrement ();
impl = 0;
}
}
//! Operations:
public:
//: Copy assignment operator.
//param t: A pointer which was the return value of a 'new' call.
//- <p> Once the assignment statement is finished when assigning a passed pointer,
//- the CL_SharedPtr takes full control over that data. The original pointer shouldn't
//- be used to access or delete the data anymore; instead, use the CL_SharedPtr. </p>
CL_SharedPtr<T, U>& operator=(const CL_SharedPtr<T, U>& other)
{
if (other.impl != impl)
{
decrement();
impl = other.impl;
increment();
}
return *this;
}
template <typename D>
CL_SharedPtr<T, U>& operator=(D* t)
{
decrement();
impl = new CL_SharedPtr_Deleter<T, D>(t);
return *this;
}
//: Dereferencing operator.
U& operator*() { return *((U*) impl->ptr); }
U const& operator*() const { return *((const U*) impl->ptr); }
//: Indirect member access operator.
U* operator->() { return (U*) impl->ptr; }
U const* operator->() const { return (const U*) impl->ptr; }
CL_SharedPtr_Generic<T> *get_impl() { return impl; }
//! Implementation:
private:
// Shared data:
CL_SharedPtr_Generic<T> *impl;
//: Increases the ref count
void increment()
{
if (impl != 0)
++impl->ref_count;
}
//: Decreases the ref count, deletes entry and sets ptr to 0 if ptr_ref_count reaches zero
void decrement()
{
if (impl != 0)
{
if (--impl->ref_count == 0)
{
delete impl;
impl = 0;
}
}
}
};
#endif
|