Manuel PHP
Précédent |  | Suivant

# ifx_fetch_row

(PHP 3>= 3.0.3, PHP 4 )

ifx_fetch_row -- Retourne une ligne sous la forme d'un tableau énuméré.

## Description

array ifx_fetch_row ( int result_id [, mixed position])

ifx_fetch_row() retourne un tableau associatif qui contient la ligne retournée, ou `FALSE` s'il ne reste plus de lignes à lire, ou s'il a eu une erreur.

Les colonnes de types BLOB sont retournées sous la forme d'un identifiant à utiliser avec ifx_get_blob() à moins que vous n'ayez utilisé la fonction ifx_textasvarchar() ou ifx_byteasvarchar(), et dans ce cas, les BLOBs seront retournés sous forme de chaîne. ifx_fetch_row() retourne `FALSE` en cas d'erreur.

`result_id` est un identifiant valide de résultat, retourné par ifx_query() ou ifx_prepare() (Requêtes SELECT seulement !).

`position` est un paramètre optionnel, pour une opération de lecture d'informations sur un pointeur de type "scroll": "NEXT", "PREVIOUS", "CURRENT", "FIRST", "LAST" ou encore un nombre. Si vous spécifiez un nombre, la ligne d'index absolu sera retournée. Ce paramètre est optionnel, et ne fonctionne qu'avec les pointeurs de type "scroll".

ifx_fetch_row() retourne une ligne de données d'un résultat associé à l'identifiant de résultat `result_id`. La ligne est retournée sous la forme d'un tableau associatif.

Les appels ultérieurs à ifx_fetch_row() retourneront la ligne suivante, ou `FALSE` s'il n'y a plus de ligne.

Exemple 1. Exemple avec ifx_fetch_row()
    <?php
    $rid = ifx_prepare ("select * from emp where name like " . $name,
                         $connid, IFX_SCROLL);
    if (! $rid) {
    //    ... erreur ...
    }
    $rowcount = ifx_affected_rows($rid);
    if ($rowcount > 1000) {
        printf ("Trop de lignes dans le résultats. (%d)\n<br>", $rowcount);
        die ("Recommencez votre requête. <br>\n");
    }
    if (! ifx_do ($rid)) {
    //   ... erreur ...
    }
    $row = ifx_fetch_row ($rid, "NEXT");
    while (is_array($row)) {
        for(reset($row); $fieldname=key($row); next($row)) {
            $fieldvalue = $row[$fieldname];
            printf ("%s = %s,", $fieldname, $fieldvalue);
        }
        printf("\n<br>");
        $row = ifx_fetch_row ($rid, "NEXT");
    }
    ifx_free_result ($rid);
    ?>

Précédent | Sommaire | Suivant
ifx_errormsg | Niveau supérieur | ifx_fieldproperties