Blob Blame Raw


#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