PDOStatement::fetchColumn

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

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

    Descripción

    publicPDOStatement::fetchColumn(int$column_number = 0): mixed

    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

    To Top