Author: timbo Date: Mon Jan 2 05:16:04 2012 New Revision: 15056 Modified: dbi/trunk/Changes dbi/trunk/DBI.pm
Log: Clarified docs for fetchall_arrayref called on an inactive handle Modified: dbi/trunk/Changes ============================================================================== --- dbi/trunk/Changes (original) +++ dbi/trunk/Changes Mon Jan 2 05:16:04 2012 @@ -21,6 +21,7 @@ Added CON, ENC and DBD trace flags and extended 09trace.t (Martin J. Evans) Added TXN trace flags and applied CON and TXN to relevant methods (Tim Bunce) Added some more fetchall_arrayref(..., $maxrows) tests (Tim Bunce) + Clarified docs for fetchall_arrayref called on an inactive handle. Reserved spatialite_ as a driver prefix for DBD::Spatialite Reserved mo_ as a driver prefix for DBD::MO Updated link to the SQL Reunion 95 docs, RT69577 (Ash Daminato) Modified: dbi/trunk/DBI.pm ============================================================================== --- dbi/trunk/DBI.pm (original) +++ dbi/trunk/DBI.pm Mon Jan 2 05:16:04 2012 @@ -6379,7 +6379,9 @@ returned from a prepared and executed statement handle. It returns a reference to an array that contains one reference per row. -If there are no rows to return, C<fetchall_arrayref> returns a reference +If called on an I<inactive> statement handle, C<fetchall_arrayref> returns undef. + +If there are no rows left to return from an I<active> statement handle, C<fetchall_arrayref> returns a reference to an empty array. If an error occurs, C<fetchall_arrayref> returns the data fetched thus far, which may be none. You should check C<$sth-E<gt>err> afterwards (or use the C<RaiseError> attribute) to discover if the data is
