<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.ibm-db2.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.db2-num-rows.php',
    1 => 'db2_num_rows',
    2 => 'Devuelve el n&uacute;mero de filas afectadas por una consulta SQL',
  ),
  'up' => 
  array (
    0 => 'ref.ibm-db2.php',
    1 => 'Funciones de IBM DB2',
  ),
  'prev' => 
  array (
    0 => 'function.db2-num-fields.php',
    1 => 'db2_num_fields',
  ),
  'next' => 
  array (
    0 => 'function.db2-pclose.php',
    1 => 'db2_pclose',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/ibm_db2/functions/db2-num-rows.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.db2-num-rows" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">db2_num_rows</h1>
  <p class="verinfo">(PECL ibm_db2 &gt;= 1.0.0)</p><p class="refpurpose"><span class="refname">db2_num_rows</span> &mdash; <span class="dc-title">
   Devuelve el número de filas afectadas por una consulta SQL
  </span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.db2-num-rows-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>db2_num_rows</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$stmt</code></span>): <span class="type"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>


  <p class="simpara">
   Devuelve el número de filas eliminadas, añadidas o actualizadas por una
   consulta SQL.
  </p>
  <p class="simpara">
   Para determinar el número de filas que devolverá una consulta SELECT,
   utilice la consulta SELECT COUNT(*) con los mismos atributos cuando se
   haya ejecutado la consulta SELECT y la recuperación de los valores.
  </p>
  <p class="simpara">
   Si la lógica de la aplicación verifica el número de filas devueltas por
   una consulta SELECT y salta si el número de filas es 0,
   modifique la aplicación para intentar devolver la primera fila con
   <span class="function"><a href="function.db2-fetch-assoc.php" class="function">db2_fetch_assoc()</a></span>, <span class="function"><a href="function.db2-fetch-both.php" class="function">db2_fetch_both()</a></span>,
   <span class="function"><a href="function.db2-fetch-array.php" class="function">db2_fetch_array()</a></span> o <span class="function"><a href="function.db2-fetch-row.php" class="function">db2_fetch_row()</a></span>,
   y salte si la función devuelve <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
  </p>

  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <span class="simpara">
    Si se envía una consulta SELECT con un cursor flotante,
    <span class="function"><strong>db2_num_rows()</strong></span> devolverá el número de filas devueltas
    por la consulta SELECT. Sin embargo, el tiempo de sistema asociado con los
    cursores flotantes degrada considerablemente el rendimiento de la
    aplicación, por lo que si esta es la única razón para utilizar cursores
    flotantes, se deberían utilizar cursores de avance solo y además llamar a
    SELECT COUNT(*) o confiar en los valores de retorno de las funciones de
    tipo <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> para obtener la misma funcionalidad con un
    rendimiento mucho mejor.
   </span>
  </p></blockquote>

 </div>

 <div class="refsect1 parameters" id="refsect1-function.db2-num-rows-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">stmt</code></dt>
    <dd>
     <span class="simpara">
      Un recurso <code class="literal">stmt</code> válido que contiene el conjunto de
      resultados.
     </span>
    </dd>
   
  </dl>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.db2-num-rows-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Devuelve el número de filas afectadas por la última consulta SQL enviada
   por una función que ejecuta consultas SQL,  o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error
  </p>
 </div>


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