CORBA API

CORBA Programming Reference

CORBA::is_nil

Synopsis

Determines if an object exists for the specified object type.

C++ Binding

CORBA::Boolean CORBA::is_nil(spec_object_type obj);

Argument

obj

The object reference. The specified object type must be one of the types listed in the section CORBA Member Functions.

Description

This member function is used to determine if a specified object reference is nil. It returns TRUE if the object reference contains the special value for a nil object reference as defined by the ORB.

This operation may not throw CORBA exceptions.

Return Values

Returns TRUE if the specified object is nil; otherwise, returns FALSE.

Example

CORBA::Object_ptr op = TP::create_object_reference(
                             "IDL:Teller:1.0", "MyTeller");
CORBA::Boolean b = CORBA::is_nil(op);