db2_fetch_both

(PECL ibm_db2 >= 1.0.0)

db2_fetch_both — Devolver un arreglo, indexado por el nombre y por la posición de la columna, representando una fila de un bloque de resultados

Descripción

db2_fetch_both(resource $stmt, int $row_number = -1): array

Devuelve un arreglo, indexado por el nombre y por la posición de la columna, representando una fila de un bloque de resultados. Hay que considerar que la fila devuelta por db2_fetch_both() requiere más memoria que las filas devueltas por db2_fetch_assoc() o db2_fetch_array(), ya que estas últimas sólo devuelven un índice.

Parámetros

stmt: Un recurso stmt válido que contenga los resultados.
row_number: Solicita una fila específica, indexada a partir de uno, del bloque de resultados. Este parámetro provoca una advertencia de PHP si el resultado utiliza cursor de no-recorrido (sólo hacia adelante).

Valores devueltos

Devuelve un arreglo asociativo con las columnas indexadas por el nombre y también por el número de columna (indexada a partir de cero). El arreglo representa la siguiente fila o la fila específica solicitada del bloque de resultados. Devuelve false si no hay más filas en los resultados o si la fila solicitada por row_number no existe entre los resultados.

Ejemplos

Ejemplo #1 Iterando a través de un cursor de no-recorrido (sólo hacia adelante)

Si se llama a db2_fetch_both() sin especificar un número de fila, automáticamente extrae la siguiente fila del bloque de resultados. El siguiente ejemplo accesa a las columnas del arreglo devuelto utilizando tanto los nombres de la columnas como sus posiciones en el índice.

<?php

$sql = "SELECT id, name, breed, weight FROM animals ORDER BY breed";
$stmt = db2_prepare($conn, $sql);
$result = db2_execute($stmt);

while ($row = db2_fetch_both($stmt)) {
    printf ("%-5d %-16s %-32s %10s\n", 
        $row['ID'], $row[0], $row['BREED'], $row[3]);
}
?>

El resultado del ejemplo sería:

0     Pook             cat                                    3.20
5     Rickety Ride     goat                                   9.70
2     Smarty           horse                                350.00

Ejemplo #2 Extrayendo filas específicas con db2_fetch_both() a partir de un cursor de recorrido

Si el bloque de resultados utiliza un cursor de recorrido, se puede llamar a db2_fetch_both() con un número específico de fila. El siguiente ejemplo extrae cada fila del bloque de resultados, comenzando por la segunda fila.

<?php

$sql = "SELECT id, name, breed, weight FROM animals ORDER BY breed";
$result = db2_exec($stmt, $sql, array('cursor' => DB2_SCROLLABLE));

$i=2;
while ($row = db2_fetch_both($result, $i)) {
    printf ("%-5d %-16s %-32s %10s\n", 
        $row[0], $row['NAME'], $row[2], $row['WEIGHT']);
    $i = $i + 2;
}
?>

El resultado del ejemplo sería:

0     Pook             cat                                    3.20
5     Rickety Ride     goat                                   9.70
2     Smarty           horse                                350.00

Ver también

db2_fetch_array() - Devolver un arreglo, indexado por la posición de las columnas, que represanta una fila de un bloque de resultados
db2_fetch_assoc() - Devolver un arreglo, indexado por el nombre de las columnas, representando una fila del bloque de resultados
db2_fetch_object() - Devolver un objeto con atributos que representan a las columnas de una fila extraida
db2_fetch_row() - Establecer el apuntador de los resultados hacia la siguiente fila o a la fila solicitada
db2_result() - Devolver una columna específica del resultado

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

eacosta at openware dot biz ¶

16 years ago

Hello,

Some weeks ago I faced difficulties with walk a big number of 
records from a result set.

I was using the function db2_fetch_both in a method of a database adapter
class to retrieve just one record at a time. The total number of records
were: 5647 and when I reach record number 1600 the function crashed
generating the below message in "Actual result" field.

I am copying table's description next:

TMP_TABLE
-----------------------------------------------------------------
| ID        | TYPE        | SIZE        | NULL        |
-----------------------------------------------------------------
| ID        | INTEGER    | 4        | NO        |
| SERVICE    | VARCHAR    | 30        | NO        |
| ID_v        | VARCHAR    | 30        | NO        |
| INFORMATION    | CLOB        | 65536        | YES        |
| EXP_LEVEL    | INTEGER    | 4        | NO        |
| IP4B        | BIGINT    | 8        | NO        |
| MODIFIED    | INTEGER    | 4        | YES        |
| DETAIL    | VARCHAR    | 200        | YES        |
| FALSPOS    | INTEGER    | 4        | YES        |
-----------------------------------------------------------------

When it crashed I received this message from db2_fetch_both

db2_fetch_array() [function.db2-fetch-array]: Fetch Failure

After reported this message to IBM OpenDev I was helped by a OpenDev IBMer who noticed me 
that it wasn't a ibm_db2 module problem, in fact it was a database configuration 
issue. The OpenDev IBMer looked into my DB2 Client CLI TRACE files and found out what was happen.
So I had to modify APP_CTL_HEAP_SZ and everything seems to works fine now.

-- 
Esteban Acosta Villafañe
Area I+D
http://www.openware.biz/opendev
Linkein Profile: http://www.linkedin.com/in/estebanav

＋add a note