Blob Blame Raw
#pragma once

#ifndef TCG_BASE_H
#define TCG_BASE_H

namespace tcg {

/*!
  \file   tcg_base.h

  \brief  This file contains the implementation of some handy base classes
          that can be inherited from.
*/

//========================================================================

/*!
  \brief  The empty_type can be used as default template parameter in cases
          where the template parameter may be omitted.
*/
struct empty_type {};

//------------------------------------------------------------------------

/*!
  \brief  The noncopyable class can be inherited to forbid access to the
          copy constructor and assignment operator.

  \note   A template parameter is provided to permit the empty base
          class optimization. In case this optimization is not needed,
          please use boost::noncopyable instead.
*/

template <typename B = empty_type>
struct noncopyable : public B {
  noncopyable() {}
  // noncopyable(const B& b) : B(b) {}                 // Would introduce
  // additional copies
  // along the inheritance chain. Not worth it.
protected:
  ~noncopyable() {}  //!< Protected destructor since the class
                     //!  is intended for nonvirtual inheritance.
private:
  noncopyable(const noncopyable &);  //!< Non-accessible copy constructor.
  noncopyable &operator=(
      const noncopyable &);  //!< Non-accessible assignment operator.
};

//------------------------------------------------------------------------

/*!
  \brief    The polymorphic class just implements an empty class
            with a virtual destructor.

  \details  It can be useful in certain occasions:

              \li Explicitly marks derived classes as polymporphic, and
                  spares the need to write a virtual destructor.
              \li It's noncopyable, disabling value semantics.
              \li Provides a common base class to polymorphic hierarchies.
              \li Enables lightweight type erasure without resorting to
                  a wrapper class like boost::any, assuming you have
                  enough control of the involved class to add a base class.
*/

class polymorphic : noncopyable<>  // Noncopyable to prevent slicing
{
protected:
  polymorphic() {}  //!< Protected constructor to ensure that the
                    //!  class is only used as base class.
public:
  virtual ~polymorphic() {}  //!< A virtual destructor as every good base
                             //!  class must have.
};

//------------------------------------------------------------------------

/*!
  The tcg::safe_bool template class is a simple implementation
  of the classic Safe Bool Idiom, meant to be used inside tcg.

  For a better implementation, you should consider looking into
  Boost.Spirit.Safe_Bool.
*/

template <typename T, typename B = empty_type>  // B is used for base class
                                                // chaining, to deal with
                                                class safe_bool
    : public B  // the empty class optimization
{
  class dummy {};
  struct detail {
    dummy *member;
  };

public:
  typedef dummy *detail::*bool_type;

public:
  safe_bool() {}
  // safe_bool(const B& b) : B(b) {}         // Would introduce additional
  // copies
  // along the inheritance chain. Not worth it.
  operator bool_type() const {
    return static_cast<const T *>(this)->operator_bool() ? &detail::member : 0;
  }

protected:
  ~safe_bool() {}  //!< Protected destructor since the class
                   //!  is intended for nonvirtual inheritance.
private:
  bool operator==(const safe_bool &);
  bool operator!=(const safe_bool &);
};

}  // namespace tcg

#endif  // TCG_BASE_H