CORBA Namespace Reference

CORBA exceptions generally fall into two categories, user exceptions and system exceptions. This enumeration is used when identifying the type of CORBA exception.

Enumerator:

NO_EXCEPTION
NO_EXCEPTION
USER_EXCEPTION
USER_EXCEPTION
SYSTEM_EXCEPTION
SYSTEM_EXCEPTION

Definition at line 73 of file Exception.h.

00074   {
00075     NO_EXCEPTION,
00076     USER_EXCEPTION,
00077     SYSTEM_EXCEPTION
00078   };

enum CORBA::exception_type

Enumerator:

NO_EXCEPTION
NO_EXCEPTION
USER_EXCEPTION
USER_EXCEPTION
SYSTEM_EXCEPTION
SYSTEM_EXCEPTION

Definition at line 54 of file orb.idl.

00055   {
00056     NO_EXCEPTION,
00057     USER_EXCEPTION,
00058     SYSTEM_EXCEPTION
00059   };

enum CORBA::CompletionStatus

Completion status for CORBA system exceptions.

Enumerations that denote how an operation was (not) completed when a CORBA::SystemException is thrown.

Enumerator:

COMPLETED_YES	Successful or exceptional completion.
COMPLETED_NO	Didn't change any state; retry is OK.
COMPLETED_MAYBE	Can't say what happened; retry unsafe.

Definition at line 77 of file SystemException.h.

00078   {
00079     COMPLETED_YES,     ///< Successful or exceptional completion.
00080     COMPLETED_NO,      ///< Didn't change any state; retry is OK.
00081     COMPLETED_MAYBE    ///< Can't say what happened; retry unsafe.
00082   };

enum CORBA::TCKind

Enumerator:

tk_null
tk_void
tk_short
tk_long
tk_ushort
tk_ulong
tk_float
tk_double
tk_boolean
tk_char
tk_octet
tk_any
tk_TypeCode
tk_Principal
tk_objref
tk_struct
tk_union
tk_enum
tk_string
tk_sequence
tk_array
tk_alias
tk_except
tk_longlong
tk_ulonglong
tk_longdouble
tk_wchar
tk_wstring
tk_fixed
tk_value
tk_value_box
tk_native
tk_abstract_interface
tk_local_interface
tk_component
tk_home
tk_event
TAO_TC_KIND_COUNT

Definition at line 73 of file Typecode_typesC.h.

00074   {
00075     tk_null,
00076     tk_void,
00077     tk_short,
00078     tk_long,
00079     tk_ushort,
00080     tk_ulong,
00081     tk_float,
00082     tk_double,
00083     tk_boolean,
00084     tk_char,
00085     tk_octet,
00086     tk_any,
00087     tk_TypeCode,
00088     tk_Principal,
00089     tk_objref,
00090     tk_struct,
00091     tk_union,
00092     tk_enum,
00093     tk_string,
00094     tk_sequence,
00095     tk_array,
00096     tk_alias,
00097     tk_except,
00098     tk_longlong,
00099     tk_ulonglong,
00100     tk_longdouble,
00101     tk_wchar,
00102     tk_wstring,
00103     tk_fixed,
00104     tk_value,
00105     tk_value_box,
00106     tk_native,
00107     tk_abstract_interface,
00108     tk_local_interface,
00109     tk_component,
00110     tk_home,
00111     tk_event
00112 
00113     // This symbol is not defined by CORBA 3.0.  It's used to speed up
00114     // dispatch based on TCKind values, and lets many important ones
00115     // just be table lookups.  It must always be the last enum value!!
00116     , TAO_TC_KIND_COUNT
00117   };

Function Documentation

TAO_Export ORB_ptr CORBA::ORB_init	(	int &	argc,
		char *	argv[],
		const char *	orbid
	)

ORB Initialization

Definition at line 1187 of file ORB.cpp.

References CORBA::ORB::_duplicate(), CORBA::ORB::_nil(), CORBA::SystemException::_tao_minor_code(), ACE_DEBUG, ACE_ERROR, ACE_NEW_THROW_EX, ACE_TEXT, ACE_TEXT_CHAR_TO_TCHAR, ACE_String_Base< CHAR >::c_str(), COMPLETED_NO, TAO::find_orb_context(), TAO_ORB_Core_Auto_Ptr::get(), ACE_Argv_Type_Converter::get_argc(), ACE_Argv_Type_Converter::get_ASCII_argv(), ACE_Argv_Type_Converter::get_TCHAR_argv(), LM_DEBUG, LM_ERROR, TAO::ORB::open_global_services(), TAO::ORB::open_services(), TAO_ORB_Core::orbinitializer_registry(), TAO::parse_orb_opt(), TAO_ORB_Core_Auto_Ptr::reset(), ACE_OS::strlen(), TAO_debug_level, and TAO_ORB_CORE_INIT_LOCATION_CODE.

Referenced by TAO_ORB_Core_instance().

