Paul Evans > Net-Async-IRC-0.07 > Protocol::IRC::Message

Download:
Net-Async-IRC-0.07.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.02   Source   Latest Release: Net-Async-IRC-0.09

NAME ^

Protocol::IRC::Message - encapsulates a single IRC message

SYNOPSIS ^

 use Protocol::IRC::Message;

 my $hello = Protocol::IRC::Message->new(
    "PRIVMSG",
    undef,
    "World",
    "Hello, world!"
 );

 printf "The command is %s and the final argument is %s\n",
    $hello->command, $hello->arg( -1 );

DESCRIPTION ^

An object in this class represents a single IRC message, either received from or to be sent to the server. These objects are immutable once constructed, but provide a variety of methods to access the contained information.

This class also understands IRCv3 message tags.

CONSTRUCTOR ^

$message = Protocol::IRC::Message->new_from_line( $line )

Returns a new Protocol::IRC::Message object, constructed by parsing the given IRC line. Most typically used to create a new object to represent a message received from the server.

$message = Protocol::IRC::Message->new( $command, $prefix, @args )

Returns a new Protocol::IRC::Message object, intialised from the given components. Most typically used to create a new object to send to the server using stream_to_line. The message will contain no IRCv3 tags.

$mesage = Protocol::IRC::Message->new_with_tags( $command, \%tags, $prefix, @args )

Returns a new Protocol::IRC::Message object, as with new but also containing the given IRCv3 tags.

METHODS ^

$str = $message->STRING

$str = "$message"

Returns a string representing the message, suitable for use in a debugging message or similar. Note: This is not the same as the IRC wire form, to send to the IRC server; for that see stream_to_line.

$command = $message->command

Returns the command name or numeric stored in the message object.

$name = $message->command_name

For named commands, returns the command name directly. For server numeric replies, returns the name of the numeric.

$tags = $message->tags

Returns a hash reference containing IRCv3 message tags. This is a reference to the hash stored directly by the object itself, so the caller should be careful not to modify it.

$prefix = $message->prefix

Returns the line prefix stored in the object, or the empty string if one was not supplied.

( $nick, $ident, $host ) = $message->prefix_split

Splits the prefix into its nick, ident and host components. If the prefix contains only a hostname (such as the server name), the first two components will be returned as undef.

$arg = $message->arg( $index )

Returns the argument at the given index. Uses normal perl array indexing, so negative indices work as expected.

@args = $message->args

Returns a list containing all the message arguments.

$line = $message->stream_to_line

Returns a string suitable for sending the message to the IRC server.

$names = $message->arg_names

Returns a hash giving details on how to parse named arguments for the command given in this message.

This will be a hash whose keys give the names of the arguments, and the values of these keys indicate how that argument is derived from the simple positional arguments.

Normally this method is only called internally by the named_args method, but is documented here for the benefit of completeness, and in case extension modules wish to define parsing of new message types.

Each value should be one of the following:

$args = $message->named_args

Parses arguments in the message according to the specification given by the arg_names method. Returns a hash of parsed arguments.

TODO: More complete documentation on the exact arg names/values per message type.

AUTHOR ^

Paul Evans <leonerd@leonerd.org.uk>

syntax highlighting: