File Coverage

blib/lib/IO/Framed/X/EmptyRead.pm

Criterion	Covered	Total	%
statement	11	11	100.0
branch			n/a
condition			n/a
subroutine	4	4	100.0
pod			n/a
total	15	15	100.0

package IO::Framed::X::EmptyRead;

=encoding utf-8

=head1 NAME

IO::Framed::X::EmptyRead

=head1 SYNOPSIS

    use Try::Tiny;
    use IO::Framed::Read;

    my $iof = IO::Framed::Read->new( $some_socket );

    try { $iof->read(20) }
    catch {
        if ( try { $_->isa('IO::Framed::Read') } ) { ... }
    };

=head1 DESCRIPTION

Thrown when a read operation returns empty but without an error from the
operating system. This isn’t an *error* so much as just an “exceptional
condition” that so radically changes the application state that it’s
worth throwing on.

You should probably always trap this error so you can cleanly shut things
down.

=cut

use strict;
use warnings;

use parent qw( X::Tiny::Base );

sub _new {
    my ($class) = @_;

    return $class->SUPER::_new( 'Got empty read; EOF?' );
}

1;