01188 {
01189   // It doesn't make sense for argc to be zero and argv to be
01190   // non-empty/zero, or for argc to be greater than zero and argv be
01191   // zero.
01192   size_t const argv0_len = (argv ? (*argv
01193                                         ? ACE_OS::strlen (*argv)
01194                                         : 0)
01195                                      : 0);
01196 
01197   if ((argc == 0 && argv0_len != 0)
01198       || (argc != 0  && (argv == 0 || argv[0] == 0)))
01199     {
01200       throw ::CORBA::BAD_PARAM (
01201         CORBA::SystemException::_tao_minor_code (
01202           0,
01203           EINVAL),
01204         CORBA::COMPLETED_NO);
01205     }
01206 
01207   // Copy command line parameter not to corrupt the original.
01208   ACE_Argv_Type_Converter command_line(argc, argv);
01209   int tmpargc = command_line.get_argc ();
01210   ACE_TCHAR **tmpargv = command_line.get_TCHAR_argv ();
01211 
01212   // Scan the parameters to find any we could interpret to
01213   // use for initializing the global context. Note that if
01214   // the global context has been initialized already, the
01215   // parameters may either be ignored, or later used to initialize
01216   // a local configuration context. The chosen action depends on
01217   // weather we want the ORB to share the global context or
01218   // have its own, private (or local) context.
01219   if (TAO::ORB::open_global_services (tmpargc, tmpargv) == -1)
01220     {
01221         return CORBA::ORB::_nil ();
01222     }
01223 
01224   // Make sure the following is done after the global ORB
01225   // initialization since we need to have exceptions initialized.
01226 
01227   // Use this string variable to hold the orbid
01228   ACE_CString orbid_string (orbid);
01229   TAO::parse_orb_opt (command_line, ACE_TEXT("-ORBid"), orbid_string);
01230 
01231   // Get ORB Core
01232   TAO_ORB_Core_Auto_Ptr oc (TAO::ORB_Table::instance ()->find (orbid_string.c_str ()));
01233 
01234     // The ORB was already initialized.  Just return that one.
01235   if (oc.get () != 0)
01236     {
01237       return CORBA::ORB::_duplicate (oc->orb ());
01238     }
01239 
01240 
01241   // Determine the service object registry this ORB will use. The choises
01242   // are: (a) the legacy (global); (b) its own, local, or (c) share somebody
01243   // else's configuration. By default use the process-wide (global) context
01244     // Use this string variable to hold the configuration identity key
01245   ACE_CString orbconfig_string;
01246   TAO::parse_orb_opt (command_line, ACE_TEXT("-ORBGestalt"), orbconfig_string);
01247   ACE_Intrusive_Auto_Ptr<ACE_Service_Gestalt> gestalt = TAO::find_orb_context (orbconfig_string);
01248 
01249   // An ORB corresponding to the desired ORBid doesn't exist so create
01250   // a new one.
01251   TAO_ORB_Core * tmp = 0;
01252   ACE_NEW_THROW_EX (tmp,
01253                     TAO_ORB_Core (orbid_string.c_str (), gestalt),
01254                     CORBA::NO_MEMORY (
01255                       CORBA::SystemException::_tao_minor_code (0,
01256                                                                ENOMEM),
01257                       CORBA::COMPLETED_NO));
01258 
01259   // The ORB table increases the reference count on the ORB Core
01260   // so do not release it here.  Allow the TAO_ORB_Core_Auto_Ptr
01261   // to decrease the reference count on the ORB Core when it goes
01262   // out of scope.
01263   oc.reset (tmp);
01264 
01265   // Having the ORB's default static services be shared among all ORBs
01266   // is tempting from the point of view of reducing the dynamic
01267   // footprint. However, if the ORB in a DLL and the rest of that
01268   // application most likely neither cares, nor wishes to know about
01269   // them. Furthermore, if the ORB DLL gets unloaded, the static
01270   // services it had registered globaly will no longer be accesible,
01271   // which will have disastrous consequences at the process
01272   // shutdown. Hence, the ACE_Service_Config_Guard ensures that for
01273   // the current thread, any references to the global
01274   // ACE_Service_Config will be re-routed to this ORB's service gestalt.
01275 
01276   ACE_Service_Config_Guard scg (oc->configuration ());
01277 
01278   // Initialize the Service Configurator.  This must occur before the
01279   // ORBInitializer::pre_init() method is invoked on each registered
01280   // ORB initializer.
01281   int result = TAO::ORB::open_services (oc->configuration (),
01282                                         command_line.get_argc (),
01283                                         command_line.get_TCHAR_argv ());
01284 
01285   // Check for errors returned from <TAO_Internal::open_services>.
01286   if (result != 0 && errno != ENOENT)
01287     {
01288       ACE_ERROR ((LM_ERROR,
01289                   ACE_TEXT ("(%P|%t) %p\n"),
01290                   ACE_TEXT ("Unable to initialize the ")
01291                   ACE_TEXT ("Service Configurator")));
01292       throw ::CORBA::INITIALIZE (
01293         CORBA::SystemException::_tao_minor_code (
01294           TAO_ORB_CORE_INIT_LOCATION_CODE,
01295           0),
01296         CORBA::COMPLETED_NO);
01297     }
01298 
01299   TAO::ORBInitializer_Registry_Adapter * orbinitializer_registry =
01300     oc.get ()->orbinitializer_registry ();
01301 
01302   PortableInterceptor::SlotId slotid = 0;
01303   size_t pre_init_count = 0;
01304 
01305   if (orbinitializer_registry != 0)
01306     {
01307       pre_init_count =
01308         orbinitializer_registry->pre_init (oc.get (),
01309                                            command_line.get_argc(),
01310                                            command_line.get_ASCII_argv(),
01311                                            slotid);
01312     }
01313 
01314   // Initialize the ORB Core instance.
01315   result = oc->init (command_line.get_argc(),
01316                      command_line.get_ASCII_argv());
01317 
01318   if (orbinitializer_registry != 0)
01319     {
01320       orbinitializer_registry->post_init (pre_init_count,
01321                                           oc.get (),
01322                                           command_line.get_argc(),
01323                                           command_line.get_ASCII_argv(),
01324                                           slotid);
01325     }
01326 
01327   if (TAO_debug_level > 2)
01328     {
01329       ACE_DEBUG ((LM_DEBUG,
01330                   ACE_TEXT("TAO (%P|%t) created new ORB <%s>\n"),
01331                   ACE_TEXT_CHAR_TO_TCHAR (orbid_string.c_str ())));
01332     }
01333 
01334   // Before returning remember to store the ORB into the table...
01335   if (TAO::ORB_Table::instance ()->bind (orbid_string.c_str (),
01336                                          oc.get ()) != 0)
01337     throw ::CORBA::INTERNAL (0, CORBA::COMPLETED_NO);
01338 
01339   // Return a duplicate since the ORB_Core should release the last
01340   // reference to the ORB.
01341   return CORBA::ORB::_duplicate (oc->orb ());
01342 }

