odbc-execute.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6fadea3dfa2365f52bcb4146e955e4a4baa5ab82 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.odbc-execute" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>odbc_execute</refname>
  <refpurpose>Ejecutar una declaración preparada</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>odbc_execute</methodname>
   <methodparam><type>resource</type><parameter>result_id</parameter></methodparam>
   <methodparam choice="opt"><type>array</type><parameter>parameters_array</parameter></methodparam>
  </methodsynopsis>
  <para>
   Ejecuta una declaración preparado con <function>odbc_prepare</function>.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>result_id</parameter></term>
     <listitem>
      <para>
       El <type>resource</type> de identificación de resultado, desde <function>odbc_prepare</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>parameters_array</parameter></term>
     <listitem>
      <para>
       Los parámetros en <parameter>parameter_array</parameter> serán
       sustituidoss por parámetros de sustitución en la declaración preparada en orden.
       Los elementos de este array serán convertidos a cadenas al llamar a esta
       función.
      </para>
      <para>
       Cualquier parámetro de <parameter>parameter_array</parameter> que
       comience y finalice con comillas simples se tomará como el nombre de un
       archivo para leer y enviar al servor de la base de datos como la información para el
       parámetro de sustitución apropiado.
      </para>
      <simpara>
       Si desea almacenar una cadena que comienza y finaliza con
       comillas simples, debe añadir un espacio u otro carácter distinto de las comillas simples
       al inicio o final del parámetro, lo que prevendrá al
       parámetro de ser tomado como un nombre de archivo. Si esto no es una opción,
       entonces debe usar otro mecanismo para almacenar la cadena, tal como
       ejecutar la consulta directamente con <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>Ejemplo de <function>odbc_execute</function> y <function>odbc_prepare</function></title>
    <para>
     En el código siguiente, <varname>$éxito</varname> solamente será
     &true; si los tres parámetros de myproc son parámetros IN:
    </para>
    <programlisting role="php">
<![CDATA[
<?php
$a = 1;
$b = 2;
$c = 3;
$declaración    = odbc_prepare($conexión, 'CALL myproc(?,?,?)');
$éxito = odbc_execute($declaración, array($a, $b, $c));
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   Si se necesita llamar a procedimientos almacendos usando parámetros INOUT o OUT,
   una solución recomendada es usar una extensión nativa para la base de datos
   (por ejemplo, <link linkend="ref.oci8">oci8</link> para 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
-->