Manuel PHP
Précédent |  | Suivant

# 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édent | Sommaire | Suivant
PDOStatement::fetchAll | Niveau supérieur | PDOStatement::getAttribute