TAO_NAMESPACE_INLINE_FUNCTION Boolean CORBA::is_nil ( Environment_ptr )

Definition at line 12 of file Environment.inl.

00013 {
00014   return env == 0;
00015 }

TAO_NAMESPACE_INLINE_FUNCTION void CORBA::release ( Environment_ptr )

Definition at line 19 of file Environment.inl.

00020 {
00021   delete env;
00022 }

TAO_NAMESPACE_INLINE_FUNCTION Boolean CORBA::is_nil ( ORB_ptr )

Definition at line 85 of file ORB.inl.

00086 {
00087   return obj == CORBA::ORB::_nil ();
00088 }

TAO_NAMESPACE_INLINE_FUNCTION void CORBA::release ( ORB_ptr )

Definition at line 91 of file ORB.inl.

00092 {
00093   if (!CORBA::is_nil (obj))
00094     obj->_decr_refcnt ();
00095 }

TAO_NAMESPACE_INLINE_FUNCTION Boolean CORBA::is_nil ( Object_ptr )

Definition at line 46 of file Object.inl.

00047 {
00048   if (obj == 0)
00049     {
00050       return true;
00051     }
00052 
00053   return CORBA::Object::is_nil_i (obj);
00054 }

TAO_NAMESPACE_INLINE_FUNCTION void CORBA::release ( Object_ptr )

Definition at line 36 of file Object.inl.

00037 {
00038   if (obj)
00039     {
00040       obj->_remove_ref ();
00041     }
00042 }

TAO_NAMESPACE_INLINE_FUNCTION Boolean CORBA::is_nil ( Principal_ptr )

Definition at line 9 of file Principal.inl.

00010 {
00011   return principal == 0;
00012 }

TAO_NAMESPACE_INLINE_FUNCTION void CORBA::release ( Principal_ptr )

Definition at line 28 of file Principal.inl.

References CORBA::Principal::_decr_refcnt().

00029 {
00030   if (principal)
00031     {
00032       principal->_decr_refcnt ();
00033     }
00034 }

TAO_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE CORBA::Boolean CORBA::is_nil ( CORBA::Environment_ptr env )

Definition at line 12 of file Environment.inl.

00013 {
00014   return env == 0;
00015 }

ACE_INLINE void CORBA::release ( CORBA::Environment_ptr env )

Definition at line 19 of file Environment.inl.

00020 {
00021   delete env;
00022 }

TAO_Export ACE_OSTREAM_TYPE & CORBA::operator<<	(	ACE_OSTREAM_TYPE &	os,
		const CORBA::Exception &	e
	)

Definition at line 124 of file Exception.cpp.

References CORBA::Exception::_name(), and CORBA::Exception::_rep_id().

00126   {
00127     os << e._name () << " (" << e._rep_id () << ')';
00128 
00129     return os;
00130   }

TAO_Export ACE_OSTREAM_TYPE & CORBA::operator<<	(	ACE_OSTREAM_TYPE &	os,
		const CORBA::Exception *	e
	)

Definition at line 132 of file Exception.cpp.

References CORBA::Exception::_name(), and CORBA::Exception::_rep_id().

00134   {
00135     os << e->_name () << " (" << e->_rep_id () << ')';
00136 
00137     return os;
00138   }

ACE_INLINE void CORBA::release ( CORBA::Object_ptr obj )

Definition at line 36 of file Object.inl.

References CORBA::Object::_remove_ref().

00037 {
00038   if (obj)
00039     {
00040       obj->_remove_ref ();
00041     }
00042 }

ACE_INLINE CORBA::Boolean CORBA::is_nil ( CORBA::Object_ptr obj )

Definition at line 46 of file Object.inl.

References CORBA::Object::is_nil_i().

00047 {
00048   if (obj == 0)
00049     {
00050       return true;
00051     }
00052 
00053   return CORBA::Object::is_nil_i (obj);
00054 }

CORBA::ORB_ptr CORBA::ORB_init	(	int &	argc,
		char *	argv[],
		const char *	orbid = `0`
	)

ORB Initialization

Definition at line 1187 of file ORB.cpp.

