[Enterprise Extensions only]

Container::lookup

Overview The lookup operation locates a definition relative to this container given a scoped name using OMG IDL's name scoping rules.
Original interface CORBA module: Container Interface
Exceptions CORBA::SystemException


Intended Usage

The lookup operation locates a definition relative to this container given a scoped name using OMG IDL's name scoping rules. An absolute scoped name (beginning with "::") locates the definition relative to the enclosing Repository. If no object is found, a nil object reference is returned.

IDL Syntax

  Contained lookup (in ScopedName search_name);

Input parameters

search_name
The search_name is the scoped name of the object using OMG IDL's name scoping rules. This name is used as the search criteria for locating the object within the Interface Repository.

Return values

Contained_ptr
The return value is a pointer to a CORBA::Contained object resulting from the search. If the search_name was not located within the Interface Repository, a nil object is returned. If a non nil CORBA::Contained object pointer is returned, the memory associated with the object is owned by the caller and can be released by invoking CORBA::release.

Example

  // C++
     // assume that 'module_1' has already been initialized
     CORBA::ModuleDef * module_1;
 
     // use the scoped name to lookup an operation . . .
     CORBA::Contained * ret_contained;
     ret_contained = module_1-> lookup ("Module2::Interface6::Operation7");;