ifx_prepare
Name
ifx_prepare — Prepare an SQL-statement for execution
Synopsis
int ifx_prepare(sql, conn[,
cursor][, blobidarray]);
string sql: SQL
statement
int conn: Connection
handler
int cursor (optional):
Cursor type
mixed blobidarray
(optional): Blob identifiers
Returns
Result handler or FALSE on error
Description
Prepares a query for executuin. The result handler
returned can be passed to ifx_do() for execution. This
function allows a SQL query to be sent to the database
for parsing and the approximate number of rows affected
by the query returned without actually executing the
query itself. If using a non-SELECT query, the
approximate number of affected rows is returned. The
accurate number os returned when ifx_do() is called.
By default a normal sequential cursor is used i.e. Only
the next row in the result can be returned. Specifying an
optional cursor allows either
'scroll' or 'hold' cursors to be used. These are defined
using the constants IFX_SCROLL and IFX_HOLD and they can
be used singly or bitwise or'd together. A scroll cursor
allows rows in the result set to be retrieved in any
sequence. A hold cursor allows access to a result set
across transactions and the cursor does not close at the
end of the trnasaction.
If the query contains BLOBS use the blobidarray parameter to specify the blob
columns in your quwry. Remember to replace the column in
the SQL query with a ?. ifx_query() replaces the
columns with the correct data when the query is executed.
Version
Since version 3.0.4 and 4.0
Example
Example 578. Prepare and
execute a query
ifx_connect( "stores7@demo_se", "testuser", "password" );
$result = ifx_prepare("SELECT customer_num, company FROM customer", $conn);
ifx_do($result);
PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing
(Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch).
This material may be distributed only subject to the terms and conditions set forth
in the Open Publication License, v1.0 or later (the latest version is presently available at
http://www.opencontent.org/openpub/).
The authors of this book have elected not to choose any options under the OPL. This online book was obtained
from
http://www.fooassociates.com/phpfer/
and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4
for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All
persons and entities shall have neither liability nor responsibility to any person or entity with respect to
any loss or damage arising from the information contained in this book.
PhpDig.net