CORBA Programming Reference

CORBA::ContextList::remove

Synopsis

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

C++ Binding

Status remove(ULong index);

Argument

Index

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

Exceptions

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.

NamedValue Member Functions

NamedValue is used only as an element of NVList, especially in the DII. NamedValue maintains an (optional) name, an any value, and labelling flags. Legal flag values are CORBA::ARG_IN, CORBA::ARG_OUT, and CORBA::ARG_INOUT.

The value in a NamedValue may be manipulated via standard operations on any.

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

// C++
class NamedValue
{
  public:
    Flags        flags() const;
    const char * name() const;
    Any *        value() const;
};

Memory Management

NamedValue has the following special memory management rule:

Ownership of the return values of the name() and value() functions is maintained by the NamedValue; these return values must not be freed by the caller.

The following sections describe NamedValue member functions.