| |
db2_bind_param (no version information, might be only in CVS) db2_bind_param --
Binds a PHP variable to an SQL statement parameter
Descriptionbool db2_bind_param ( resource stmt, int parameter-number, string variable-name [, int parameter-type [, int data-type [, int precision [, int scale]]]] ) | Warning | This function is
EXPERIMENTAL. The behaviour of this function, the
name of this function, and anything else documented about this
function may change without notice in a future release of PHP.
Use this function at your own risk. |
Binds a PHP variable to an SQL statement parameter in a statement resource
returned by db2_prepare(). This function gives you more
control over the parameter type, data type, precision, and scale for the
parameter than simply passing the variable as part of the optional input
array to db2_execute().
Parameters
- stmt
A prepared statement returned from db2_prepare().
- parameter-number
Specifies the 1-indexed position of the parameter in the prepared
statement.
- variable-name
A string specifying the name of the PHP variable to bind to the
parameter specified by parameter-number.
- parameter-type
A constant specifying whether the PHP variable should be bound to the
SQL parameter as an input parameter (DB2_PARAM_IN),
an output parameter (DB2_PARAM_OUT), or as a
parameter that accepts input and returns output
(DB2_PARAM_INOUT).
- data-type
A constant specifying the SQL data type that the PHP variable should be
bound as: one of DB2_BINARY,
DB2_CHAR, DB2_DOUBLE, or
DB2_LONG .
- precision
Specifies the precision with which the variable should be bound to the
database.
- scale
Specifies the scale with which the variable should be bound to the
database.
Return Values
Returns TRUE on success or FALSE on failure.
Examples
Example 1. Binding PHP variables to a prepared statement
The SQL statement in the following example uses two input parameters in
the WHERE clause. We call db2_bind_param() to bind two
PHP variables to the corresponding SQL parameters. Notice that the PHP
variables do not have to be declared or assigned before the call to
db2_bind_param(); in the example,
$lower_limit is assigned a value before the call to
db2_bind_param(), but $upper_limit
is assigned a value after the call to
db2_bind_param(). The variables must be bound and, for
parameters that accept input, must have any value assigned, before calling
db2_execute().
<?php
$sql = 'SELECT name, breed, weight FROM animals
WHERE weight > ? AND weight < ?';
$conn = db2_connect($database, $user, $password);
$stmt = db2_prepare($conn, $sql);
// We can declare the variable before calling db2_bind_param()
$lower_limit = 1;
db2_bind_param($stmt, 1, "lower_limit", DB2_PARAM_IN);
db2_bind_param($stmt, 2, "upper_limit", DB2_PARAM_IN);
// We can also declare the variable after calling db2_bind_param()
$upper_limit = 15.0;
if (db2_execute($stmt)) {
while ($row = db2_fetch_array($stmt)) {
print "{$row[0]}, {$row[1]}, {$row[2]}\n";
}
}
?>
|
The above example will output: Pook, cat, 3.2
Rickety Ride, goat, 9.7
Peaches, dog, 12.3 |
|
Copyright © 1997 - 2007 by the PHP Documentation Group. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later. A copy of the Open Publication License is distributed with this manual, the latest version is presently available at http://www.opencontent.org/openpub/.
Please see full copyright text at http://www.php.net/manual/en/copyright.php
Original version of the above documentation is available at http://www.php.net/manual/en/
|
- Please click on Pay per click ppc search engine script
- Please Also click on our Web developers Showcase
|
