Manuel PHP
Précédent |  | Suivant

# sesam_query

(PHP 3 CVS only)

sesam_query -- Exécute une requête SESAM

## Description

string sesam_query ( string query [, bool scrollable] )

sesam_query() retourne un identifiant de résultat SESAM en cas de succès, ou `FALSE` en cas d'erreur.

L'identifiant de résultat est utilisé par d'autres fonctions SESAM pour lire les valeurs.

sesam_query() envoie une requête à la base active. Elle peut exécuter aussi bien une requête immédiate (DELETE, UPDATE ou INSERT), ou une requête de selection. Si une requête immédiate est exécutée, aucun curseur n'est alloué, et il ne sera pas possible d'utiliser les fonctions sesam_fetch_row() ou sesam_fetch_result(). Pour les requêtes de selection, un descripteur de résultat et un curseur (scrollable ou séquentiel, suivant le paramètre optionnel scrollable passé) sera alloué. Si scrollable est omis, le curseur sera séquentiel.

Lorsque vous utilisez les curseurs à défilement, le curseur peut être positionné librement dans le résultat. Pour chaque requête à défilement, il existe des valeurs globales de types de défilement (initialisée à :SESAM_SEEK_NEXT) et la position peut être fixée une seule fois par sesam_seek_row() ou bien à chaque appel, avec la fonction sesam_fetch_row().

Pour les requêtes immédiates, le nombre de lignes affectées est sauvé, et est accessible par la fonction sesam_affected_rows().

Exemple 1. Liste toutes les lignes de table "phone" sous forme de table HTML

`<?php
if (!sesam_connect("phonedb", "demo", "toto")) {
die("cannot connect");
}
$result = sesam_query("select * from phone");
if (!$result) {
$err = sesam_diagnostic();
die ($err["errmsg"]);
}
echo "<table border=\"1\">\n";
// Ajoute l'en-tête de titre comme nom de colonne
if ($cols = sesam_field_array($result)) {
echo "<tr><th colspan=\"".$cols["count"]."\">Résultat:</th></tr>\n";
echo "<tr>\n";
for ($col = 0; $col < $cols["count"]; ++$col) {
$colattr = $cols[$col];
/* étend les en-têtes de la table au-dessus des champs multiples */
if ($colattr["count"] > 1) {
echo "<th colspan=\"".$colattr["count"]."\">".$colattr["name"].
"(1..".$colattr["count"].")</th>\n";
$col += $colattr["count"] - 1;
} else {
echo "<th>" . $colattr["name"] . "</th>\n";
}
}
echo "</tr>\n";
}
do {
// Lit les résultats par bloc de 100
$ok = sesam_fetch_result($result,100);
for ($row=0; $row < $ok["rows"]; ++$row) {
echo "<tr>\n";
for ($col = 0; $col < $ok["cols"]; ++$col) {
if (isset($ok[$col][$row])) {
echo "<td>" . $ok[$col][$row] . "</td>\n";
} else {
echo "<td>-empty-</td>\n";
}
}
echo "</tr>\n";
}
} while ($ok["truncated"]); // tant qu'il a y encore des données
echo "</table>\n";
// libère les ressources
sesam_free_result($result);
?>`

Voir aussi : sesam_fetch_row() et sesam_fetch_result().

Précédent | Sommaire | Suivant
sesam_num_fields | Niveau supérieur | sesam_rollback