]>
git.ipfire.org Git - thirdparty/squid.git/blob - src/base/RefCount.h
2 * DEBUG: section -- Refcount allocator
3 * AUTHOR: Robert Collins
5 * SQUID Web Proxy Cache http://www.squid-cache.org/
6 * ----------------------------------------------------------
8 * Squid is the result of efforts by numerous individuals from
9 * the Internet community; see the CONTRIBUTORS file for full
10 * details. Many organizations have provided support for Squid's
11 * development; see the SPONSORS file for full details. Squid is
12 * Copyrighted (C) 2001 by the Regents of the University of
13 * California; see the COPYRIGHT file for full details. Squid
14 * incorporates software developed and/or copyrighted by other
15 * sources; see the CREDITS file for full details.
17 * This program is free software; you can redistribute it and/or modify
18 * it under the terms of the GNU General Public License as published by
19 * the Free Software Foundation; either version 2 of the License, or
20 * (at your option) any later version.
22 * This program is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU General Public License for more details.
27 * You should have received a copy of the GNU General Public License
28 * along with this program; if not, write to the Free Software
29 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
33 #ifndef SQUID_REFCOUNT_H_
34 #define SQUID_REFCOUNT_H_
36 // reference counting requires the Lock API on base classes
37 #include "base/Lock.h"
44 * Template for Reference Counting pointers.
46 * Objects of type 'C' must inherit from 'Lockable' in base/Lock.h
47 * which provides the locking interface used by reference counting.
54 RefCount () : p_ (NULL
) {}
56 RefCount (C
const *p
) : p_(p
) { reference (*this); }
62 RefCount (const RefCount
&p
) : p_(p
.p_
) {
66 RefCount
& operator = (const RefCount
& p
) {
67 // DO NOT CHANGE THE ORDER HERE!!!
68 // This preserves semantics on self assignment
69 C
const *newP_
= p
.p_
;
75 bool operator !() const { return !p_
; }
77 C
* operator-> () const {return const_cast<C
*>(p_
); }
79 C
& operator * () const {return *const_cast<C
*>(p_
); }
81 C
const * getRaw() const {return p_
; }
83 C
* getRaw() {return const_cast<C
*>(p_
); }
85 bool operator == (const RefCount
& p
) const {
89 bool operator != (const RefCount
&p
) const {
94 void dereference(C
const *newP
= NULL
) {
95 /* Setting p_ first is important:
96 * we may be freed ourselves as a result of
99 C
const (*tempP_
) (p_
);
102 if (tempP_
&& tempP_
->unlock() == 0)
106 void reference (const RefCount
& p
) {
116 inline std::ostream
&operator <<(std::ostream
&os
, const RefCount
<C
> &p
)
119 return os
<< p
.getRaw() << '*' << p
->LockCount();
124 #endif /* SQUID_REFCOUNT_H_ */