Author: mjevans Date: Tue Sep 19 12:14:31 2006 New Revision: 7848 Modified: dbi/trunk/DBI.pm
Log: Clarify what execute_array and execute_for_fetch returns in list context for rows affected if the driver cannot determine the rows affected Modified: dbi/trunk/DBI.pm ============================================================================== --- dbi/trunk/DBI.pm (original) +++ dbi/trunk/DBI.pm Tue Sep 19 12:14:31 2006 @@ -5557,7 +5557,8 @@ When called in list context the execute_array() method returns two scalars; $tuples is the same as calling execute_array() in scalar context and $rows is -the sum of the number of rows affected for each tuple, if available. +the sum of the number of rows affected for each tuple, if available or +-1 if the driver cannot determine this. If you are doing an update operation the returned rows affected may not be what you expect if, for instance, one or more of the tuples affected the same row multiple times. Some drivers may not yet support list context, in which case @@ -5698,7 +5699,8 @@ When called in list context execute_for_fetch() returns two scalars; $tuples is the same as calling execute_for_fetch() in scalar context and $rows is -the sum of the number of rows affected for each tuple, if available. +the sum of the number of rows affected for each tuple, if available or -1 +if the driver cannot determine this. If you are doing an update operation the returned rows affected may not be what you expect if, for instance, one or more of the tuples affected the same row multiple times. Some drivers may not yet support list context, in which case
