db2_fetch_row

(PECL ibm_db2 >= 1.0.0)

db2_fetch_row 将结果集指针设置为下一行或请求的行

描述

db2_fetch_row(resource $stmt, int $row_number = -1): bool

使用 db2_fetch_row() 遍历结果集,或者如果您请求了可滚动游标,则将指针指向结果集中的特定行。

要从结果集中检索各个字段,请调用 db2_result() 函数。

大多数应用程序将调用 db2_fetch_assoc()db2_fetch_both()db2_fetch_array() 来推进结果集指针并返回完整行作为数组,而不是调用 db2_fetch_row()db2_result()

参数

stmt

有效的 stmt 资源。

row_number

对于可滚动游标,您可以请求结果集中的特定行号。行编号从 1 开始。

返回值

如果结果集中存在请求的行,则返回 true。如果结果集中不存在请求的行,则返回 false

示例

示例 #1 遍历结果集

以下示例演示如何使用 db2_fetch_row() 遍历结果集,并使用 db2_result() 从结果集中检索列。

<?php
$sql
= 'SELECT name, breed FROM animals WHERE weight < ?';
$stmt = db2_prepare($conn, $sql);
db2_execute($stmt, array(10));
while (
db2_fetch_row($stmt)) {
$name = db2_result($stmt, 0);
$breed = db2_result($stmt, 1);
print
"$name $breed";
}
?>

上面的示例将输出

cat Pook
gold fish Bubbles
budgerigar Gizmo
goat Rickety Ride

示例 #2 i5/OS 推荐的 db2_fetch_row/db2_result 替代方案

在 i5/OS 上,建议您使用 db2_fetch_both()db2_fetch_array()db2_fetch_object() 而不是 db2_fetch_row()/db2_result()。通常,db2_fetch_row()/db2_result() 在各种列类型的 EBCIDICASCII 转换中存在更多问题,包括 DBCS 应用程序中可能的截断。您可能还会发现 db2_fetch_both()db2_fetch_array()db2_fetch_object() 的性能优于 db2_fetch_row()/db2_result()

<?php
$conn
= db2_connect("","","");
$sql = 'SELECT SPECIFIC_SCHEMA, SPECIFIC_NAME, ROUTINE_SCHEMA, ROUTINE_NAME, ROUTINE_TYPE, ROUTINE_CREATED, ROUTINE_BODY, IN_PARMS, OUT_PARMS, INOUT_PARMS, PARAMETER_STYLE, EXTERNAL_NAME, EXTERNAL_LANGUAGE FROM QSYS2.SYSROUTINES FETCH FIRST 2 ROWS ONLY';
$stmt = db2_exec($conn, $sql, array('cursor' => DB2_SCROLLABLE));
while (
$row = db2_fetch_both($stmt)){
echo
"<br>db2_fetch_both {$row['SPECIFIC_NAME']} {$row['ROUTINE_CREATED']} {$row[5]}";
}
$stmt = db2_exec($conn, $sql, array('cursor' => DB2_SCROLLABLE));
while (
$row = db2_fetch_array($stmt)){
echo
"<br>db2_fetch_array {$row[1]} {$row[5]}";
}
$stmt = db2_exec($conn, $sql, array('cursor' => DB2_SCROLLABLE));
while (
$row = db2_fetch_object($stmt)){
echo
"<br>db2_fetch_object {$row->SPECIFIC_NAME} {$row->ROUTINE_CREATED}";
}
db2_close($conn);
?>

上面的示例将输出

db2_fetch_both MATCH_ANIMAL 2006-08-25-17.10.23.775000 2006-08-25-17.10.23.775000
db2_fetch_both MULTIRESULTS 2006-10-17-10.11.05.308000 2006-10-17-10.11.05.308000
db2_fetch_array MATCH_ANIMAL 2006-08-25-17.10.23.775000
db2_fetch_array MULTIRESULTS 2006-10-17-10.11.05.308000
db2_fetch_object MATCH_ANIMAL 2006-08-25-17.10.23.775000
db2_fetch_object MULTIRESULTS 2006-10-17-10.11.05.308000

参见

添加笔记

用户贡献笔记 2 笔记

krisdover at hotmail dot com
17 年前
如果指定了第二个参数(行号),您的连接需要将 CURSOR 选项设置为 DB2_SCROLLABLE。否则,所有对该函数的调用都将失败。在 ibm_db2 扩展模块内部,db2cli api 函数 SQLFetchScroll() 生成了错误“CLI0145E Fetch type out of range”,因为它需要一个可滚动的结果集才能工作,而不是默认的仅向前结果集。

希望这能为其他人节省我在 db2cli 跟踪中找到此问题所花费的时间。

此致,
Kris Dover
andrey at php dot net
18 年前
如果第二个参数为 0 或 NULL(最终评估为 0),则内部指针将向前移动。< 0 值将返回警告。
To Top