sesam_fetch

Manuel PHP
Précédent		Suivant

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

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