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).

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();
  ...

Related reference
CORBA module



Searchable topic ID:   rcor_modob9
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_modob9.html

Library | Support | Terms of Use | Feedback