cachedTypedWritableReferenceCount.I

Go to the documentation of this file.

/**
 * PANDA 3D SOFTWARE
 * Copyright (c) Carnegie Mellon University.  All rights reserved.
 *
 * All use of this software is subject to the terms of the revised BSD
 * license.  You should have received a copy of this license along
 * with this source code in a file named "LICENSE."
 *
 * @file cachedTypedWritableReferenceCount.I
 * @author drose
 * @date 2005-01-25
 */

/**
 * The ReferenceCount constructor is protected because you almost never want
 * to create just a ReferenceCount object by itself, and it's probably a
 * mistake if you try.
 *
 * ReferenceCount doesn't store any useful information in its own right; its
 * only purpose is to add reference-counting to some other class via
 * inheritance.
 */
INLINE CachedTypedWritableReferenceCount::
CachedTypedWritableReferenceCount() {
  _cache_ref_count = 0;
}

/**
 * The copies of reference-counted objects do not themselves inherit the
 * reference count!
 *
 * This copy constructor is protected because you almost never want to create
 * just a ReferenceCount object by itself, and it's probably a mistake if you
 * try.
 */
INLINE CachedTypedWritableReferenceCount::
CachedTypedWritableReferenceCount(const CachedTypedWritableReferenceCount &copy) : TypedWritableReferenceCount(copy) {
  _cache_ref_count = 0;
}

/**
 * The copies of reference-counted objects do not themselves inherit the
 * reference count!
 *
 * This copy assignment operator is protected because you almost never want to
 * copy just a ReferenceCount object by itself, and it's probably a mistake if
 * you try.  Instead, this should only be called from a derived class that
 * implements this operator and then calls up the inheritance chain.
 */
INLINE void CachedTypedWritableReferenceCount::
operator = (const CachedTypedWritableReferenceCount &copy) {
  // If this assertion fails, our own pointer was recently deleted.  Possibly
  // you used a real pointer instead of a PointerTo at some point, and the
  // object was deleted when the PointerTo went out of scope.  Maybe you tried
  // to create an automatic (local variable) instance of a class that derives
  // from ReferenceCount.  Or maybe your headers are out of sync, and you need
  // to make clean in direct or some higher tree.
  nassertv(_cache_ref_count != -100);

  TypedWritableReferenceCount::operator = (copy);
}

/**
 * The ReferenceCount destructor is protected to discourage users from
 * accidentally trying to delete a ReferenceCount pointer directly.  This is
 * almost always a bad idea, since the destructor is not virtual, and you've
 * almost certainly got some pointer to something that inherits from
 * ReferenceCount, not just a plain old ReferenceCount object.
 */
INLINE CachedTypedWritableReferenceCount::
~CachedTypedWritableReferenceCount() {
  // If this assertion fails, we're trying to delete an object that was just
  // deleted.  Possibly you used a real pointer instead of a PointerTo at some
  // point, and the object was deleted when the PointerTo went out of scope.
  // Maybe you tried to create an automatic (local variable) instance of a
  // class that derives from ReferenceCount.  Or maybe your headers are out of
  // sync, and you need to make clean in direct or some higher tree.
  nassertv(_cache_ref_count != -100);

  // If this assertion fails, the reference counts are all screwed up
  // altogether.  Maybe some errant code stomped all over memory somewhere.
  nassertv(_cache_ref_count >= 0);

  // If this assertion fails, someone tried to delete this object while its
  // reference count was still positive.  Maybe you tried to point a PointerTo
  // at a static object (a local variable, instead of one allocated via new)?
  // The test below against 0x7f is supposed to check for that, but it's a
  // pretty hokey test.

  // Another possibility is you inadvertently omitted a copy constructor for a
  // ReferenceCount object, and then bitwise copied a dynamically allocated
  // value--reference count and all--onto a locally allocated one.
  nassertv(_cache_ref_count == 0);

#ifndef NDEBUG
  // Ok, all clear to delete.  Now set the reference count to -100, so we'll
  // have a better chance of noticing if we happen to have a stray pointer to
  // it still out there.
  _cache_ref_count = -100;
#endif
}

/**
 * Returns the current reference count.
 */
INLINE int CachedTypedWritableReferenceCount::
get_cache_ref_count() const {
#ifdef _DEBUG
  test_ref_count_integrity();
#endif
  return (int)AtomicAdjust::get(_cache_ref_count);
}

/**
 * Explicitly increments the cache reference count and the normal reference
 * count simultaneously.
 */
INLINE void CachedTypedWritableReferenceCount::
cache_ref() const {
#ifdef _DEBUG
  nassertv(test_ref_count_integrity());
#endif

  ref();
  AtomicAdjust::inc(_cache_ref_count);
}

/**
 * Explicitly decrements the cache reference count and the normal reference
 * count simultaneously.
 *
 * The return value is true if the new reference count is nonzero, false if it
 * is zero.
 */
INLINE bool CachedTypedWritableReferenceCount::
cache_unref() const {
#ifdef _DEBUG
  nassertr(test_ref_count_integrity(), 0);
#endif

  // If this assertion fails, you tried to unref an object with a zero
  // reference count.  Are you using ref() and unref() directly?  Are you sure
  // you can't use PointerTo's?
  nassertr(_cache_ref_count > 0, 0);

  AtomicAdjust::dec(_cache_ref_count);
  return ReferenceCount::unref();
}

/**
 * Does some easy checks to make sure that the reference count isn't
 * completely bogus.
 */
INLINE bool CachedTypedWritableReferenceCount::
test_ref_count_integrity() const {
#ifndef NDEBUG
  return do_test_ref_count_integrity();
#else
  return true;
#endif
}

/**
 * Decrements the cache reference count without affecting the normal reference
 * count.  Don't use this.
 */
INLINE void CachedTypedWritableReferenceCount::
cache_ref_only() const {
#ifdef _DEBUG
  nassertv(test_ref_count_integrity());
#endif

  AtomicAdjust::inc(_cache_ref_count);
}

/**
 * Decrements the cache reference count without affecting the normal reference
 * count.  Intended to be called by derived classes only, presumably to
 * reimplement cache_unref().
 */
INLINE void CachedTypedWritableReferenceCount::
cache_unref_only() const {
#ifdef _DEBUG
  nassertv(test_ref_count_integrity());
#endif

  // If this assertion fails, you tried to unref an object with a zero
  // reference count.  Are you using ref() and unref() directly?  Are you sure
  // you can't use PointerTo's?
  nassertv(_cache_ref_count > 0);

  AtomicAdjust::dec(_cache_ref_count);
}

/**
 * This global helper function will unref the given ReferenceCount object, and
 * if the reference count reaches zero, automatically delete it.  It can't be
 * a member function because it's usually a bad idea to delete an object from
 * within its own member function.  It's a template function so the destructor
 * doesn't have to be virtual.
 */
template<class RefCountType>
INLINE void
cache_unref_delete(RefCountType *ptr) {
  if (!ptr->cache_unref()) {
    delete ptr;
  }
}