IO::Async::Protocol::LineStream - stream-based protocols using lines of text

NAME  SYNOPSIS  DESCRIPTION  EVENTS  on_read_line $line  PARAMETERS  on_read_line => CODE  METHODS  write_line  AUTHOR 

---

NAME

"IO::Async::Protocol::LineStream" − stream−based protocols using lines of text

SYNOPSIS

Most likely this class will be subclassed to implement a particular network protocol.

package Net::Async::HelloWorld;
use strict;
use warnings;
use base qw( IO::Async::Protocol::LineStream );
sub on_read_line
{
my $self = shift;
my ( $line ) = @_;
if( $line =˜ m/ˆHELLO (.*)/ ) {
my $name = $1;
$self−>invoke_event( on_hello => $name );
}
}
sub send_hello
{
my $self = shift;
my ( $name ) = @_;
$self−>write_line( "HELLO $name" );
}

This small example elides such details as error handling, which a real protocol implementation would be likely to contain.

DESCRIPTION

EVENTS

The following events are invoked, either using subclass methods or CODE references in parameters:

on_read_line $line

Invoked when a new complete line of input is received.

PARAMETERS

The following named parameters may be passed to "new" or "configure":

on_read_line => CODE

CODE reference for the "on_read_line" event.

METHODS

write_line

$lineprotocol−>write_line( $text );

Writes a line of text to the transport stream. The text will have the end−of−line marker appended to it; $text should not end with it.

AUTHOR

Paul Evans <[email protected]>

---