Description
mixed
sesam_fetch_result ( string result_id [, int max_rows] )
sesam_fetch_result() retourne un tableau avec
les lignes du résultat identifié par result_id,
éventuellement limité Ã un maximum de max_rows
Notez que les lignes et les colonnes sont indexées à partir de 0.
Tableau 1.
Résultat de sesam_fetch_result()
| Elément du tableau | Contents |
|---|
| int $arr["count"] |
Nombre de colonnes dans le résultat (ou zéro si c'était
une requête immédiate).
|
| int $arr["rows"] |
Nombre de lignes dans le résultat (entre zéro
et max_rows)
|
| bool $arr["truncated"] |
TRUE si le nombre de lignes était d'au moins
max_rows, FALSE sinon. Notez que
même si cette valeur est à TRUE, le prochain appel Ã
sesam_fetch_result() peut ne retourner
aucune ligne parce qu'il n'y a plus d'entrées.
|
| mixed $arr[col][row] |
les valeurs du résultat à la ligne row et
colonne col. Le résultat est un tableau
multidimensionnel. row va de 0 Ã
$arr["rows"]-1, et col
de 0 Ã $arr["count"]-1). Les champs peuvent être
vides : vous devez vérifier leur existence avec la fonction
isset(). Le type retourné dépend du type
SQL déclaré pour cette colonne (voir
Introduction SESAM pour
connaître les conversions utilisées). Les champs multiples
SESAM sont traités comme des séquences de colonnes.
|
Notez que la quantité de mémoire utilisée par des requêtes peut
se révéler gigantesque. Utilisez alors
max_rows
pour limiter le nombre maximum de lignes retournées, Ã moins que
vous ne soyez absolument sûr que votre résultat ne consommera
pas toute la mémoire disponible.
Voir aussi
sesam_fetch_row() et
sesam_field_array() pour vérifier les
champs multiples.
Voyez
sesam_query() pour un
exemple complet avec sesam_fetch_result().