Referenced by TAO_ORB_Core_instance().

01188 {
01189   // It doesn't make sense for argc to be zero and argv to be
01190   // non-empty/zero, or for argc to be greater than zero and argv be
01191   // zero.
01192   size_t const argv0_len = (argv ? (*argv
01193                                         ? ACE_OS::strlen (*argv)
01194                                         : 0)
01195                                      : 0);
01196 
01197   if ((argc == 0 && argv0_len != 0)
01198       || (argc != 0  && (argv == 0 || argv[0] == 0)))
01199     {
01200       throw ::CORBA::BAD_PARAM (
01201         CORBA::SystemException::_tao_minor_code (
01202           0,
01203           EINVAL),
01204         CORBA::COMPLETED_NO);
01205     }
01206 
01207   // Copy command line parameter not to corrupt the original.
01208   ACE_Argv_Type_Converter command_line(argc, argv);
01209   int tmpargc = command_line.get_argc ();
01210   ACE_TCHAR **tmpargv = command_line.get_TCHAR_argv ();
01211 
01212   // Scan the parameters to find any we could interpret to
01213   // use for initializing the global context. Note that if
01214   // the global context has been initialized already, the
01215   // parameters may either be ignored, or later used to initialize
01216   // a local configuration context. The chosen action depends on
01217   // weather we want the ORB to share the global context or
01218   // have its own, private (or local) context.
01219   if (TAO::ORB::open_global_services (tmpargc, tmpargv) == -1)
01220     {
01221         return CORBA::ORB::_nil ();
01222     }
01223 
01224   // Make sure the following is done after the global ORB
01225   // initialization since we need to have exceptions initialized.
01226 
01227   // Use this string variable to hold the orbid
01228   ACE_CString orbid_string (orbid);
01229   TAO::parse_orb_opt (command_line, ACE_TEXT("-ORBid"), orbid_string);
01230 
01231   // Get ORB Core
01232   TAO_ORB_Core_Auto_Ptr oc (TAO::ORB_Table::instance ()->find (orbid_string.c_str ()));
01233 
01234     // The ORB was already initialized.  Just return that one.
01235   if (oc.get () != 0)
01236     {
01237       return CORBA::ORB::_duplicate (oc->orb ());
01238     }
01239 
01240 
01241   // Determine the service object registry this ORB will use. The choises
01242   // are: (a) the legacy (global); (b) its own, local, or (c) share somebody
01243   // else's configuration. By default use the process-wide (global) context
01244     // Use this string variable to hold the configuration identity key
01245   ACE_CString orbconfig_string;
01246   TAO::parse_orb_opt (command_line, ACE_TEXT("-ORBGestalt"), orbconfig_string);
01247   ACE_Intrusive_Auto_Ptr<ACE_Service_Gestalt> gestalt = TAO::find_orb_context (orbconfig_string);
01248 
01249   // An ORB corresponding to the desired ORBid doesn't exist so create
01250   // a new one.
01251   TAO_ORB_Core * tmp = 0;
01252   ACE_NEW_THROW_EX (tmp,
01253                     TAO_ORB_Core (orbid_string.c_str (), gestalt),
01254                     CORBA::NO_MEMORY (
01255                       CORBA::SystemException::_tao_minor_code (0,
01256                                                                ENOMEM),
01257                       CORBA::COMPLETED_NO));
01258 
01259   // The ORB table increases the reference count on the ORB Core
01260   // so do not release it here.  Allow the TAO_ORB_Core_Auto_Ptr
01261   // to decrease the reference count on the ORB Core when it goes
01262   // out of scope.
01263   oc.reset (tmp);
01264 
01265   // Having the ORB's default static services be shared among all ORBs
01266   // is tempting from the point of view of reducing the dynamic
01267   // footprint. However, if the ORB in a DLL and the rest of that
01268   // application most likely neither cares, nor wishes to know about
01269   // them. Furthermore, if the ORB DLL gets unloaded, the static
01270   // services it had registered globaly will no longer be accesible,
01271   // which will have disastrous consequences at the process
01272   // shutdown. Hence, the ACE_Service_Config_Guard ensures that for
01273   // the current thread, any references to the global
01274   // ACE_Service_Config will be re-routed to this ORB's service gestalt.
01275 
01276   ACE_Service_Config_Guard scg (oc->configuration ());
01277 
01278   // Initialize the Service Configurator.  This must occur before the
01279   // ORBInitializer::pre_init() method is invoked on each registered
01280   // ORB initializer.
01281   int result = TAO::ORB::open_services (oc->configuration (),
01282                                         command_line.get_argc (),
01283                                         command_line.get_TCHAR_argv ());
01284 
01285   // Check for errors returned from <TAO_Internal::open_services>.
01286   if (result != 0 && errno != ENOENT)
01287     {
01288       ACE_ERROR ((LM_ERROR,
01289                   ACE_TEXT ("(%P|%t) %p\n"),
01290                   ACE_TEXT ("Unable to initialize the ")
01291                   ACE_TEXT ("Service Configurator")));
01292       throw ::CORBA::INITIALIZE (
01293         CORBA::SystemException::_tao_minor_code (
01294           TAO_ORB_CORE_INIT_LOCATION_CODE,
01295           0),
01296         CORBA::COMPLETED_NO);
01297     }
01298 
01299   TAO::ORBInitializer_Registry_Adapter * orbinitializer_registry =
01300     oc.get ()->orbinitializer_registry ();
01301 
01302   PortableInterceptor::SlotId slotid = 0;
01303   size_t pre_init_count = 0;
01304 
01305   if (orbinitializer_registry != 0)
01306     {
01307       pre_init_count =
01308         orbinitializer_registry->pre_init (oc.get (),
01309                                            command_line.get_argc(),
01310                                            command_line.get_ASCII_argv(),
01311                                            slotid);
01312     }
01313 
01314   // Initialize the ORB Core instance.
01315   result = oc->init (command_line.get_argc(),
01316                      command_line.get_ASCII_argv());
01317 
01318   if (orbinitializer_registry != 0)
01319     {
01320       orbinitializer_registry->post_init (pre_init_count,
01321                                           oc.get (),
01322                                           command_line.get_argc(),
01323                                           command_line.get_ASCII_argv(),
01324                                           slotid);
01325     }
01326 
01327   if (TAO_debug_level > 2)
01328     {
01329       ACE_DEBUG ((LM_DEBUG,
01330                   ACE_TEXT("TAO (%P|%t) created new ORB <%s>\n"),
01331                   ACE_TEXT_CHAR_TO_TCHAR (orbid_string.c_str ())));
01332     }
01333 
01334   // Before returning remember to store the ORB into the table...
01335   if (TAO::ORB_Table::instance ()->bind (orbid_string.c_str (),
01336                                          oc.get ()) != 0)
01337     throw ::CORBA::INTERNAL (0, CORBA::COMPLETED_NO);
01338 
01339   // Return a duplicate since the ORB_Core should release the last
01340   // reference to the ORB.
01341   return CORBA::ORB::_duplicate (oc->orb ());
01342 }

