<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.ibase.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.ibase-execute.php',
    1 => 'ibase_execute',
    2 => 'Ejecuta una consulta iBase preparada',
  ),
  'up' => 
  array (
    0 => 'ref.ibase.php',
    1 => 'Funciones Firebird/InterBase',
  ),
  'prev' => 
  array (
    0 => 'function.ibase-errmsg.php',
    1 => 'ibase_errmsg',
  ),
  'next' => 
  array (
    0 => 'function.ibase-fetch-assoc.php',
    1 => 'ibase_fetch_assoc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/ibase/functions/ibase-execute.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.ibase-execute" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ibase_execute</h1>
  <p class="verinfo">(PHP 5, PHP 7 &lt; 7.4.0)</p><p class="refpurpose"><span class="refname">ibase_execute</span> &mdash; <span class="dc-title">Ejecuta una consulta iBase preparada</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.ibase-execute-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>ibase_execute</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$query</code></span>, <span class="methodparam"><span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span> <code class="parameter">...$values</code></span>): <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span></div>

  <p class="simpara">
   Ejecuta una consulta iBase preparada.
  </p>
  <p class="simpara">
   <span class="function"><strong>ibase_execute()</strong></span> es mucho más eficiente que
   <span class="function"><a href="function.ibase-query.php" class="function">ibase_query()</a></span>, si se realiza la misma consulta varias veces
   cambiando solo algunos argumentos.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.ibase-execute-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">query</code></dt>
    <dd>
     <span class="simpara">
      Una consulta InterBase, preparada con la función
      <span class="function"><a href="function.ibase-prepare.php" class="function">ibase_prepare()</a></span>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">values</code></dt>
    <dd>
     <span class="simpara">
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.ibase-execute-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Si la consulta emite un error, la función devolverá <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>. Si la consulta
   tiene éxito, y hay un conjunto de resultados (que puede estar vacío), la función
   devuelve un identificador de resultados. Si la consulta tiene éxito y no hay
   resultados, la función devuelve <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
  </p>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    <span class="function"><strong>ibase_execute()</strong></span> devuelve el número
    de registros afectados por la consulta (si es mayor que 0).
    Para una consulta que tiene éxito pero que no devuelve ningún registro
    (por ejemplo, un UPDATE en un registro inexistente),
    <span class="function"><strong>ibase_execute()</strong></span> devolverá <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>.
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 examples" id="refsect1-function.ibase-execute-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 Ejemplo con <span class="function"><strong>ibase_execute()</strong></span></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$dbh </span><span style="color: #007700">= </span><span style="color: #0000BB">ibase_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$host</span><span style="color: #007700">, </span><span style="color: #0000BB">$username</span><span style="color: #007700">, </span><span style="color: #0000BB">$password</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$updates </span><span style="color: #007700">= array(<br />    </span><span style="color: #0000BB">1 </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'Eric'</span><span style="color: #007700">,<br />    </span><span style="color: #0000BB">5 </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'Filip'</span><span style="color: #007700">,<br />    </span><span style="color: #0000BB">7 </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'Larry'<br /></span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$query </span><span style="color: #007700">= </span><span style="color: #0000BB">ibase_prepare</span><span style="color: #007700">(</span><span style="color: #0000BB">$dbh</span><span style="color: #007700">, </span><span style="color: #DD0000">"UPDATE FOO SET BAR = ? WHERE BAZ = ?"</span><span style="color: #007700">);<br /><br />foreach (</span><span style="color: #0000BB">$updates </span><span style="color: #007700">as </span><span style="color: #0000BB">$baz </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$bar</span><span style="color: #007700">) {<br />    </span><span style="color: #0000BB">ibase_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$query</span><span style="color: #007700">, </span><span style="color: #0000BB">$bar</span><span style="color: #007700">, </span><span style="color: #0000BB">$baz</span><span style="color: #007700">);<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.ibase-execute-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.ibase-query.php" class="function" rel="rdfs-seeAlso">ibase_query()</a> - Ejecuta una consulta en una base iBase</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>