CORBA Programming Reference

void CORBA::Any::replace()

Synopsis

Nontype safe Any "insertion."

C++ Binding

void CORBA::Any::replace(TypeCode_ptr TC, void * Value,
                Boolean Release = CORBA_FALSE);

Arguments

TC

A TypeCode pseudo-object reference specifying the TypeCode value for the replaced Any object. This argument is duplicated.

Value

A void pointer specifying the storage pointed to by the Any object.

Release

Determines whether the Any manages the specified Value argument. If Release is CORBA_TRUE, the Any assumes ownership. If Release is CORBA_FALSE, the Any does not assume ownership and the data pointed to by the Value parameter is not released upon assignment or destruction.

Description

These member functions replace the data and TypeCode value currently contained in the Any with the value of the TC and Value arguments passed in. The functions perform a nontype-safe replacement, which means that the caller is responsible for consistency between the TypeCode value and the data type of the storage pointed to by the Value argument.

If the value of Release is CORBA_TRUE, this function releases the existing TypeCode pseudo-object in the Any object and frees the storage pointed to be the Any object reference.

Return Values

None.

Context Member Functions

A Context supplies optional context information associated with a method invocation.

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

class CORBA
{ 
  class Context
  {
    public:
      const char *context_name() const;
      Context_ptr parent() const;

      void create_child(const char *, Context_out);

      void set_one_value(const char *, const Any &);
      void set_values(NVList_ptr);
      void delete_values(const char *);
      void get_values(
                  const char *,
                  Flags,
                  const char *,
                  NVList_out
      );
  }; // Context
}// CORBA

Memory Management

Context has the following special memory management rule:

Ownership of the return values of the context_name and parent functions is maintained by the Context; these return values must not be freed by the caller.

This section describes Context member functions.