ACE_INLINE CORBA::Boolean CORBA::is_nil ( CORBA::ORB_ptr obj )

Definition at line 85 of file ORB.inl.

References CORBA::ORB::_nil().

00086 {
00087   return obj == CORBA::ORB::_nil ();
00088 }

ACE_INLINE void CORBA::release ( CORBA::ORB_ptr obj )

Definition at line 91 of file ORB.inl.

References is_nil().

00092 {
00093   if (!CORBA::is_nil (obj))
00094     obj->_decr_refcnt ();
00095 }

TAO_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE CORBA::Boolean CORBA::is_nil ( CORBA::Principal_ptr principal )

Definition at line 9 of file Principal.inl.

00010 {
00011   return principal == 0;
00012 }

ACE_INLINE void CORBA::release ( CORBA::Principal_ptr principal )

Definition at line 28 of file Principal.inl.

References CORBA::Principal::_decr_refcnt().

00029 {
00030   if (principal)
00031     {
00032       principal->_decr_refcnt ();
00033     }
00034 }

TAO_Export char * CORBA::string_dup ( const char * str )

Definition at line 17 of file String_Alloc.cpp.

References ACE_OS::memcpy(), string_alloc(), and ACE_OS::strlen().

Referenced by TAO_IIOP_Endpoint::add_local_endpoint(), TAO_Default_Resource_Factory::add_to_ior_parser_names(), TAO_ORB_Parameters::default_init_ref(), TAO::details::string_traits_base< char >::default_initializer(), TAO_IIOP_Acceptor::dotted_decimal_address(), TAO::details::string_traits_base< char >::duplicate(), TAO_IIOP_Transport::get_listen_point(), TAO_Default_Resource_Factory::get_parser_names(), TAO_IIOP_Acceptor::hostname(), CORBA::ORB::id(), TAO_ORB_Core::list_initial_references(), TAO_ORB_Parameters::mcast_discovery_endpoint(), CORBA::Exception::operator=(), TAO_IIOP_Profile::parse_string_i(), TAO_IIOP_Endpoint::preferred_interfaces(), and TAO_IIOP_Endpoint::set().

00018 {
00019   if (!str)
00020     {
00021       errno = EINVAL;
00022       return 0;
00023     }
00024 
00025   size_t const len = ACE_OS::strlen (str);
00026 
00027   // This allocates an extra byte for the '\0';
00028   char * copy = CORBA::string_alloc (static_cast<CORBA::ULong> (len));
00029 
00030   if (copy != 0)
00031     {
00032       // The memcpy() assumes that the destination is a valid buffer.
00033       ACE_OS::memcpy (copy, str, len + 1);
00034     }
00035 
00036   return copy;
00037 }

TAO_Export char * CORBA::string_alloc ( CORBA::ULong len )

Definition at line 40 of file String_Alloc.cpp.

References ACE_NEW_RETURN.

Referenced by TAO::details::string_traits_base< char >::allocate(), TAO::ObjectKey::encode_sequence_to_string(), CORBA::ORB::object_to_string(), operator>>(), TAO_IIOP_Profile::parse_string_i(), CORBA::ORB::resolve_initial_references(), string_dup(), and TAO_IIOP_Profile::to_string().

00041 {
00042   // Allocate 1 + strlen to accomodate the null terminating character.
00043   char *s = 0;
00044   ACE_NEW_RETURN (s,
00045                   char[size_t (len + 1)],
00046                   0);
00047 
00048   s[0]= '\0';
00049 
00050   return s;
00051 }

TAO_Export void CORBA::string_free ( char * str )

Definition at line 54 of file String_Alloc.cpp.

