Oracle C++ Call Interface Programmer's Guide

Statement Class
arrayLength parameter. The statement may have read-able streams which may have
to be written. The returned value is one of the following:
■ UPDATE_COUNT_AVAILABLE
■ NEEDS_STREAM_DATA
■ STREAM_DATA_AVAILABLE
■ PREPARED
■ UNPREPARED
If UPDATE_COUNT_AVAILABLE is returned, getUpdateCount() must be called to
find out the update count.
If NEEDS_STREAM_DATA is returned, output Streams must be written for the
streamed bind parameters. If there is more than one streamed parameter,
getCurrentStreamParam() can be called to find out the bind parameter needing
the stream. The getCurrentIteration() can be called to find out the iteration
for which stream needs to be written.
If STREAM_DATA_AVAIALBE is returned, input Streams must be read for the
streamed OUT bind parameters. If there is more than one streamed parameter,
getCurrentStreamParam() can be called to find out the bind parameter needing
the stream. If the statement is executed iteratively, getCurrentIteration() can
be called to find out the iteration for which stream needs to be read.
If only one OUT value is returned for each invocation of the DML returning
statement, array executes can be done for DML returning statements also. If output
streams are used for OUT bind variables, they must be completely read in order. The
getCurrentStreamParam() method would indicate which stream needs to be
read. Similarly, getCurrentIteration() would indicate the iteration for which
data is available.
Note that you cannot perform array executes for queries or callable statements.
Syntax
Status executeArrayUpdate(unsigned int arrayLength);
Parameters
arrayLength
The number of elements provided in each buffer of bind variables. The statement is
executed this many times with each array element used for each iteration. Returns:
■ UPDATE_COUNT_AVAILABLE -- call getUpdateCount()
8-174 Oracle C++ Call Interface Programmer’s Guide