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 can suppress this error by setting C on the
L instance; otherwise, you should probably always trap
this error so you can cleanly shut things down.

=cut

use strict;
use warnings;

use parent qw( IO::Framed::X::Base );

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

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

1;