Referenced by TAO_ServerRequest::operation(), TAO::details::string_traits_base< char >::release(), TAO_Default_Resource_Factory::~TAO_Default_Resource_Factory(), TAO_IIOP_Acceptor::~TAO_IIOP_Acceptor(), and TAO_ServerRequest::~TAO_ServerRequest().

00055 {
00056   delete [] str;
00057 }

TAO_Export WChar * CORBA::wstring_dup ( const WChar *const str )

Definition at line 62 of file String_Alloc.cpp.

References ACE_OS::strlen(), ACE_OS::wscpy(), and wstring_alloc().

Referenced by TAO::details::string_traits_base< CORBA::WChar >::default_initializer(), and TAO::details::string_traits_base< CORBA::WChar >::duplicate().

00063 {
00064   if (!str)
00065     {
00066       errno = EINVAL;
00067       return 0;
00068     }
00069 
00070   CORBA::WChar* retval =
00071     CORBA::wstring_alloc (static_cast <CORBA::ULong> (ACE_OS::strlen (str)));
00072 
00073   // The wscpy() below assumes that the destination is a valid buffer.
00074   if (retval == 0)
00075     {
00076       return 0;
00077     }
00078 
00079   return ACE_OS::wscpy (retval, str);
00080 }

TAO_Export WChar * CORBA::wstring_alloc ( CORBA::ULong len )

Definition at line 83 of file String_Alloc.cpp.

References ACE_NEW_RETURN.

Referenced by TAO::details::string_traits_base< CORBA::WChar >::allocate(), operator>>(), and wstring_dup().

00084 {
00085   CORBA::WChar *s = 0;
00086   ACE_NEW_RETURN (s,
00087                   CORBA::WChar [(size_t) (len + 1)],
00088                   0);
00089 
00090   return s;
00091 }

TAO_Export void CORBA::wstring_free ( CORBA::WChar *const str )

Definition at line 94 of file String_Alloc.cpp.

Referenced by TAO::details::string_traits_base< CORBA::WChar >::release().

00095 {
00096   delete [] str;
00097 }

Variable Documentation

native CORBA::ValueFactory

Definition at line 61 of file orb.idl.

const ULong CORBA::OMGVMCID = 0x4f4d0000U

The OMG Vendor Minor Codeset ID (VMCID).

This number is reserved by the OMG as a prefix to all the standard system exception minor codes. Check the CORBA/IIOP specification for details.

OMG defined system exception minor codes should be logically OR-ed with this constant when passing such minor codes to a CORBA::SystemException constructor. For example, throwing a CORBA::BAD_PARAM exception with an OMG defined minor code of 2 is done as follows:

   *   throw ::CORBA::BAD_PARAM (CORBA::OMGVMCID | 2, CORBA::COMPLETED_NO);
   *

*NOT* as:

   *   throw ::CORBA::BAD_PARAM (2, CORBA::COMPLETED_NO);
   *

Definition at line 56 of file ORB_Constants.h.

const CORBA::PolicyErrorCode CORBA::BAD_POLICY = 0

Definition at line 93 of file PolicyC.h.

const CORBA::PolicyErrorCode CORBA::UNSUPPORTED_POLICY = 1

Definition at line 98 of file PolicyC.h.

const CORBA::PolicyErrorCode CORBA::BAD_POLICY_TYPE = 2

Definition at line 103 of file PolicyC.h.

const CORBA::PolicyErrorCode CORBA::BAD_POLICY_VALUE = 3

Definition at line 108 of file PolicyC.h.

const CORBA::PolicyErrorCode CORBA::UNSUPPORTED_POLICY_VALUE = 4

Definition at line 113 of file PolicyC.h.

Generated on Tue Feb 2 17:39:56 2010 for TAO by

1.4.7


Classes
class	Environment
	Environment. More...
class	Exception
	Exception. More...
class	LocalObject
class	Object
	Implementation of a CORBA object reference. More...
class	ORB
	ORB pseudo-object. More...
struct	NamedValue
class	PolicyError
class	InvalidPolicies
class	Policy
class	Principal
	A "Principal" identifies an authenticated entity in the network administration framework. More...
class	SystemException
	SystemException. More...
class	UserException
	Application- or OMG- defined CORBA exception sub-class. More...
