Oracle C++ Call Interface Programmer's Guide

Statement Class
If UPDATE_COUNT_AVAILABLE is returned, the getUpdateCount method must be
called to find out the update count.
If NEEDS_STREAM_DATA is returned, output Streams must be written for the
streamed IN bind parameters. If there is more than one streamed parameter, call the
getCurrentStreamParam method to find out the bind parameter needing the
stream. If the statement is executed iteratively, call getCurrentIteration to find
out the iteration for which stream needs to be written.
If STREAM_DATA_AVAILABLE is returned, input Streams must be read for the
streamed OUT bind parameters. If there is more than one streamed parameter, call
the getCurrentStreamParam method to find out the bind parameter needing the
stream. If the statement is executed iteratively, call getCurrentIteration 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, iterative executes can be performed for DML returning statements. 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.
Returns
■ RESULT_SET_AVAILABLE-- call getResultSet()
■ UPDATE_COUNT_AVAILABLE -- call getUpdateCount()
■ NEEDS_STREAM_DATA -- call getCurrentStream() and
getCurrentIteration(), and write (or read) stream
Syntax
Status execute(const string &sql = "");
Parameters
executeArrayUpdate()
sql
The SQL statement to be executed. This can be null if the setSQL method was used
to associate the sql with the statement.
Executes insert/update/delete statements which use only the setDataBuffer() or
stream interface for bind parameters. The bind parameters must be arrays of size
OCCI Classes and Methods 8-173