pointerToVoid.h

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 pointerToVoid.h
 * @author drose
 * @date 2004-09-27
 */

#ifndef POINTERTOVOID_H
#define POINTERTOVOID_H

#include "pandabase.h"
#include "pnotify.h"
#include "memoryBase.h"
#include "atomicAdjust.h"

#include <algorithm>

/**
 * This is the non-template part of the base class for PointerTo and
 * ConstPointerTo.  It is necessary so we can keep a pointer to a non-template
 * class within the ReferenceCount object, to implement weak reference
 * pointers--we need to have something to clean up when the ReferenceCount
 * object destructs.
 *
 * This is the base class for PointerToBase<T>.
 */
class EXPCL_PANDA_EXPRESS PointerToVoid : public MemoryBase {
protected:
  constexpr PointerToVoid() noexcept = default;
  //INLINE ~PointerToVoid();

private:
  PointerToVoid(const PointerToVoid &copy) = delete;

PUBLISHED:
  constexpr bool is_null() const;
  INLINE size_t get_hash() const;

public:
  // These comparison functions are common to all things PointerTo, so they're
  // defined up here.
  INLINE bool operator < (const void *other) const;
  INLINE bool operator < (const PointerToVoid &other) const;

  INLINE bool operator == (const PointerToVoid &other) const;
  INLINE bool operator != (const PointerToVoid &other) const;

  INLINE void swap(PointerToVoid &other) noexcept;

protected:
  // Within the PointerToVoid class, we only store a void pointer.  This is
  // actually the (To *) pointer that is typecast to (void *) from the derived
  // template classes.

  // It is tempting to try to store a (ReferenceCount *) pointer here, but
  // this is not useful because it prohibits defining, say, PT(PandaNode), or
  // a PointerTo any class that inherits virtually from ReferenceCount.  (You
  // can't downcast past a virtual inheritance level, but you can always
  // cross-cast from a void pointer.)
  AtomicAdjust::Pointer _void_ptr = nullptr;
};

#include "pointerToVoid.I"

#endif