[Enterprise Extensions only]

Object::_nil

Overview Returns a nil CORBA::Object reference.
Original class CORBA::Object


Intended Usage

This method is intended to be used by client and server applications to create a nil Object reference. Since a nil value proxy object may be generated and returned by this call (versus a NULL), nil references can and should be released when no longer required by the client application. Due to this "variable" returned value, client and server applications should be using the CORBA::is_nil() method for checking for nil references (instead of checking against NULL).

IDL Syntax

  static CORBA::Object_ptr _nil ();

Input parameters

None.

Return values

CORBA::Object_ptr
A nil Object reference.

Example

  /* Assume the following IDL interface */
  interface testObject
  {
    string testMethod ( in long input_value, out float out_value);
  };
  /* Here is the cpp code */
  testObject_ptr test_obj = testObject::_nil();
  ...