cubrid_prepare(3) [php man page]
CUBRID_PREPARE(3) 1 CUBRID_PREPARE(3) cubrid_prepare - Prepare a SQL statement for execution SYNOPSIS
resource cubrid_prepare (resource $conn_identifier, string $prepare_stmt, [int $option]) DESCRIPTION
The cubrid_prepare(3) function is a sort of API which represents SQL statements compiled previously to a given connection handle. This pre-compiled SQL statement will be included in the cubrid_prepare(3). Accordingly, you can use this statement effectively to execute several times repeatedly or to process long data. Only a single statement can be used and a parameter may put a question mark (?) to appropriate area in the SQL statement. Add a parameter when you bind a value in the VALUES clause of INSERT statement or in the WHERE clause. Note that it is allowed to bind a value to a MARK(?) by using the cubrid_bind(3) function only. PARAMETERS
o $conn_identifier -Connection identifier. o $prepare_stmt -Prepare query. o $option -OID return option CUBRID_INCLUDE_OID. RETURN VALUES
Request identifier, if process is successful; FALSE, if process is unsuccessful. EXAMPLES
Example #1 cubrid_prepare(3) example <?php $conn = cubrid_connect("localhost", 33000, "demodb"); $sql = <<<EOD SELECT g.event_code, e.name FROM game g JOIN event e ON g.event_code=e.code WHERE host_year = ? AND event_code NOT IN (SELECT event_code FROM game WHERE host_year=?) GROUP BY event_code; EOD; $req = cubrid_prepare($conn, $sql); cubrid_bind($req, 1, 2004); cubrid_bind($req, 2, 2000); cubrid_execute($req); $row_num = cubrid_num_rows($req); printf("There are %d event that exits in 2004 olympic but not in 2000. For example: ", $row_num); printf("%-15s %s ", "Event_code", "Event_name"); printf("---------------------------- "); $row = cubrid_fetch_assoc($req); printf("%-15d %s ", $row["event_code"], $row["name"]); $row = cubrid_fetch_assoc($req); printf("%-15d %s ", $row["event_code"], $row["name"]); cubrid_disconnect($conn); ?> The above example will output: There are 27 event that exits in 2004 olympic but not in 2000. For example: Event_code Event_name ---------------------------- 20063 +91kg 20070 64kg SEE ALSO
cubrid_execute(3), cubrid_bind(3). PHP Documentation Group CUBRID_PREPARE(3)
Check Out this Related Man Page
CUBRID_EXECUTE(3) 1 CUBRID_EXECUTE(3) cubrid_execute - Execute a prepared SQL statement SYNOPSIS
resource cubrid_execute (resource $conn_identifier, string $sql, [int $option]) DESCRIPTION
bool cubrid_execute (resource $request_identifier, [int $option]) The cubrid_execute(3) function is used to execute the given SQL statement. It executes the query by using $conn_identifier and SQL, and then returns the request identifier created. It is used for simple execution of query, where the parameter binding is not needed. In addi- tion, the cubrid_execute(3) function is used to execute the prepared statement by means of cubrid_prepare(3) and cubrid_bind(3). At this time, you need to specify arguments of $request_identifier and $option. The $option is used to determine whether to get OID after query execution and whether to execute the query in synchronous or asynchronous mode. CUBRID_INCLUDE_OID and CUBRID_ASYNC (or CUBRID_EXEC_QUERY_ALL if you want to execute multiple SQL statements) can be specified by using a bitwise OR operator. If not specified, neither of them isselected. If the flag CUBRID_EXEC_QUERY_ALL is set, a synchronous mode (sync_mode) is used to retrieve query results, and in such cases the following rules are applied: oThe return value is the result of the first query. o If an error occurs in any query, the execution is processed as a failure. o In a query composed of q1 q2 q3, if an error occurs in q2 after q1 succeeds the execution, the result of q1 remains valid. That is, the previous successful query executions are not rolled back when an error occurs. o If a query is executed successfully, the result of the second query can be obtained using cubrid_next_result(3). If the first argument is $request_identifier to execute the cubrid_prepare(3) function, you can specify an option, CUBRID_ASYNC only. PARAMETERS
o $conn_identifier -Connection identifier. o $sql -SQL to be executed. o $option -Query execution option CUBRID_INCLUDE_OID, CUBRID_ASYNC, CUBRID_EXEC_QUERY_ALL. o $request_identifier -cubrid_prepare(3) identifier. RETURN VALUES
Request identifier, when process is successful and first param is conn_identifier; TRUE, when process is successful and first argument is request_identifier. FALSE, when process is unsuccessful. CHANGELOG
+--------+----------------------------------------+ |Version | | | | | | | Description | | | | +--------+----------------------------------------+ | 8.4.0 | | | | | | | Add new option CUBRID_EXEC_QUERY_ALL. | | | | +--------+----------------------------------------+ EXAMPLES
Example #1 cubrid_execute(3) example <?php $conn = cubrid_connect("localhost", 33000, "demodb"); $result = cubrid_execute($conn, "SELECT code FROM event WHERE name='100m Butterfly' and gender='M'", CUBRID_ASYNC); $row = cubrid_fetch_array($result, CUBRID_ASSOC); $event_code = $row["code"]; cubrid_close_request($result); $history_req = cubrid_prepare($conn, "SELECT * FROM history WHERE event_code=?"); cubrid_bind($history_req, 1, $event_code, "number"); cubrid_execute($history_req); printf("%-20s %-9s %-10s %-5s ", "athlete", "host_year", "score", "unit"); while ($row = cubrid_fetch_array($history_req, CUBRID_ASSOC)) { printf("%-20s %-9s %-10s %-5s ", $row["athlete"], $row["host_year"], $row["score"], $row["unit"]); } cubrid_close_request($history_req); cubrid_disconnect($conn); ?> The above example will output: athlete host_year score unit Phelps Michael 2004 51.25 time SEE ALSO
cubrid_prepare(3), cubrid_bind(3), cubrid_next_result(3), cubrid_close_request(3), cubrid_commit(3), cubrid_rollback(3). PHP Documentation Group CUBRID_EXECUTE(3)