pg_execute
Exécute une requête préparée PostGreSQL
&reftitle.description;
PgSql\Resultfalsepg_execute
PgSql\Connectionconnection
stringstmtname
arrayparams
Envoie une requête pour exécuter une requête préparée avec les
paramètres donnés et attend le résultat.
pg_execute est comme pg_query_params,
mais la commande qui sera exécutée est spécifiée en nommant une requête
préalablement préparée, au lieu de donner une chaîne en tant que requête.
Cette caractéristique permet aux commandes qui seront utilisées à
plusieurs reprises d'être analysées et planifiées qu'une seule fois,
plutôt que d'être exécutées chaque fois. La requête doit avoir été
préalablement préparée dans la session courante.
pg_execute est supportée seulement avec les versions
PostgreSQL 7.4 ou plus récentes; la commande échouera si vous l'utilisez
avec des versions antérieures.
Les paramètres sont identiques à la fonction pg_query_params
à l'exception du nom de la requête préparée qui est donnée à la place de la
requête sous forme de chaîne.
&reftitle.parameters;
connection
&pgsql.parameter.connection-with-unspecified-default;
stmtname
Le nom de la requête préparée à exécuter. Si une chaîne vide est
spécifiée (""), alors la requête qui n'est pas nommée est exécutée. Le
nom doit avoir été précédemment préparé en utilisant
pg_prepare, pg_send_prepare
ou une commande SQL PREPARE.
params
Un tableau de valeurs de paramètres pour substituer les variables $1, $2, etc.
dans la requête préparée originale. Le nombre d'éléments présents dans
le tableau doit concorder avec le nombre de variables à remplacer.
Les éléments sont convertis en chaînes de caractères en appelant cette
fonction.
&reftitle.returnvalues;
Une instance de PgSql\Result en cas de succès, &return.falseforfailure;.
&reftitle.changelog;
&Version;
&Description;
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
Exemple avec pg_execute
]]>
&reftitle.seealso;
pg_prepare
pg_send_prepare
pg_query_params