Manuel PHP
Précédent |  | Suivant

# sesam_fetch_result

(PHP 3 CVS only)

sesam_fetch_result -- Retourne tout ou partie d'un résultat SESAM

## 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().

Précédent | Sommaire | Suivant
sesam_fetch_array | Niveau supérieur | sesam_fetch_row