/ 
DBIx-Class-Helpers-2.030001
River stage two • 10 direct dependents • 14 total dependents
/ DBIx::Class::Helper::ResultSet::OneRow

NAME

DBIx::Class::Helper::ResultSet::OneRow - The first you always wanted

SYNOPSIS

# note that this is normally a component for a ResultSet
package MySchema::ResultSet::Person;

use strict;
use warnings;

use parent 'DBIx::Class::ResultSet';

__PACKAGE__->load_components('Helper::ResultSet::OneRow');

sub person_named {
   $_[0]->search({ name => $_[1] })->one_row
}

DESCRIPTION

This component codifies a "more correct" version of "first" in DBIx::Class::ResultSet. Fundamentally the difference is that when you use one_row you are garaunteed to exhaust the underlying cursor; depending on your database this can resolve weird issues.

METHODS

one_row

Limits the ResultSet to a single row, and then returns the matching result object. In case no rows match, undef is returned as normal.

THANKS

Thanks to Aran Clary Deltac (BLUEFEET) for initially writing this module, and thanks to ZipRecruiter for sponsoring that initial developmentl

AUTHOR

Arthur Axel "fREW" Schmidt <frioux+cpan@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Arthur Axel "fREW" Schmidt.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.