class	WrongTransaction
CORBA Primitive Types
Declarations of all CORBA primitive types.
typedef ACE_CDR::Boolean	Boolean
typedef Boolean &	Boolean_out
typedef ACE_CDR::Octet	Octet
typedef Octet &	Octet_out
typedef ACE_CDR::Short	Short
typedef Short &	Short_out
typedef ACE_CDR::UShort	UShort
typedef UShort &	UShort_out
typedef ACE_CDR::Long	Long
typedef Long &	Long_out
typedef ACE_CDR::ULong	ULong
typedef ULong &	ULong_out
typedef ACE_CDR::LongLong	LongLong
typedef LongLong &	LongLong_out
typedef ACE_CDR::ULongLong	ULongLong
typedef ULongLong &	ULongLong_out
typedef ACE_CDR::Float	Float
typedef Float &	Float_out
typedef ACE_CDR::Double	Double
typedef Double &	Double_out
typedef ACE_CDR::LongDouble	LongDouble
typedef LongDouble &	LongDouble_out
typedef ACE_CDR::Char	Char
typedef Char &	Char_out
typedef ACE_CDR::WChar	WChar
typedef WChar &	WChar_out
CORBA String Memory Management
CORBA string memory management functions.
TAO_BEGIN_VERSIONED_NAMESPACE_DECL char *	string_dup (const char *str)
char *	string_alloc (CORBA::ULong len)
void	string_free (char *str)
CORBA Wide String Memory Management
CORBA wide string memory management functions.
CORBA::WChar *	wstring_dup (const WChar *const str)
CORBA::WChar *	wstring_alloc (CORBA::ULong len)
void	wstring_free (CORBA::WChar *const str)
Typedefs
typedef InterfaceDef *	InterfaceDef_ptr
typedef Object *	Object_ptr
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef TAO_Pseudo_Out_T< Object >	Object_out
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef TAO_Pseudo_Out_T< Object >	Object_out
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef TAO_Pseudo_Out_T< Object >	Object_out
typedef TypeCode *	TypeCode_ptr
typedef Policy *	Policy_ptr
typedef TAO::String_var< CORBA::Char >	String_var
typedef TAO::String_out< CORBA::Char >	String_out
typedef TAO::String_var< CORBA::WChar >	WString_var
typedef TAO::String_out< CORBA::WChar >	WString_out
typedef TypeCode *	TypeCode_ptr
typedef Object *	Object_ptr
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef TAO_Pseudo_Out_T< Object >	Object_out
typedef Object *	Object_ptr
typedef ORB *	ORB_ptr
typedef Environment *	Environment_ptr
typedef Object *	Object_ptr
typedef Principal *	Principal_ptr
typedef OperationDef *	OperationDef_ptr
typedef TAO::String_var< char >	String_var
typedef TAO::String_out< char >	String_out
typedef TAO::String_var< CORBA::WChar >	WString_var
typedef TAO::String_out< CORBA::WChar >	WString_out
typedef Object *	Object_ptr
typedef ORB *	ORB_ptr
typedef NVList *	NVList_ptr
typedef NamedValue *	NamedValue_ptr
typedef ExceptionList *	ExceptionList_ptr
typedef Request *	Request_ptr
typedef Context *	Context_ptr
typedef ServerRequest *	ServerRequest_ptr
typedef ULong	Flags
typedef Environment *	Environment_ptr
typedef TAO_Pseudo_Var_T< Environment >	Environment_var
typedef TAO_Pseudo_Out_T< Environment >	Environment_out
typedef TypeCode *	TypeCode_ptr
typedef Any *	Any_ptr
typedef TypeCode *	TypeCode_ptr
typedef InterfaceDef *	InterfaceDef_ptr
typedef ORB *	ORB_ptr
typedef Object *	Object_ptr
typedef OperationDef *	OperationDef_ptr
typedef NVList *	NVList_ptr
typedef Object *	Object_ptr
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef Object *	Object_ptr
typedef ORB *	ORB_ptr
typedef LocalObject *	LocalObject_ptr
typedef TAO_Pseudo_Var_T< LocalObject >	LocalObject_var
typedef TAO_Pseudo_Out_T< LocalObject >	LocalObject_out
typedef Object *	Object_ptr
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef NVList *	NVList_ptr
typedef NamedValue *	NamedValue_ptr
typedef InterfaceDef *	InterfaceDef_ptr
typedef Context *	Context_ptr
typedef Request *	Request_ptr
typedef NVList *	NVList_ptr
typedef NamedValue *	NamedValue_ptr
typedef ULong	Flags
typedef ExceptionList *	ExceptionList_ptr
typedef ContextList *	ContextList_ptr
typedef Object *	Object_ptr
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef TAO_Pseudo_Out_T< Object >	Object_out
typedef Object *	Object_ptr
typedef ORB *	ORB_ptr
typedef Object *	Object_ptr
typedef Object *	Object_ptr
typedef ExceptionList *	ExceptionList_ptr
typedef ContextList *	ContextList_ptr
typedef Context *	Context_ptr
typedef NVList *	NVList_ptr
typedef NamedValue *	NamedValue_ptr
typedef Policy *	Policy_ptr
typedef CORBA::ULong	PolicyType
typedef TAO_VarSeq_Var_T< ORB_ObjectIdList >	ORB_ObjectIdList_var
typedef TAO_Seq_Out_T< ORB_ObjectIdList >	ORB_ObjectIdList_out
typedef ValueFactoryBase *	ValueFactory
typedef UShort	ServiceType
typedef Request *	Request_ptr
typedef TAO_Pseudo_Var_T< Request >	Request_var
typedef TAO_Pseudo_Out_T< Request >	Request_out
typedef ORB *	ORB_ptr
typedef TAO_Pseudo_Var_T< ORB >	ORB_var
typedef TAO_Pseudo_Out_T< ORB >	ORB_out
typedef CORBA::Short	ValueModifier
typedef TAO::unbounded_object_reference_sequence< CORBA::Request, CORBA::Request_var >	RequestSeq
typedef TAO_VarSeq_Var_T< RequestSeq >	RequestSeq_var
typedef TAO_Seq_Out_T< RequestSeq >	RequestSeq_out
typedef ORB *	ORB_ptr
typedef ULong	PolicyType
typedef Policy *	Policy_ptr
typedef TAO_Objref_Var_T< Policy >	Policy_var
typedef TAO_Objref_Out_T< Policy >	Policy_out
typedef CORBA::Short	PolicyErrorCode
typedef CORBA::Short_out	PolicyErrorCode_out
typedef Policy *	Policy_ptr
typedef TAO_Objref_Var_T< Policy >	Policy_var
typedef TAO_Objref_Out_T< Policy >	Policy_out
typedef ULong	PolicyType
typedef Policy *	Policy_ptr
typedef Principal *	Principal_ptr
typedef TAO_Pseudo_Var_T< Principal >	Principal_var
typedef TAO_Pseudo_Out_T< Principal >	Principal_out
typedef Object *	Object_ptr
typedef TAO_Pseudo_Var_T< Object >	Object_var
typedef TAO_Pseudo_Out_T< Object >	Object_out
typedef Object *	Object_ptr
typedef ORB *	ORB_ptr
typedef TCKind &	TCKind_out
typedef TAO_Pseudo_Var_T< TypeCode >	TypeCode_var
typedef TAO_Pseudo_Out_T< TypeCode >	TypeCode_out
typedef CORBA::Short	ValueModifier
typedef Object *	Object_ptr
typedef AbstractBase *	AbstractBase_ptr
typedef ValueFactoryBase *	ValueFactory
Enumerations
enum	exception_type { NO_EXCEPTION, NO_EXCEPTION, USER_EXCEPTION, USER_EXCEPTION, SYSTEM_EXCEPTION, SYSTEM_EXCEPTION }
	Enumeration used to identify the type of CORBA exception. More...
