Files
doc-fr/reference/uodbc/functions/odbc-execute.xml
2021-09-24 04:13:47 +01:00

135 lines
3.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6fadea3dfa2365f52bcb4146e955e4a4baa5ab82 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.odbc-execute" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>odbc_execute</refname>
<refpurpose>Exécute une requête SQL préparée</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>odbc_execute</methodname>
<methodparam><type>resource</type><parameter>statement</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>params</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
Exécute une requête SQL préparée par <function>odbc_prepare</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>statement</parameter></term>
<listitem>
<para>
L'identifiant de résultat, depuis la fonction <function>odbc_prepare</function>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>params</parameter></term>
<listitem>
<para>
Les valeurs du paramètre <parameter>params</parameter> seront
substituées dans les variables de requêtes de la requête préparée.
Les éléments de ce tableau seront convertis en chaînes de caractères en
appelant cette fonction.
</para>
<para>
Tout paramètre de <parameter>params</parameter> qui
commence et termine par des guillemets simples sera considéré
comme un nom de fichier à lire et envoyé à la base de données,
avec la variable de requête appropriée.
</para>
<simpara>
Si vous voulez stocker une chaîne de caractères qui commence et se finit
réellement par des guillemets, vous devez ajouter un espace au début
ou à la fin de la chaîne, pour éviter que ce paramètre soit confondu avec
un nom de fichier. Si ce n'est pas possible dans le cadre de votre application,
vous devrez passer par la fonction <function>odbc_exec</function>.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>
Exemple avec <function>odbc_execute</function> et
<function>odbc_prepare</function>
</title>
<para>
Dans le script suivant, <varname>$success</varname> ne sera
possible que si les trois paramètres de <literal>maproc</literal>
sont des paramètres de type IN :
</para>
<programlisting role="php">
<![CDATA[
<?php
$a = 1;
$b = 2;
$c = 3;
$stmt = odbc_prepare($conn, 'CALL maproc(?,?,?)');
$success = odbc_execute($stmt, array($a, $b, $c));
?>
]]>
</programlisting>
</example>
</para>
<para>
Si vous devez appeler une procédure stockée en utilisant des paramètres
INOUT ou OUT, la solution est d'utiliser une extension native de votre
base de données
(par exemple pour <link linkend="ref.oci8">oci8</link> pour Oracle).
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>odbc_prepare</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->