Oracle C++ Call Interface Programmer's Guide

Status Definitions
Executing Statements Dynamically
Statement stmt = conn->createStatement();
Statement::Status status = stmt->status(); // status is UNPREPARED
stmt->setSQL("select * from emp");
status = stmt->status(); // status is PREPARED
If a statement handle is created with a SQL string, then it is created in a PREPARED
state. For example:
Statement stmt = conn->createStatement("insert into foo(id) values(99)");
Statement::Status status = stmt->status(); // status is PREPARED
status = stmt->execute(); // status is UPDATE_COUNT_AVAILABLE
When you set another SQL statement on the Statement, the status changes to
PREPARED. For example:
stmt->setSQL("select * from emp"); // status is PREPARED
status = stmt->execute(); // status is RESULT_SET_AVAILABLE
This section describes the possible values of Status related to a statement handle:
■ UNPREPARED
■ PREPARED
■ RESULT_SET_AVAILABLE
■ UPDATE_COUNT_AVAILABLE
■ NEEDS_STREAM_DATA
■ STREAM_DATA_AVAILABLE
UNPREPARED
If you have not used the setSQL method to attribute a SQL string to a statement
handle, then the statement is in an UNPREPARED state.
Statement stmt = conn->createStatement();
Statement::Status status = stmt->status(); // status is UNPREPARED
PREPARED
If a Statement is created with a SQL string, then it is created in a PREPARED state.
For example:
Statement stmt = conn->createStatement("INSERT INTO demo_tab(id)
Relational Programming 2-17