NAME

Alzabo::Runtime::OuterJoinCursor - Cursor that returns arrays of Alzabo::Runtime::Row objects or undef

SYNOPSIS

  my $cursor = $schema->left_outer_join( tables => [ $foo, $bar ] );

  while ( my @rows = $cursor->next )
  {
      print $row[0]->select('foo'), "\n";
      print $row[1]->select('bar'), "\n" if defined $row[1];
  }

DESCRIPTION

This class exists to handle the return values from outer joins properly. If the join returns NULL, then it returns undef instead of a row object for a that row, instead of a row object.

INHERITS FROM

Alzabo::Runtime::JoinCursor

next

Returns

The next array of Alzabo::Runtime::Row objects and/or undefs, or an empty list if no more arrays of rows are available.

This behavior can mask errors in your database's referential integrity. For more information on how to deal with this see the HANDLING ERRORS section in Alzabo::Runtime::Cursor.

AUTHOR

Dave Rolsky, <autarch@urth.org>