PDOStatement::fetchColumn

(PHP 5 >= 5.1.0, PHP 7, PECL pdo >= 0.9.0)

PDOStatement::fetchColumn — Devuelve una única columna de la siguiente fila de un conjunto de resultados

Descripción

public mixed PDOStatement::fetchColumn ([ int $column_number = 0 ] )

Devuelve una única columna de la siguiente fila de un conjunto de resultados, o FALSE si no existen más filas.

Nota:
No debería utilizarse PDOStatement::fetchColumn() para recuperar columnas booleanas, ya que es imposible distinguir el valor FALSE de la ausencia de filas a recurperar. Use PDOStatement::fetch() en su lugar.

Parámetros

column_number: El número de índice basado en 0 de la columna que se quiere obtener desde la fila. Si no se proporicona ningún valor, PDOStatement::fetchColumn() obtiene la primera columna.

Valores devueltos

PDOStatement::fetchColumn() devuelve una única columna de la siguiente fila de un conjunto de resultados.

Advertencia

No existe una forma de devolver otra columna de la misma fila si se utiliza PDOStatement::fetchColumn() para recuperar datos.

Ejemplos

Ejemplo #1 Devolver la primera columna de la siguiente fila


<?php
$gsent = $gbd->prepare("SELECT name, colour FROM fruit");
$gsent->execute();

print("Obtener la primera columna de la primera fila del conjunto de resultados:\n");
$resultado = $gsent->fetchColumn();
print("nombre = $resultado\n");

print("Obtener la segunda columna de la segunda fila del conjunto de resultados:\n");
$resultado = $gsent->fetchColumn(1);
print("color = $resultado\n");
?>

El resultado del ejemplo sería:

Obtener la primera columna de la primera fila del conjunto de resultados:
nombre = lemon
Obtener la segunda columna de la segunda fila del conjunto de resultados:
color = red

Ver también

PDO::query() - Ejecuta una sentencia SQL, devolviendo un conjunto de resultados como un objeto PDOStatement
PDOStatement::fetch() - Obtiene la siguiente fila de un conjunto de resultados
PDOStatement::fetchAll() - Devuelve un array que contiene todas las filas del conjunto de resultados
PDO::prepare() - Prepara una sentencia para su ejecución y devuelve un objeto sentencia
PDOStatement::setFetchMode() - Establece el modo de obtención para esta sentencia

add a note

User Contributed Notes 3 notes

down

PhoneixSegovia at GOOGLE_MAIL_SERVER dot com ¶

5 years ago


fetchColumn return boolean false when a row not is found or don't had more rows.

down

seanferd at assmasterdonkeyranch dot com ¶

9 years ago


This is an excellent method for returning a column count. For example:



<?php

$db = new PDO('mysql:host=localhost;dbname=pictures','user','password');

$pics = $db->query('SELECT COUNT(id) FROM pics');

$this->totalpics = $pics->fetchColumn();

$db = null;

?>

In my case $pics->fetchColumn() returns 641 because that is how many pictures I have in my db.

down

-1

gaiusgracchus33 at gmail dot com ¶

1 year ago


It looks like the example may be saying it is fetching the second column from the NEXT row, not the same one that returned 'lemon' for name.   The warning message says you can't return another column from the SAME row after fetchColumn().

add a note