CORBA::TypeCode implementation for OMG IDL sequence and array types. More...

#include <Sequence_TypeCode.h>

Inheritance diagram for TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >:

Collaboration diagram for TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >:

Public Member Functions
	Sequence (CORBA::TCKind kind, TypeCodeType const &content_type, CORBA::ULong length)
	Constructor.
TAO-specific @c CORBA::TypeCode Methods
Methods required by TAO's implementation of the `CORBA::TypeCode` class. See also: `CORBA::TypeCode`
virtual bool	tao_marshal (TAO_OutputCDR &cdr, CORBA::ULong offset) const
	Marshal this `TypeCode` into a CDR output stream.
virtual void	tao_duplicate (void)
	Increase the reference count on this `TypeCode`.
virtual void	tao_release (void)
	Decrease the reference count on this object.
@c TAO CORBA::TypeCode Template Methods
`CORBA::TypeCode` template methods specific to `tk_sequence` `TypeCodes`. See also: `CORBA::TypeCode`
TypeCodeType const	content_type_
	Element type of the sequence.
CORBA::ULong const	length_
virtual CORBA::Boolean	equal_i (CORBA::TypeCode_ptr tc) const
	Element type of the sequence.
virtual CORBA::Boolean	equivalent_i (CORBA::TypeCode_ptr tc) const
	Element type of the sequence.
virtual CORBA::TypeCode_ptr	get_compact_typecode_i (void) const
	Element type of the sequence.
virtual CORBA::ULong	length_i (void) const
	Element type of the sequence.
virtual CORBA::TypeCode_ptr	content_type_i (void) const
	Element type of the sequence.

Detailed Description

template<typename TypeCodeType, class RefCountPolicy>
class TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >

CORBA::TypeCode implementation for OMG IDL sequence and array types.

This class implements a CORBA::TypeCode for OMG IDL sequence and array types.

Definition at line 44 of file Sequence_TypeCode.h.

Constructor & Destructor Documentation

template<typename TypeCodeType , class RefCountPolicy >

TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::Sequence	(	CORBA::TCKind	kind,
		TypeCodeType const &	content_type,
		CORBA::ULong	length
	)

Constructor.

Definition at line 9 of file Sequence_TypeCode.inl.

  : ::CORBA::TypeCode (kind)
  , RefCountPolicy ()
  , content_type_ (content_type)
  , length_ (length)
{
  // ACE_ASSERT (kind == CORBA::tk_array || kind == CORBA::tk_sequence);
}

Member Function Documentation

template<typename TypeCodeType , class RefCountPolicy >

CORBA::TypeCode_ptr TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::content_type_i ( void ) const [protected, virtual]

Element type of the sequence.

A pointer to the CORBA::TypeCode_ptr rather than the CORBA::TypeCode_ptr itself is stored since that address is well-defined. We may not know the value of the CORBA::TypeCode_ptr when creating this Field statically at compile-time, hence the indirection.

Note:: This TypeCode is released upon destruction of this TypeCode::Sequence.

Reimplemented from CORBA::TypeCode.

Definition at line 136 of file Sequence_TypeCode.cpp.

{
  return
    CORBA::TypeCode::_duplicate (
      Traits<TypeCodeType>::get_typecode (this->content_type_));
}

template<typename TypeCodeType , class RefCountPolicy >

CORBA::Boolean TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::equal_i ( CORBA::TypeCode_ptr tc ) const [protected, virtual]

Element type of the sequence.

A pointer to the CORBA::TypeCode_ptr rather than the CORBA::TypeCode_ptr itself is stored since that address is well-defined. We may not know the value of the CORBA::TypeCode_ptr when creating this Field statically at compile-time, hence the indirection.

Note:: This TypeCode is released upon destruction of this TypeCode::Sequence.

Implements CORBA::TypeCode.

Definition at line 65 of file Sequence_TypeCode.cpp.

{
  // The following calls won't throw since CORBA::TypeCode::equal()
  // has already established the kind of tc is the same as our kind.
  CORBA::ULong const tc_length = tc->length ();

  if (this->length_ != tc_length)
    return 0;

  CORBA::TypeCode_var rhs_content_type =
    tc->content_type ();

  return
    Traits<TypeCodeType>::get_typecode (this->content_type_)->equal (
      rhs_content_type.in ()
     );
}

template<typename TypeCodeType , class RefCountPolicy >

CORBA::Boolean TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::equivalent_i ( CORBA::TypeCode_ptr tc ) const [protected, virtual]

Element type of the sequence.

A pointer to the CORBA::TypeCode_ptr rather than the CORBA::TypeCode_ptr itself is stored since that address is well-defined. We may not know the value of the CORBA::TypeCode_ptr when creating this Field statically at compile-time, hence the indirection.

Note:: This TypeCode is released upon destruction of this TypeCode::Sequence.

Implements CORBA::TypeCode.

Definition at line 87 of file Sequence_TypeCode.cpp.

{
  // The following calls won't throw since CORBA::TypeCode::equal()
  // has already established the kind of tc is the same as our kind.
  CORBA::ULong const tc_length = tc->length ();

  if (this->length_ != tc_length)
    return 0;

  CORBA::TypeCode_var rhs_content_type =
    tc->content_type ();

  return
    Traits<TypeCodeType>::get_typecode (this->content_type_)->equivalent (
      rhs_content_type.in ()
     );
}

template<typename TypeCodeType , class RefCountPolicy >

CORBA::TypeCode_ptr TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::get_compact_typecode_i ( void ) const [protected, virtual]