enum	exception_type { NO_EXCEPTION, NO_EXCEPTION, USER_EXCEPTION, USER_EXCEPTION, SYSTEM_EXCEPTION, SYSTEM_EXCEPTION }
enum	CompletionStatus { COMPLETED_YES, COMPLETED_NO, COMPLETED_MAYBE }
	Completion status for CORBA system exceptions. More...
enum	TCKind { tk_null, tk_void, tk_short, tk_long, tk_ushort, tk_ulong, tk_float, tk_double, tk_boolean, tk_char, tk_octet, tk_any, tk_TypeCode, tk_Principal, tk_objref, tk_struct, tk_union, tk_enum, tk_string, tk_sequence, tk_array, tk_alias, tk_except, tk_longlong, tk_ulonglong, tk_longdouble, tk_wchar, tk_wstring, tk_fixed, tk_value, tk_value_box, tk_native, tk_abstract_interface, tk_local_interface, tk_component, tk_home, tk_event, TAO_TC_KIND_COUNT }
Functions
TAO_Export ORB_ptr	ORB_init (int &argc, char argv[], const char orb_name=0)
TAO_NAMESPACE_INLINE_FUNCTION Boolean	is_nil (Environment_ptr)
TAO_NAMESPACE_INLINE_FUNCTION void	release (Environment_ptr)
TAO_NAMESPACE_INLINE_FUNCTION Boolean	is_nil (ORB_ptr)
TAO_NAMESPACE_INLINE_FUNCTION void	release (ORB_ptr)
TAO_NAMESPACE_INLINE_FUNCTION Boolean	is_nil (Object_ptr)
TAO_NAMESPACE_INLINE_FUNCTION void	release (Object_ptr)
TAO_NAMESPACE_INLINE_FUNCTION Boolean	is_nil (Principal_ptr)
TAO_NAMESPACE_INLINE_FUNCTION void	release (Principal_ptr)
TAO_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE CORBA::Boolean	is_nil (CORBA::Environment_ptr env)
ACE_INLINE void	release (CORBA::Environment_ptr env)
ACE_OSTREAM_TYPE &	operator<< (ACE_OSTREAM_TYPE &os, const CORBA::Exception &e)
ACE_OSTREAM_TYPE &	operator<< (ACE_OSTREAM_TYPE &os, const CORBA::Exception *e)
ACE_INLINE void	release (CORBA::Object_ptr obj)
ACE_INLINE CORBA::Boolean	is_nil (CORBA::Object_ptr obj)
CORBA::ORB_ptr	ORB_init (int &argc, char argv[], const char orbid)
ACE_INLINE CORBA::Boolean	is_nil (CORBA::ORB_ptr obj)
ACE_INLINE void	release (CORBA::ORB_ptr obj)
TAO_BEGIN_VERSIONED_NAMESPACE_DECL ACE_INLINE CORBA::Boolean	is_nil (CORBA::Principal_ptr principal)
ACE_INLINE void	release (CORBA::Principal_ptr principal)
Variables
native	ValueFactory
const ULong	OMGVMCID = 0x4f4d0000U
	The OMG Vendor Minor Codeset ID (VMCID).
const CORBA::PolicyErrorCode	BAD_POLICY = 0
const CORBA::PolicyErrorCode	UNSUPPORTED_POLICY = 1
const CORBA::PolicyErrorCode	BAD_POLICY_TYPE = 2
const CORBA::PolicyErrorCode	BAD_POLICY_VALUE = 3
const CORBA::PolicyErrorCode	UNSUPPORTED_POLICY_VALUE = 4

CORBA Namespace Reference

Classes

CORBA Primitive Types

CORBA String Memory Management

CORBA Wide String Memory Management

Typedefs

Enumerations

Functions

Variables

Detailed Description

Typedef Documentation

Enumeration Type Documentation

Function Documentation

Variable Documentation