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