sesam_execimm

(PHP 3 CVS only)

sesam_execimm -- Exécute immédiatement une requête SQL

Description

string sesam_execimm ( string query)

sesam_execimm() retourne un identifiant de résultat SESAM en cas de succès, et FALSE sinon.

sesam_execimm() exécute immédiatement la requête query (i.e., une requête de type UPDATE, INSERT ou DELETE qui ne retourne aucun résultat, et n'a aucune variables d'entrées ou de sorties). Les requêtes de types "SELECT" ne peuvent pas être utilisées avec la fonction sesam_execimm(). sesam_execimm() modifie la valeur affected_rows, pour lecture ultérieure avec sesam_affected_rows().

Notez que sesam_query() peut gérer les requêtes immédiates et les requêtes de selection. Utilisez sesam_execimm() uniquement si vous connaissez le type de requête auparavant. Une tentative de requête de selection avec sesam_execimm() retournera $err["sqlstate"] == "42SBW".

L'identifiant de résultat retourné ne peut pas être utilisé pour lire quoi que ce soit, mais il peut être passé à sesam_affected_rows(); il n'est retourné que pour symétrie avec la fonction sesam_query().

Exemple 1. Exemple avec sesam_execimm()

<?php
$stmt
= "INSERT INTO matable VALUES('un', 'deux')";
$result = sesam_execimm ($stmt);
$err = sesam_diagnostic();
print(
"sqlstate = ".$err["sqlstate"]."\n".
      
"Nombre de lignes affect&eacute;es = ".$err["rowcount"]." == ".
      
sesam_affected_rows($result)."\n");
?>

Voir aussi sesam_query() et sesam_affected_rows().