Manuel PHP
Précédent |  | Suivant

# 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);
?>`

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