Request-Level Interceptor API

Using CORBA Request-Level Interceptors

DataInputStream::read_array_<primitive>

Synopsis

Returns an array of primitive values from the stream into a CORBA sequence.

C++ Binding

void read_array_<primitive>(     <primitive>Seq & seq, 
                                 ULong offset, 
                                  ULong length);

Parameters

<primitive>Seq

A sequence of the appropriate type that will receive the array elements read.

If the sequence was not long enough to contain the additional elements, the length will be set to the sum offset+length. (The length will not be adjusted down.)

Offset

The offset into the array to read the elements. That is, the array will have new elements starting at array index offset up to array index offset+length-1.

Length

The number of elements of the array to be returned into the seq parameter.

Exceptions

None.

Description

The operations to read an array of primitive elements (<primitive>) from a DataInputStream all have the same format. Each operation returns an array of primitive values from the stream into a CORBA sequence of that same primitive type.

The primitives are the following:

AnySeq (Not implemented)
BooleanSeq
CharSeq
OctetSeq
ShortSeq 
UshortSeq
LongSeq
UlongSeq
FloatSeq
DoubleSeq

Return Values

None.