Manuel PHP
PrécédentSuivant

PDOStatement::fetchSingle

(no version information, might be only in CVS)

PDOStatement::fetchSingle --  Retourne la première colonne de la ligne suivante dans un jeu de résultats

Description

string PDOStatement::fetchSingle ( void )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Valeurs de retour

PDOStatement::fetchSingle() retourne la première colonne de la ligne suivante dans un jeu de résultat sous la forme d'une chaîne de caractères.

Avertissement

Il n'est pas possible de récupérer la seconde colonne ou une sous-séquence de colonnes depuis un ligne si vous utilisez cette méthode 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();

/* Retourne la première colonne de la ligne suivante */
print("Retourne la première colonne de la ligne suivante :\n");
$result = $sth->fetchSingle();
print("$result\n");

$result = $sth->fetchSingle();
print("$result\n");
?>

L'exemple ci-dessus va afficher :

Retourne la première colonne de la ligne suivante :
lemon
orange

Voir aussi

PDO::query()
PDOStatement::fetch()
PDOStatement::fetchAll()
PDOStatement::prepare()
PDOStatement::setFetchMode()

PrécédentSommaireSuivant
PDOStatement::fetchAllNiveau supérieurPDOStatement::getAttribute