A Discrete-Event Network Simulator
API
simple-ref-count.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2007 Georgia Tech Research Corporation, INRIA
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Authors: George Riley <riley@ece.gatech.edu>
19  * Gustavo Carneiro <gjcarneiro@gmail.com>,
20  * Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
21  */
22 #ifndef SIMPLE_REF_COUNT_H
23 #define SIMPLE_REF_COUNT_H
24 
25 #include "empty.h"
26 #include "default-deleter.h"
27 #include "assert.h"
28 #include <stdint.h>
29 #include <limits>
30 
37 namespace ns3 {
38 
71 template <typename T, typename PARENT = empty, typename DELETER = DefaultDeleter<T> >
72 class SimpleRefCount : public PARENT
73 {
74 public:
76  SimpleRefCount ()
77  : m_count (1)
78  {}
83  SimpleRefCount (const SimpleRefCount &o)
84  : m_count (1)
85  {}
91  SimpleRefCount &operator = (const SimpleRefCount &o)
92  {
93  return *this;
94  }
101  inline void Ref (void) const
102  {
103  NS_ASSERT (m_count < std::numeric_limits<uint32_t>::max());
104  m_count++;
105  }
112  inline void Unref (void) const
113  {
114  m_count--;
115  if (m_count == 0)
116  {
117  DELETER::Delete (static_cast<T*> (const_cast<SimpleRefCount *> (this)));
118  }
119  }
120 
127  inline uint32_t GetReferenceCount (void) const
128  {
129  return m_count;
130  }
131 
132 private:
140  mutable uint32_t m_count;
141 };
142 
143 } // namespace ns3
144 
145 #endif /* SIMPLE_REF_COUNT_H */
ns3::SimpleRefCount::SimpleRefCount
SimpleRefCount(const SimpleRefCount &o)
Copy constructor.
Definition: simple-ref-count.h:83
ns3::SimpleRefCount::operator=
SimpleRefCount & operator=(const SimpleRefCount &o)
Assignment operator.
Definition: simple-ref-count.h:91
NS_ASSERT
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:67
ns3::SimpleRefCount::GetReferenceCount
uint32_t GetReferenceCount(void) const
Get the reference count of the object.
Definition: simple-ref-count.h:127
max
#define max(a, b)
Definition: 80211b.c:45
assert.h
NS_ASSERT() and NS_ASSERT_MSG() macro definitions.
ns3::SimpleRefCount::Unref
void Unref(void) const
Decrement the reference count.
Definition: simple-ref-count.h:112
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::SimpleRefCount::SimpleRefCount
SimpleRefCount()
Default constructor.
Definition: simple-ref-count.h:76
ns3::SimpleRefCount::Ref
void Ref(void) const
Increment the reference count.
Definition: simple-ref-count.h:101
default-deleter.h
ns3::DefaultDeleter declaration and template implementation, for reference-counted smart pointers...
empty.h
ns3::empty declaration, used by callbacks.
ns3::SimpleRefCount::m_count
uint32_t m_count
The reference count.
Definition: simple-ref-count.h:140
ns3::SimpleRefCount
A template-based reference counting class.
Definition: simple-ref-count.h:72