Forum und email

sesam_fetch_result

(No version information available, might be only in CVS)

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

Description

mixed sesam_fetch_result ( string $result_id [, int $max_rows ] )

Récupère un résultat, optionnellement limité à max_rows lignes.

Liste de paramètres

result_id

Un identifiant de résultat valide, retourné par la fonction sesam_query().

max_rows

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.

Valeurs de retour

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.

Résultat de sesam_fetch_result()
Elément du tableau Contenu
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.