Bull DPX/20 Betriebsanweisung Seite 323

  • Herunterladen
  • Zu meinen Handbüchern hinzufügen
  • Drucken
  • Seite
    / 424
  • Inhaltsverzeichnis
  • LESEZEICHEN
  • Bewertet. / 5. Basierend auf Kundenbewertungen
Seitenansicht 322
3-17
Interface Repository Framework Reference
lookup_name Method
Purpose
Locates an object by name within a specified Container object of the Interface Repository,
or within objects contained in the Container object.
IDL Syntax
sequence<Contained> lookup_name (
in Identifier search_name,
in long levels_to_search,
in InterfaceName limit_type,
in boolean exclude_inherited);
Description
The lookup_name method locates an object by name within a specified Container object,
or within objects contained in the Container object. The search_name parameter specifies
the name of the object to be found. Each object represents a component of an IDL interface
(class) definition maintained within the Interface Repository.
The levels_to_search argument controls whether the lookup is constrained to the specified
Container object or whether objects contained within the Container object are also
searched. The levels_to_search value should be –1 to search the Container and all
contained objects; it should be 1 to search only the Container itself.
If limit_type is set to “all”, the lookup locates an object of the specified name with any
interface type; otherwise, the search locates the object only if it has the designated interface
type. Valid values for InterfaceName are limited to the following set:
{“AttributeDef”, “ConstantDef”, “ExceptionDef”, “InterfaceDef”, “ModuleDef”,
“ParameterDef”, “OperationDef”, “TypeDef”, “all”}
If exclude_inherited is set to TRUE, any inherited objects will not be returned.
When finished using the sequence returned by this method, the client code is responsible
for releasing each of the objects in the sequence and freeing the sequence buffer. In C, this
can be accomplished as follows:
if (seq._length) {
long i;
for (i=0; i<seq._length; i++)
SOMObject_somFree (seq._buffer[i]);
/* Release each object */
SOMFree (seq._buffer); /* Release the buffer */
}
Parameters
receiver A pointer to a Container object in which to locate the object.
ev A pointer to the Environment structure for the caller.
search_name The name of the object to be located.
levels_to_search
A long having the value 1 or –1.
limit_type The name of one interface type (see the previous list of valid items) specify
what type of object to search for.
exclude_inherited
A boolean value: TRUE to exclude an object when it is inherited, or FALSE
to return the object from wherever it is found.
Seitenansicht 322
1 2 ... 318 319 320 321 322 323 324 325 326 327 328 ... 423 424

Kommentare zu diesen Handbüchern

Keine Kommentare