php-doc-en/reference/pdo/functions/PDOStatement-rowCount.xml

<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.4 $ -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
  <refentry id="function.PDOStatement-rowCount">
   <refnamediv>
    <refname>PDOStatement::rowCount</refname>
    <refpurpose>
     Returns the number of rows affected by the last SQL statement
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>PDOStatement::rowCount</methodname>
     <void/>
    </methodsynopsis>

     &warn.experimental.func;
    <para>
     <function>PDOStatement::rowCount</function> returns the number of
     rows affected by the last DELETE, INSERT, or UPDATE statement
     executed by the corresponding <literal>PDOStatement</literal> object. 
    </para>
    <para>
     If the last SQL statement executed by the associated 
     <literal>PDOStatement</literal> was a SELECT statement, some databases
     may return the number of rows returned by that statement. However, this
     behaviour is not guaranteed for all databases and should not be relied
     on for portable applications.
    </para>
    <example><title>Return the number of deleted rows</title>
     <programlisting role="php">
<![CDATA[
<?php
/* Delete all rows from the FRUIT table */
$del = $dbh->prepare('DELETE FROM fruit');
$del->execute();

/* Return number of rows that were deleted */
print("Return number of rows that were deleted:\n");
$count = $del->rowCount();
print("Deleted $count rows.\n");
?>
]]>
     </programlisting>
    </example>
   </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:"../../../../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
-->