trick/trick_source/er7_utils/interface/include/deletable.hh
Alex Lin 4c3015851f Merge in the er7_utils integrators
Taking in the latest er7_utils directory and adding it into Trick in the
same location it was as an external repository.  Made one change to
the files_to_ICG.hh file in the repository to remove the CheckpointHelper
header files.  Those go in the Trick files_to_ICG.hh file.

refs #180
2016-02-10 09:32:53 -06:00

96 lines
2.0 KiB
C++

/**
* @if Er7UtilsUseGroups
* @addtogroup Er7Utils
* @{
* @addtogroup Interface
* @{
* @endif
*/
/**
* @file
* Defines the class Er7UtilsDeletable, which provides a simple mechanism for
* deleting er7_utils objects that were created with er7_utils allocation.
*/
/*
Purpose: ()
*/
#ifndef ER7_UTILS_DELETABLE_HH
#define ER7_UTILS_DELETABLE_HH
// System includes
#include <cstddef>
// Interface includes
#include "er7_utils/interface/include/er7_class.hh"
namespace er7_utils {
/**
* The base class for er7_utils/integration classes.
* An object pointer 'foo' that points to an instance of a class that derives
* from this class can be deleted via
* @code
* Er7UtilsDeletable::delete_instance (foo);
* @endcode
* The deletion will use er7_utils memory allocation, which means that the
* object must have been created with er7_utils memory allocation.
*/
class Er7UtilsDeletable {
public:
/**
* Delete an instance of a class that derives from Er7UtilsDeletable.
*
* ## Assumptions and limitations:
* - The pointer can be null. Deleting a null pointer is no harm / no foul.
* - The object must have been allocated using er7_utils memory allocation.
*
* @tparam T The type of object to be deleted; this must be a
* derived class of Er7UtilsDeletable.
* @param[in,out] obj Pointer to the object to be deleted. The pointer
* is set to null after deleting.
*/
template<typename T>
static void
delete_instance (
T *& obj)
{
Er7UtilsDeletable::delete_instance_internal (obj);
obj = NULL;
}
// Note: The default constructor, copy constructor, and assignment operator
// for this class are not declared. The C++ defaults are in force.
/**
* Destructor.
*/
virtual ~Er7UtilsDeletable (void) {}
private:
// Delete an instance.
static void delete_instance_internal (Er7UtilsDeletable* instance);
};
}
#endif
/**
* @if Er7UtilsUseGroups
* @}
* @}
* @endif
*/