#include "ace/config-all.h"
#include "ace/Exception_Macros.h"
Include dependency graph for CORBA_macros.h:
Native C++ exceptions portability macros. | |
The following macros are used to write code portable between platforms with and without native C++ exception support. Their main goal is to hide the presence of the ACE_ENV_TYPE argument, but they collaborate with the ACE_TRY_* macros to emulate the try/catch blocks. | |
#define | ACE_ENV_EMIT_CODE(X) |
Define a macro to emit code only when ACE_ENV_TYPE is used. | |
#define | ACE_ENV_EMIT_CODE2(X, Y) |
Another macro to emit code only when ACE_ENV_TYPE is used. | |
#define | ACE_ENV_EMIT_DUMMY |
Helper macro. | |
#define | ACE_ENV_ARG_DECL |
#define | ACE_ENV_ARG_DECL_WITH_DEFAULTS |
#define | ACE_ENV_ARG_DECL_NOT_USED |
#define | ACE_ENV_SINGLE_ARG_DECL ACE_ENV_EMIT_CODE(ACE_ENV_TYPE &ACE_TRY_ENV) |
#define | ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS |
#define | ACE_ENV_SINGLE_ARG_DECL_NOT_USED ACE_ENV_EMIT_CODE(ACE_ENV_TYPE &) |
Declare a ACE_ENV_TYPE argument for methods which don't use it. | |
#define | ACE_ENV_ARG_PARAMETER |
Use the ACE_ENV_TYPE argument in a nested call. | |
#define | ACE_ENV_SINGLE_ARG_PARAMETER ACE_ENV_EMIT_CODE(ACE_TRY_ENV) |
#define | ACE_ENV_ARG_NOT_USED ACE_ENV_EMIT_CODE(ACE_UNUSED_ARG(ACE_TRY_ENV)) |
Eliminate unused argument warnings about ACE_TRY_ENV. | |
Defines | |
#define | ACE_ENV_POLLUTE_NAMES |
#define | ACE_ENV_TYPE CORBA::Environment |
#define | ACE_TRY_ENV _ACE_CORBA_Environment_variable |
#define | ACE_EXCEPTION_TYPE CORBA::Exception |
#define | ACE_DEFAULT_GET_ENV_METHOD TAO_default_environment |
#define | ACE_ANY_EXCEPTION ex |
#define | ACE_DECLARE_NEW_ENV ACE_ENV_TYPE ACE_TRY_ENV |
#define | ACE_DECLARE_NEW_CORBA_ENV ACE_ENV_TYPE ACE_TRY_ENV |
#define | ACE_ADOPT_CORBA_ENV(ENV) |
#define | ACE_ADOPT_ENV (ENV) |
#define | ACE_CHECK |
#define | ACE_CHECK_RETURN(RETV) |
#define | ACE_THROW_INT(EXCEPTION) throw EXCEPTION |
#define | ACE_THROW(EXCEPTION) throw EXCEPTION |
#define | ACE_THROW_RETURN(EXCEPTION, RETV) throw EXCEPTION |
#define | ACE_TRY |
#define | ACE_TRY_NEW_ENV |
#define | ACE_TRY_EX(LABEL) |
#define | ACE_TRY_CHECK |
#define | ACE_TRY_CHECK_EX(LABEL) |
#define | ACE_TRY_THROW(EXCEPTION) throw EXCEPTION |
#define | ACE_TRY_THROW_EX(EXCEPTION, LABEL) throw EXCEPTION |
#define | ACE_CATCH(EXCEPTION, VAR) |
#define | ACE_CATCHANY ACE_CATCH(ACE_EXCEPTION_TYPE, ACE_ANY_EXCEPTION) |
#define | ACE_CATCHALL |
#define | ACE_RE_THROW throw |
#define | ACE_RE_THROW_EX(LABEL) throw |
#define | ACE_ENDTRY |
#define | ACE_NEW_THROW_EX(POINTER, CONSTRUCTOR, EXCEPTION) |
#define | ACE_GUARD_THROW_EX(MUTEX, OBJ, LOCK, EXCEPTION) |
#define | ACE_READ_GUARD_THROW_EX(MUTEX, OBJ, LOCK, EXCEPTION) |
#define | ACE_WRITE_GUARD_THROW_EX(MUTEX, OBJ, LOCK, EXCEPTION) |
#define | ACE_ENV_RAISE(ex) (ex)->_raise () |
#define | ACE_PRINT_TAO_EXCEPTION(EX, INFO) EX._tao_print_exception (INFO) |
#define | ACE_PRINT_EXCEPTION(EX, INFO) ACE_PRINT_TAO_EXCEPTION(EX,INFO) |
Writing code that is portable between platforms with or without native C++ exceptions is hard. The following macros offer some help on this task, mostly oriented to making the ORB code and the IDL generated code portable.
|
|
|
|
|
|
|
Value: } \
catch (EXCEPTION & VAR) \
{ \
ACE_UNUSED_ARG (VAR); |
|
Value: } \
catch (...) \
{ |
|
|
|
|
|
|
|
|
|
|
|
|
|
Value: } \
} while (0) |
|
Value: Normally this macro is used as follows:
Its purpose is to provide developers (and users) with a mechanism to write code that is portable to platforms with and without native C++ exceptions. |
|
Value: Similar to ACE_ENV_ARG_DECL, but the formal parameter name is dropped to avoid warnings about unused parameters |
|
Value: It is similar to ACE_ENV_ARG_DECL. The name of the default environment getter method needs to be changed when switching ORBs or when used with another application. |
|
Eliminate unused argument warnings about ACE_TRY_ENV.
|
|
Value: Use the ACE_ENV_TYPE argument in a nested call.
|
|
Define a macro to emit code only when ACE_ENV_TYPE is used.
|
|
Another macro to emit code only when ACE_ENV_TYPE is used.
|
|
Helper macro.
|
|
|
|
|
|
Declare a ACE_ENV_TYPE argument for methods that do not take any other parameters |
|
Declare a ACE_ENV_TYPE argument for methods which don't use it.
|
|
Value: Declare a ACE_ENV_TYPE argument with a default value for methods that do not take any other parameters. The name of the default environment getter method needs to be changed when switching ORBs or when used in another application. |
|
Use the ACE_ENV_TYPE argument in a nested call, assuming that the called function takes only the ACE_TRY_ENV argument. |
|
|
|
|
|
Value: ACE_Guard< MUTEX > OBJ (LOCK); \ if (OBJ.locked () == 0) ACE_THROW_INT (EXCEPTION); |
|
Value: do { POINTER = new CONSTRUCTOR; \ if (POINTER == 0) { errno = ENOMEM; ACE_THROW_INT (EXCEPTION); } \ } while (0) |
|
|
|
|
|
|
|
|
|
Value: ACE_Read_Guard< MUTEX > OBJ (LOCK); \ if (OBJ.locked () == 0) ACE_THROW_INT (EXCEPTION); |
|
|
|
|
|
|
|
Value: do \ { \ try \ { |
|
|
|
|
|
|
|
Value: do \ { \ try \ { |
|
Value: do \ { \ ACE_ENV_TYPE ACE_TRY_ENV; \ try \ { |
|
|
|
|
|
Value: ACE_Write_Guard< MUTEX > OBJ (LOCK); \ if (OBJ.locked () == 0) ACE_THROW_INT (EXCEPTION); |