oracular (3) Alzabo::Runtime::RowCursor.3pm.gz

NAME

       Alzabo::Runtime::RowCursor - Cursor that returns "Alzabo::Runtime::Row" objects

SYNOPSIS

         use Alzabo::Runtime::RowCursor;

         my $cursor = $schema->table('foo')->all_rows;

         while ( my $row = $cursor->next )
         {
             print $row->select('foo'), "\n";
         }

DESCRIPTION

       Objects in this class are used to return "Alzabo::Runtime::Row" objects for queries.  The cursor does not
       preload objects but creates them on demand, which is much more efficient.  For more details on the
       rational please see the RATIONALE FOR CURSORS section in Alzabo::Design.

INHERITS FROM

       "Alzabo::Runtime::Cursor"

METHODS

   next
       Returns the next "Alzabo::Runtime::Row" object or undef if no more are available.

   all_rows
       Returns all the rows available from the current point onwards.  This means that if there are five rows
       that will be returned when the object is created and you call "next" twice, calling all_rows after it
       will only return three.

   reset
       Resets the cursor so that the next "next" call will return the first row of the set.

   count
       Returns the number of rows returned by the cursor so far.

   next_as_hash
       Return the next row in a hash, where the hash key is the table name and the hash value is the row object.

AUTHOR

       Dave Rolsky, <autarch@urth.org>