CORBA API

CORBA Programming Reference

CORBA::Object::_is_equivalent

Synopsis

Determines if two object references are equivalent.

C++ Binding

CORBA::Boolean CORBA::Object::_is_equivalent (
                         CORBA::Object_ptr other_obj);

Argument

other_obj

The object reference for the other object, which is used for comparison with the target object.

Exceptions

Can throw a standard CORBA exception.

Description

This member function is used to determine if two object references are equivalent, so far as the ORB can easily determine. It returns TRUE if your object reference is equivalent to the object reference you pass as a parameter. If two object references are identical, they are equivalent. Two different object references that refer to the same object are also equivalent.

Return Values

Returns TRUE if the target object reference is known to be equivalent to the other object reference passed as a parameter; otherwise, it returns FALSE.

Example

CORBA::Object_ptr op = TP::create_object_reference(
                                  "IDL:Teller:1.0", "MyTeller");
CORBA::Object_ptr dop = CORBA::Object::_duplicate(op);
CORBA::Boolean b = op->_is_equivalent(dop);