![]() |
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");;