db2-num-rows.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: tardeenfamenor Status: ready -->
<!-- Reviewed: no -->

<!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. -->
<refentry xml:id="function.db2-num-rows" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>db2_num_rows</refname>
  <refpurpose>
   Devolver el número de filas afectadas por una sentencia SQL
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>db2_num_rows</methodname>
   <methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
  </methodsynopsis>


  <para>
   Devuelve el número de filas eliminadas, insertadas o actualizadas por una sentencia SQL.
  </para>
  <para>
   Para determinar el número de filas que serán devueltas por una sentencia SELECT 
   se puede utilizar una consulta de tipo SELECT COUNT(*) con los mismos predicados que la 
   consulta original.
  </para>
  <para>
   Si la aplicación revisa el número de filas devueltas por una sentencia SELECT 
   comparando si el número de filas es cero, es mejor considerar modificar la aplicación 
   intentando extraer la primer fila con <function>db2_fetch_assoc</function>, 
   <function>db2_fetch_both</function>, <function>db2_fetch_array</function>, 
   o <function>db2_fetch_row</function> 
   y comparar si la función devuelve &false;.
  </para>

  <note>
   <para>
    Si se utiliza una sentencia SELECT con un cursor de recorrido,
    <function>db2_num_rows</function> devuelve el número de filas devueltas por 
    la sentencia SELECT. Sin embargo, lo anterior requiere significativamente de 
    mayores recursos para la aplicación, por lo tanto, si ésta es la única 
    razón por la que se utilizan cursores de recorrido en la aplicación,
    es mejor utilizar cursores de no-recorrido así como una consulta SELECT COUNT(*) o
    utilizar el valor <type>boolean</type> devuelto por las funciones de extracción 
    con el objetivo de lograr una mayor optimización.
   </para>
  </note>

 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>stmt</parameter></term>
     <listitem>
      <para>
       Un recurso <literal>stmt</literal> válido que contenga el resultado.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve el número de filas afectadas por la última sentencia SQL asociada con el 
   recurso indicado.
  </para>
 </refsect1>

 <!-- Use when examples exist
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>A <function>db2_num_rows</function> example</title>
    <para>
     Any text that describes the purpose of the example, or
     what goes on in the example should go here (inside the
     <example> tag, not out
    </para>
    <programlisting role="php">
<![CDATA[
<?php
if ($anexample === true) {
    echo 'Use the PEAR Coding Standards';
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Use the PEAR Coding Standards
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 -->


 <!-- Use when adding See Also links
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function></function></member>
    <member>Or <link linkend="somethingelse">something else</link></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
-->