[Enterprise Extensions only]

InterfaceDef::is_a

Overview The is_a operation is used to determine if the target interface is identical to or inherits from another interface referenced by its unique CORBA::RepositoryId.
Original interface CORBA::InterfaceDef
Exceptions CORBA::SystemException


Intended Usage

The is_a operation returns TRUE if the interface on which it is invoked either is identical to or inherits, directly or indirectly, from the interface identified by its interface_id parameter. Otherwise it returns FALSE. The is_a read operation parameter and result description is provided below.

IDL Syntax

  boolean is_a(in RepositoryId interface_id);

Input parameters

interface_id
The ID attribute that globally identifies a Contained object.

Return values

Boolean
The return value is the result of the evaluation of the target object and the referenced object as in the Intended Usage section.

Example

  // C++
     // assume 'this_interface' and "other_interfaces_rep_id' 
     // have already been initialized
     CORBA::InterfaceDef * this_interface;
     CORBA::RepositoryId other_interfaces_rep_id;
 
     // determine if the two objects are related
     CORBA::Boolean returned_boolean;
     returned_boolean = this_interface-> is_a (other_interfaces_rep_id);