[Enterprise Extensions only]

Contained::absolute_name

Overview The absolute_name operation retrieves the absolute ScopedName that identifies a Contained object within its enclosing Repository.
Original interface CORBA module: Contained Interface
Exceptions CORBA::SystemException


Intended Usage

The absolute_name attribute is an absolute ScopedName that identifies a Contained object uniquely within its enclosing Repository.

If the Container within which this object is defined is a Repository, the absolute name is formed by concatenating the string "::" and this object's name attribute. Otherwise, the absolute_name is formed by concatenating the absolute_name attribute of the object referenced by this object's defined_in attribute, the string "::", and this object's name attribute.

A read operation is provided to retrieve the absolute_name value for all Interface Repository objects that have a name attribute.

IDL Syntax

  readonly attribute ScopedName absolute_name;

Input parameters

None

Return values

ScopedName
The returned value is a CORBA::ScopedName data type, the memory of which is owned by the caller. The caller can release this memory by invoking the CORBA::string_free function.

Example

  // C++
     // assume the interface_def_ptr has already been initialized
     CORBA::InterfaceDef * interface_def_ptr;
 
     // the following call returns the absolute name associated with the 
     // interface
     CORBA::ScopedName returned_absolute_name;
     returned_absolute_name = interface_def_ptr-> absolute_name();