Element type of the sequence.

A pointer to the CORBA::TypeCode_ptr rather than the CORBA::TypeCode_ptr itself is stored since that address is well-defined. We may not know the value of the CORBA::TypeCode_ptr when creating this Field statically at compile-time, hence the indirection.

Note:: This TypeCode is released upon destruction of this TypeCode::Sequence.

Implements CORBA::TypeCode.

Definition at line 108 of file Sequence_TypeCode.cpp.

{
  // Already compact since tk_sequence and tk_array TypeCodes have no
  // name or member names, meaning that we can simply call
  // _duplicate() on this TypeCode.

  // @@ There is a potential problem here if this TypeCode is a static
  //    and const since it may have been placed in read-only memory by
  //    the compiler.  A const_cast<> can return undefined results in
  //    that case.

  CORBA::TypeCode_ptr mutable_tc =
    const_cast<TAO::TypeCode::Sequence<TypeCodeType, RefCountPolicy> *> (this);

  return CORBA::TypeCode::_duplicate (mutable_tc);
}

template<typename TypeCodeType , class RefCountPolicy >

CORBA::ULong TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::length_i ( void ) const [protected, virtual]

Element type of the sequence.

A pointer to the CORBA::TypeCode_ptr rather than the CORBA::TypeCode_ptr itself is stored since that address is well-defined. We may not know the value of the CORBA::TypeCode_ptr when creating this Field statically at compile-time, hence the indirection.

Note:: This TypeCode is released upon destruction of this TypeCode::Sequence.

Reimplemented from CORBA::TypeCode.

Definition at line 128 of file Sequence_TypeCode.cpp.

{
  return this->length_;
}

template<typename TypeCodeType , class RefCountPolicy >

void TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::tao_duplicate ( void ) [virtual]

Increase the reference count on this TypeCode.

Implements CORBA::TypeCode.

Definition at line 50 of file Sequence_TypeCode.cpp.

{
  this->RefCountPolicy::add_ref ();
}

template<typename TypeCodeType , class RefCountPolicy >

bool TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::tao_marshal	(	TAO_OutputCDR &	cdr,
		CORBA::ULong	offset
	)			const `[virtual]`

Marshal this TypeCode into a CDR output stream.

Marshal this TypeCode into the cdr output CDR stream, excluding the TypeCode kind. Existing cdr contents will not be altered. The marshaled TypeCode will be appended to the given cdr CDR output stream.

Parameters:

	cdr	Output CDR stream into which the `TypeCode` will be marshaled.
	offset	Number of bytes currently in the output CDR stream, including the top-level TypeCode `TCKind`. This argument is useful for recursive `TypeCodes`. `TypeCodes` that contain other `TypeCodes` should pass an updated offset value to the marshaling operation for those contained `TypeCodes`.

Returns:: true if marshaling was successful.

Note:: This is a TAO-specific method that is not part of the standard CORBA::TypeCode interface.; If this method returns false, the contents of the cdr output CDR stream are undefined.

Implements CORBA::TypeCode.

Definition at line 18 of file Sequence_TypeCode.cpp.

{
  // A tk_array or tk_sequence TypeCode has a "complex" parameter list
  // type (see Table 15-2 in Section 15.3.5.1 "TypeCode" in the CDR
  // section of the CORBA specification), meaning that it must be
  // marshaled into a CDR encapsulation.

  // Create a CDR encapsulation.
  TAO_OutputCDR enc;

  // Account for the encoded CDR encapsulation length and byte order.
  //
  // Aligning on an octet since the next value after the CDR
  // encapsulation length will always be the byte order octet/boolean
  // in this case.
  offset = ACE_align_binary (offset + 4,
                             ACE_CDR::OCTET_ALIGN);

  return
    enc << TAO_OutputCDR::from_boolean (TAO_ENCAP_BYTE_ORDER)
    && marshal (enc,
                Traits<TypeCodeType>::get_typecode (this->content_type_),
                offset + enc.total_length ())
    && enc << this->length_
    && cdr << static_cast<CORBA::ULong> (enc.total_length ())
    && cdr.write_octet_array_mb (enc.begin ());
}

template<typename TypeCodeType , class RefCountPolicy >

void TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::tao_release ( void ) [virtual]

Decrease the reference count on this object.

Implements CORBA::TypeCode.

Definition at line 57 of file Sequence_TypeCode.cpp.

{
  this->RefCountPolicy::remove_ref ();
}

Member Data Documentation

template<typename TypeCodeType , class RefCountPolicy >

TypeCodeType const TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::content_type_ [private]

Element type of the sequence.

A pointer to the CORBA::TypeCode_ptr rather than the CORBA::TypeCode_ptr itself is stored since that address is well-defined. We may not know the value of the CORBA::TypeCode_ptr when creating this Field statically at compile-time, hence the indirection.

Note:: This TypeCode is released upon destruction of this TypeCode::Sequence.

Definition at line 99 of file Sequence_TypeCode.h.

template<typename TypeCodeType , class RefCountPolicy >

CORBA::ULong const TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >::length_ [private]

Length of the sequence or array. A length of zero indicates an unbounded sequence.

Definition at line 103 of file Sequence_TypeCode.h.

The documentation for this class was generated from the following files:

TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy > Class Template Reference

Public Member Functions

@c TAO CORBA::TypeCode Template Methods

Detailed Description

template<typename TypeCodeType, class RefCountPolicy> class TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<typename TypeCodeType, class RefCountPolicy>
class TAO::TypeCode::Sequence< TypeCodeType, RefCountPolicy >