CORBA Programming Reference

CORBA::NVList::remove

Synopsis

Removes the item at the specified index, frees any associated memory, and reorders the remaining items on the list.

C++ Binding

void CORBA::NVList::remove (
     CORBA::ULong             Index);

Argument

Index

The index into the NVList object. The indexing is zero-based.

Exception

If this function does not succeed, the BAD_PARAM exception is thrown.

Description

This member function removes the item at the specified index, frees any associated memory, and reorders the remaining items on the list.

Return Values

None.

Object Member Functions

The rules in this section apply to the OMG IDL interface Object, which is the base of the OMG IDL interface hierarchy. Interface Object defines a normal CORBA object, not a pseudo-object. However, it is included here because it references other pseudo-objects.

In addition to other rules, all operation names in interface Object have leading underscores in the mapped C++ class. Also, the mapping for create_request is divided into three forms, corresponding to the usage styles described in the section Request Member Functions. The is_nil and release functions are provided in the CORBA namespace, as described in Object Member Functions.

The BEA Tuxedo software uses object reference operations that are defined by CORBA Revision 2.2. These operations depend only on type Object, so they can be expressed as regular functions within the CORBA namespace.

Note: Because the BEA Tuxedo software uses the POA and not the BOA, the deprecated get_implementation() member function is not visible; you will get a compile error if you attempt to reference it.

The mapping of these member functions to C++ is as follows:

class CORBA 
{
  class Object
  {
    public:
       CORBA::Boolean _is_a(const char *)
       CORBA::Boolean _is_equivalent();
       CORBA::Boolean _nonexistent(Object_ptr);

       static Object_ptr _duplicate(Object_ptr obj);
       static Object_ptr _nil();
       InterfaceDef_ptr _get_interface();
       CORBA::ULong _hass(CORBA::ULong);
       void _create_request(
                  Context_ptr ctx,
                  const char *operation,
                  NVList_ptr arg_list,
                  NamedValue_ptr result,
                  Request_out request,
                  Flags req_flags
      	);
      	Status _create_request(
                 Context_ptr        ctx,
                 const char *       operation,
                 NVList_ptr         arg_list,
                 NamedValue_ptr     result,
                 ExceptionList_ptr  Except_list,   
                 ContextList_ptr    Context_list,
                 Request_out       request,
                 Flags             req_flags
      );
      Request_ptr _request(const char* operation);
  }; //Object
}; // CORBA

The following sections describe the Object member functions.