db2_fetch_object

(PECL ibm_db2 >= 1.0.0)

db2_fetch_object — Devuelve un objeto con las propiedades que representan columnas en la fila extraída

Descripción

db2_fetch_object(resource $stmt, int $row_number = -1): stdClass|false

Devuelve un objeto en el que cada propiedad representa una columna devuelta en la fila extraída del conjunto de resultados.

Parámetros

stmt: Un recurso stmt válido que contiene el conjunto de resultados.
row_number: Solicita una fila específica comenzando en el índice 1 del conjunto de resultados. Si se pasa este argumento, se generará una advertencia de PHP si el resultado utiliza un cursor de desplazamiento solo.

Valores devueltos

Devuelve un objeto que representa una sola fila en el conjunto de resultados. Las propiedades del objeto corresponden al nombre de las columnas en el conjunto de resultados.

Los servidores IBM DB2, Cloudscape y Apache Derby normalmente rellenan los nombres de las columnas con mayúsculas, por lo tanto, las propiedades del objeto reflejarán este caso.

Si su consulta SELECT llama a una función escalar para modificar el valor de una columna, los servidores de base de datos devuelven el número de columna como nombre de columna en el conjunto de resultados. Si se prefiere una descripción más detallada del nombre de las columnas y las propiedades del objeto, se puede utilizar la cláusula AS para asignar un nombre a la columna en el conjunto de resultados.

Devuelve false si no se ha recuperado ninguna fila.

Ejemplos

Ejemplo #1 Ejemplo con db2_fetch_object()

El ejemplo siguiente envía una consulta SELECT con una función escalar, RTRIM, que elimina los espacios al final de la columna. En lugar de crear un objeto con las propiedades "RACE" y "2", se utiliza la cláusula AS en la consulta SELECT para asignar el nombre "nom" a la columna modificada. El servidor de base de datos rellena el nombre de las columnas con mayúsculas, por lo que el objeto tendrá las propiedades "RACE" y "NOM".

<?php
$conn = db2_connect($database, $user, $password);

$sql = "SELECT race, RTRIM(nom) AS nom
    FROM animaux
    WHERE id = ?";

if ($conn) {
    $stmt = db2_prepare($conn, $sql);
    db2_execute($stmt, array(0));

    while ($pet = db2_fetch_object($stmt)) {
        echo "Viens ici, {$pet->NOM}, mon petit {$pet->RACE} !";
    }
    db2_close($conn);
}
?>

El ejemplo anterior mostrará:

Viens ici, Pook, mon petit chat !

Ver también

db2_fetch_array() - Devuelve un array, indexado por la posición de las columnas, que representa una línea del conjunto de resultados
db2_fetch_assoc() - Devuelve un array, indexado por nombre de columna, que representa una fila del conjunto de resultados
db2_fetch_both() - Devuelve un array, indexado por nombre de columna y posición, que representa una fila del conjunto de resultados
db2_fetch_row() - Modifica el puntero del conjunto de resultados a la siguiente línea o a la línea solicitada
db2_result() - Devuelve un valor de una columna de una fila de un conjunto de resultados