org.omg.DynamicAny
Interface DynSequenceOperations

All Superinterfaces:
DynAnyOperations
All Known Subinterfaces:
DynSequence
All Known Implementing Classes:
_DynSequenceStub

public interface DynSequenceOperations
extends DynAnyOperations

Defines operations, applicable to DynSequence. These are basically the same operations as for DynArrayOperations with additional possibility to change the length of the sequence. If the TypeCode.length() method of the sequence typecode returns positive value, it is treated as a sequence bound. An attempt to extend the sequence above its bound raises InvalidValue.


Method Summary
 DynAny[] get_elements_as_dyn_any()
          Returns the array, containing the sequence elements.
 Any[] get_elements()
          Returns the array, containing the sequence elements.
 int get_length()
          Get the length of the sequence.
 void set_elements_as_dyn_any(DynAny[] value)
          Sets the sequence elements from the array.
 void set_elements(Any[] value)
          Sets the sequence elements from the array.
 void set_length(int length)
          Set the length of the sequence.
 
Methods inherited from interface org.omg.DynamicAny.DynAnyOperations
assign, component_count, copy, current_component, destroy, equal, from_any, get_any, get_boolean, get_char, get_double, get_dyn_any, get_float, get_long, get_longlong, get_octet, get_reference, get_short, get_string, get_typecode, get_ulong, get_ulonglong, get_ushort, get_val, get_wchar, get_wstring, insert_any, insert_boolean, insert_char, insert_double, insert_dyn_any, insert_float, insert_long, insert_longlong, insert_octet, insert_reference, insert_short, insert_string, insert_typecode, insert_ulong, insert_ulonglong, insert_ushort, insert_val, insert_wchar, insert_wstring, next, rewind, seek, to_any, type
 

Method Detail

get_length

int get_length()
Get the length of the sequence.

Returns:
the current sequence length that was taken from typecode or changed with set_length.

set_length

void set_length(int length)
                throws InvalidValue
Set the length of the sequence. If the sequence is shortened, the tailing members are discarded, but the remaining content is not affected. If the new length is larger than the previous one, the new members are added to the end of the sequence. These new members are initialised to they default values.

Parameters:
length - the new length of the sequence.
Throws:
InvalidValue - if this is a bounded sequence, and the size being set exceeds the sequence bound.

get_elements_as_dyn_any

DynAny[] get_elements_as_dyn_any()
Returns the array, containing the sequence elements.

Returns:
the array of elements as an array of DynAny's.

get_elements

Any[] get_elements()
Returns the array, containing the sequence elements.

Returns:
the array of elements as an array of Any's.

set_elements_as_dyn_any

void set_elements_as_dyn_any(DynAny[] value)
                             throws TypeMismatch,
                                    InvalidValue
Sets the sequence elements from the array. The length of the sequence is set to the length of the passed array.

Parameters:
value - the array of elements an DynAny's.
Throws:
TypeMismatch - if the members of the passed array does not match sequence component type.
InvalidValue - if this is a bounded sequence and the number of elements in the passed array exceeds the sequence bound.

set_elements

void set_elements(Any[] value)
                  throws TypeMismatch,
                         InvalidValue
Sets the sequence elements from the array. The length of the sequence is set to the length of the passed array.

Parameters:
value - the array of elements as Any's.
Throws:
TypeMismatch - if the members of the passed array does not match sequence component type.
InvalidValue - if this is a bounded sequence and the number of elements in the passed array exceeds the sequence bound.