org.omg.DynamicAny

Interface DynSequenceOperations

public interface DynSequenceOperations extends DynAnyOperations

Defines operations, applicable to DynSequence. These are basically the same operations as for {@link DynArrayOperations} with additional possibility to change the length of the sequence. If the {@link org.omg.CORBA.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 {@link InvalidValue}.
Method Summary
Any[]get_elements()
Returns the array, containing the sequence elements.
DynAny[]get_elements_as_dyn_any()
Returns the array, containing the sequence elements.
intget_length()
Get the length of the sequence.
voidset_elements(Any[] value)
Sets the sequence elements from the array.
voidset_elements_as_dyn_any(DynAny[] value)
Sets the sequence elements from the array.
voidset_length(int length)
Set the length of the sequence.

Method Detail

get_elements

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

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

get_elements_as_dyn_any

public 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_length

public 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_elements

public void set_elements(Any[] value)
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.

set_elements_as_dyn_any

public void set_elements_as_dyn_any(DynAny[] value)
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_length

public void set_length(int length)
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.