PHP 8.5.0 Alpha 1 available for testing

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 resultado del ejemplo sería:

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top