<META HREF="function.sesam-fetch-row.html"><META

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 Noteaz 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 ligne dans le résultat (entre zéro et `max_rows`)
bool $arr["truncated"]	`TRUE` si le nombre de ligne était d'au moins `max_rows`, `FALSE` sinon. Notez que même si cette valeur est à `TRUE`, le prochain appel à sesam_fetch_result() peut 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 une exemple complet avec sesam_fetch_result().