Cgu::SharedHandleError< T > Class Template Reference

This is an exception struct thrown as an alternative to deleting a managed object when internal memory allocation for SharedHandle or SharedLockHandle fails in their reset() method or in their constructor which takes a pointer. More...

#include <c++-gtk-utils/shared_handle.h>

Inheritance diagram for Cgu::SharedHandleError< T >:

Public Member Functions
virtual const char *	what () const throw ()
	SharedHandleError (T p)

Public Attributes
T	obj

Detailed Description

template<class T>
class Cgu::SharedHandleError< T >

This is an exception struct thrown as an alternative to deleting a managed object when internal memory allocation for SharedHandle or SharedLockHandle fails in their reset() method or in their constructor which takes a pointer.

See also

SharedHandle SharedLockHandle SharedHandleAllocFail

This is an exception struct thrown as an alternative to deleting a managed object when SharedHandle<T>::SharedHandle(T), SharedLockHandle<T>::SharedLockHandle(T), SharedHandle<T>::reset(T) or SharedLockHandle<T>::reset(T) would otherwise throw std::bad_alloc. To make those methods do that, Cgu::SharedHandleAllocFail::leave is passed as their second argument.

If the exception is thrown, the struct has a member 'obj' of type T, which is a pointer to the object or array originally passed to those methods, so the user can deal with it appropriately. This enables the result of the new expression to be passed directly as the argument to those methods without giving rise to a resource leak, as in:

using namespace Cgu;
SharedHandle<T*> s;                                // doesn't throw
try {
  s.reset(new T[2], SharedHandleAllocFail::leave); // both T allocation and reset() might throw
}
catch (std::bad_alloc&) {
  ...
}
catch (SharedHandleError<T*>& e) {
  e.obj[0].do_something();
  e.obj[1].do_something();
  ...
}
...

As above, a catch block will need to deal with std::bad_alloc (if the call to the new expression when creating the T object fails) as well as SharedHandleError (if the call to the new expression in the reset() method fails after a valid T object has been constructed).

Constructor & Destructor Documentation

SharedHandleError()

template<class T >

Cgu::SharedHandleError< T >::SharedHandleError ( T  p )

inline

Member Function Documentation

what()

template<class T >

virtual const char* Cgu::SharedHandleError< T >::what ( ) const throw ( )

inlinevirtual

Member Data Documentation

obj

template<class T >

T Cgu::SharedHandleError< T >::obj

---

The documentation for this class was generated from the following file:

• shared_handle.h