ifx_fetch_row

(PHP 3>= 3.0.3, PHP 4 , PHP 5)

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. Chaque résultat est stocké dans un tableau associatif, dont l'index numérique commence à 0 et ayant comme clé, le nom du champ.

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ésultat. (%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);
?>