PDOStatement::fetchColumn

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

PDOStatement::fetchColumn — Retourne une colonne depuis la ligne suivante d'un jeu de résultats

Description

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

Retourne une colonne depuis la ligne suivante d'un jeu de résultats ou FALSE s'il n'y a plus de ligne.

Note:
PDOStatement::fetchColumn() ne doit pas être utilisé pour récupérer des colonnes contenant des booléens, car il n'est pas possible de distinguer une valeur FALSE d'un retour avec aucune ligne à récupérer. Utilisez PDOStatement::fetch() à la place.

Liste de paramètres

column_number: Numéro de la colonne que vous voulez récupérer depuis la ligne (commençant à 0). Si aucune valeur n'est fournie, PDOStatement::fetchColumn() récupérera la première colonne.

Valeurs de retour

PDOStatement::fetchColumn() retourne une colonne depuis la ligne suivante d'un jeu de résultats ou FALSE s'il n'y a plus de lignes.

Avertissement

Il n'y a pas de solution pour retourner une autre colonne depuis la même ligne si vous utilisez la fonction PDOStatement::fetchColumn() pour récupérer les données.

Exemples

Exemple #1 Retourne la première colonne de la ligne suivante


<?php
$sth = $dbh->prepare("SELECT nom, couleur FROM fruit");
$sth->execute();

/* Récupère la première colonne depuis la première ligne d'un jeu de résultats */
print("Récupère la première colonne depuis la première ligne d'un jeu de résultats :\n");
$result = $sth->fetchColumn();
print("nom=$result\n");

print("Récupère la deuxième colonne depuis la seconde ligne d'un jeu de résultats :\n");
$result = $sth->fetchColumn(1);
print("couleur=$result\n");
?>

L'exemple ci-dessus va afficher :

Récupère la première colonne depuis la première ligne d'un jeu de résultats :
nom=lemon
Récupère la deuxième colonne depuis la seconde ligne d'un jeu de résultats :
couleur=orange

Voir aussi

PDO::query() - Exécute une requête SQL, retourne un jeu de résultats en tant qu'objet PDOStatement
PDOStatement::fetch() - Récupère la ligne suivante d'un jeu de résultats PDO
PDOStatement::fetchAll() - Retourne un tableau contenant toutes les lignes du jeu d'enregistrements
PDO::prepare() - Prépare une requête à l'exécution et retourne un objet
PDOStatement::setFetchMode() - Définit le mode de récupération par défaut pour cette requête

Rechercher une fonction PHP

Version en cache

31/12/2024 20:42:55 Cette version de la page est en cache (à la date du 31/12/2024 20:42:55) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-pdostatement.fetchcolumn.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut