ReferenceCounter Class Reference

#include <reference_counter.h>

Inheritance diagram for ReferenceCounter:

[legend]

List of all members.

Public Member Functions
virtual	~ReferenceCounter ()
Static Public Member Functions
static std::string	get_info ()
static void	print_info ()
static unsigned int	n_objects ()
Protected Types
typedef std::map< std::string, std::pair< unsigned int, unsigned int > >	Counts
Protected Member Functions
	ReferenceCounter ()
void	increment_constructor_count (const std::string &name)
void	increment_destructor_count (const std::string &name)
Static Protected Attributes
static Counts	_counts
static Threads::atomic < unsigned int >	_n_objects
static Threads::spin_mutex	_mutex

---

Detailed Description

This is the base class for enabling reference counting. It should not be used by the user, thus it has a private constructor.

Author:

Benjamin S. Kirk, 2002-2007

Definition at line 44 of file reference_counter.h.

---

Member Typedef Documentation

typedef std::map<std::string, std::pair<unsigned int, unsigned int> > ReferenceCounter::Counts [protected]

Data structure to log the information. The log is identified by the class name.

Definition at line 105 of file reference_counter.h.

---

Constructor & Destructor Documentation

ReferenceCounter::ReferenceCounter

(

)

[inline, protected]

Constructor. Protected so that you cannont instantiate a ReferenceCounter, only derive from it.

Definition at line 130 of file reference_counter.h.

References _n_objects.

{
  _n_objects++;
}

ReferenceCounter::~ReferenceCounter

(

)

[inline, virtual]

Destructor.

Definition at line 137 of file reference_counter.h.

References _n_objects.

{
  _n_objects--;
}

---

Member Function Documentation

std::string ReferenceCounter::get_info

(

)

[static]

Gets a string containing the reference information.

Definition at line 45 of file reference_counter.C.

References _counts, and QuadratureRules::name().

Referenced by print_info().

{
#if defined(LIBMESH_ENABLE_REFERENCE_COUNTING) && defined(DEBUG)

  std::ostringstream out;
  
  out << '\n'
      << " ---------------------------------------------------------------------------- \n"
      << "| Reference count information                                                |\n"
      << " ---------------------------------------------------------------------------- \n";
  
  for (Counts::iterator it = _counts.begin();
       it != _counts.end(); ++it)
    {
      const std::string name(it->first);
      const unsigned int creations    = it->second.first;
      const unsigned int destructions = it->second.second;

      out << "| " << name << " reference count information:\n"
          << "|  Creations:    " << creations    << '\n'
          << "|  Destructions: " << destructions << '\n';
    }
  
  out << " ---------------------------------------------------------------------------- \n";

  return out.str();

#else

  return "";
  
#endif
}

void ReferenceCounter::increment_constructor_count

(

const std::string &

name

)

[inline, protected]

Increments the construction counter. Should be called in the constructor of any derived class that will be reference counted.

Definition at line 149 of file reference_counter.h.

References _counts, and Threads::spin_mtx.

Referenced by ReferenceCountedObject< SparseMatrix< T > >::ReferenceCountedObject().

{
  Threads::spin_mutex::scoped_lock lock(Threads::spin_mtx);
  std::pair<unsigned int, unsigned int>& p = _counts[name];

  p.first++;
}

void ReferenceCounter::increment_destructor_count

(

const std::string &

name

)

[inline, protected]

Increments the destruction counter. Should be called in the destructor of any derived class that will be reference counted.

Definition at line 167 of file reference_counter.h.

References _counts, and Threads::spin_mtx.

Referenced by ReferenceCountedObject< SparseMatrix< T > >::~ReferenceCountedObject().

{
  Threads::spin_mutex::scoped_lock lock(Threads::spin_mtx);
  std::pair<unsigned int, unsigned int>& p = _counts[name];

  p.second++;
}

static unsigned int ReferenceCounter::n_objects

(

)

[inline, static]

Prints the number of outstanding (created, but not yet destroyed) objects.

Definition at line 76 of file reference_counter.h.

References _n_objects.

  { return _n_objects; }

void ReferenceCounter::print_info

(

)

[static]

Prints the reference information to std::cout.

Definition at line 83 of file reference_counter.C.

References get_info().

{
#if defined(LIBMESH_ENABLE_REFERENCE_COUNTING) && defined(DEBUG)
  
  std::cout << ReferenceCounter::get_info();
  
#endif
}

---

Member Data Documentation

ReferenceCounter::Counts ReferenceCounter::_counts [static, protected]

Actually holds the data.

Definition at line 110 of file reference_counter.h.

Referenced by get_info(), increment_constructor_count(), and increment_destructor_count().

Threads::spin_mutex ReferenceCounter::_mutex [static, protected]

Mutual exclusion object to enable thread-safe reference counting.

Definition at line 123 of file reference_counter.h.

Threads::atomic< unsigned int > ReferenceCounter::_n_objects [static, protected]

The number of objects. Print the reference count information when the number returns to 0.

Definition at line 118 of file reference_counter.h.

Referenced by n_objects(), ReferenceCounter(), and ~ReferenceCounter().

---

The documentation for this class was generated from the following files:

• reference_counter.h
• reference_counter.C