CORBA_macros.h File Reference

#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)

---

Detailed Description

Id

CORBA_macros.h,v 1.33 2003/12/06 03:49:42 bala Exp

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.

Author:

Nanbor Wang <nanbor@cs.wustl.edu>

Aniruddha Gokhale <gokhale@sahyadri.research.bell-labs.com>

Carlos O'Ryan <coryan@uci.edu>, et al.

---

Define Documentation

#define ACE_ADOPT_CORBA_ENV (  ENV   )

#define ACE_ADOPT_ENV   (ENV)

#define ACE_ANY_EXCEPTION   ex

#define ACE_CATCH (  EXCEPTION, VAR   )

Value: } \ catch (EXCEPTION & VAR) \ { \ ACE_UNUSED_ARG (VAR);

#define ACE_CATCHALL

Value: } \ catch (...) \ {

#define ACE_CATCHANY   ACE_CATCH(ACE_EXCEPTION_TYPE, ACE_ANY_EXCEPTION)

#define ACE_CHECK

#define ACE_CHECK_RETURN (  RETV   )

#define ACE_DECLARE_NEW_CORBA_ENV   ACE_ENV_TYPE ACE_TRY_ENV

#define ACE_DECLARE_NEW_ENV   ACE_ENV_TYPE ACE_TRY_ENV

#define ACE_DEFAULT_GET_ENV_METHOD   TAO_default_environment

#define ACE_ENDTRY

Value: } \ } while (0)

#define ACE_ENV_ARG_DECL

Value: ACE_ENV_EMIT_CODE2(ACE_ENV_EMIT_DUMMY, \ ACE_ENV_TYPE &ACE_TRY_ENV) Normally this macro is used as follows: void my_funct (int x, int y ACE_ENV_ARG_DECL); 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.

#define ACE_ENV_ARG_DECL_NOT_USED

Value: ACE_ENV_EMIT_CODE2(ACE_ENV_EMIT_DUMMY, \ ACE_ENV_TYPE &) Similar to ACE_ENV_ARG_DECL, but the formal parameter name is dropped to avoid warnings about unused parameters

#define ACE_ENV_ARG_DECL_WITH_DEFAULTS

Value: ACE_ENV_EMIT_CODE2(ACE_ENV_EMIT_DUMMY, \ ACE_ENV_TYPE &ACE_TRY_ENV = \ ACE_DEFAULT_GET_ENV_METHOD ()) 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.

#define ACE_ENV_ARG_NOT_USED   ACE_ENV_EMIT_CODE(ACE_UNUSED_ARG(ACE_TRY_ENV))

Eliminate unused argument warnings about ACE_TRY_ENV.

#define ACE_ENV_ARG_PARAMETER

Value: ACE_ENV_EMIT_CODE2(ACE_ENV_EMIT_DUMMY, \ ACE_TRY_ENV) Use the ACE_ENV_TYPE argument in a nested call.

#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_POLLUTE_NAMES

#define ACE_ENV_RAISE (  ex   )     (ex)->_raise ()

#define ACE_ENV_SINGLE_ARG_DECL   ACE_ENV_EMIT_CODE(ACE_ENV_TYPE &ACE_TRY_ENV)

Declare a ACE_ENV_TYPE argument for methods that do not take any other parameters

#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_SINGLE_ARG_DECL_WITH_DEFAULTS

Value: ACE_ENV_EMIT_CODE(ACE_ENV_TYPE &ACE_TRY_ENV = \ ACE_DEFAULT_GET_ENV_METHOD ()) 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.

#define ACE_ENV_SINGLE_ARG_PARAMETER   ACE_ENV_EMIT_CODE(ACE_TRY_ENV)

Use the ACE_ENV_TYPE argument in a nested call, assuming that the called function takes only the ACE_TRY_ENV argument.

#define ACE_ENV_TYPE   CORBA::Environment

#define ACE_EXCEPTION_TYPE   CORBA::Exception

#define ACE_GUARD_THROW_EX (  MUTEX, OBJ, LOCK, EXCEPTION   )

Value: ACE_Guard< MUTEX > OBJ (LOCK); \ if (OBJ.locked () == 0) ACE_THROW_INT (EXCEPTION);

#define ACE_NEW_THROW_EX (  POINTER, CONSTRUCTOR, EXCEPTION   )

Value: do { POINTER = new CONSTRUCTOR; \ if (POINTER == 0) { errno = ENOMEM; ACE_THROW_INT (EXCEPTION); } \ } while (0)

#define ACE_PRINT_EXCEPTION (  EX, INFO   )     ACE_PRINT_TAO_EXCEPTION(EX,INFO)

#define ACE_PRINT_TAO_EXCEPTION (  EX, INFO   )     EX._tao_print_exception (INFO)

#define ACE_RE_THROW   throw

#define ACE_RE_THROW_EX (  LABEL   )     throw

#define ACE_READ_GUARD_THROW_EX (  MUTEX, OBJ, LOCK, EXCEPTION   )

Value: ACE_Read_Guard< MUTEX > OBJ (LOCK); \ if (OBJ.locked () == 0) ACE_THROW_INT (EXCEPTION);

#define ACE_THROW (  EXCEPTION   )     throw EXCEPTION

#define ACE_THROW_INT (  EXCEPTION   )     throw EXCEPTION

#define ACE_THROW_RETURN (  EXCEPTION, RETV   )     throw EXCEPTION

#define ACE_TRY

Value: do \ { \ try \ {

#define ACE_TRY_CHECK

#define ACE_TRY_CHECK_EX (  LABEL   )

#define ACE_TRY_ENV   _ACE_CORBA_Environment_variable

#define ACE_TRY_EX (  LABEL   )

Value: do \ { \ try \ {

#define ACE_TRY_NEW_ENV

Value: do \ { \ ACE_ENV_TYPE ACE_TRY_ENV; \ try \ {

#define ACE_TRY_THROW (  EXCEPTION   )     throw EXCEPTION

#define ACE_TRY_THROW_EX (  EXCEPTION, LABEL   )     throw EXCEPTION

#define ACE_WRITE_GUARD_THROW_EX (  MUTEX, OBJ, LOCK, EXCEPTION   )

Value: ACE_Write_Guard< MUTEX > OBJ (LOCK); \ if (OBJ.locked () == 0) ACE_THROW_INT (EXCEPTION);

---