1POE::Filter::IRCD(3)  User Contributed Perl Documentation POE::Filter::IRCD(3)
2
3
4

NAME

6       POE::Filter::IRCD - A POE-based parser for the IRC protocol
7

VERSION

9       version 2.44
10

SYNOPSIS

12           use POE::Filter::IRCD;
13
14           my $filter = POE::Filter::IRCD->new( debug => 1, colonify => 0 );
15           my $arrayref = $filter->get( [ $hashref ] );
16           my $arrayref2 = $filter->put( $arrayref );
17
18           use POE qw(Filter::Stackable Filter::Line Filter::IRCD);
19
20           my ($filter) = POE::Filter::Stackable->new();
21           $filter->push( POE::Filter::Line->new( InputRegexp => '\015?\012', OutputLiteral => "\015\012" ),
22                          POE::Filter::IRCD->new(), );
23

DESCRIPTION

25       POE::Filter::IRCD provides a convenient way of parsing and creating IRC
26       protocol lines. It provides the parsing engine for
27       POE::Component::Server::IRC and POE::Component::IRC.  A standalone
28       version exists as Parse::IRC.
29

CONSTRUCTOR

31       "new"
32           Creates a new POE::Filter::IRCD object. Takes two optional
33           arguments:
34
35             'debug', which will print all lines received to STDERR;
36             'colonify', set to 1 to force the filter to always colonify the last param passed in a put(),
37                         default is 0. See below for more detail.
38

METHODS

40       "get_one_start"
41       "get_one"
42       "get_pending"
43       "get"
44           Takes an arrayref which is contains lines of IRC formatted input.
45           Returns an arrayref of hashrefs which represents the lines. The
46           hashref contains the following fields:
47
48             prefix
49             command
50             params ( this is an arrayref )
51             raw_line
52
53           For example, if the filter receives the following line, the
54           following hashref is produced:
55
56             LINE: ':moo.server.net 001 lamebot :Welcome to the IRC network lamebot'
57
58             HASHREF: {
59                           prefix   => ':moo.server.net',
60                           command  => '001',
61                           params   => [ 'lamebot', 'Welcome to the IRC network lamebot' ],
62                           raw_line => ':moo.server.net 001 lamebot :Welcome to the IRC network lamebot',
63                      }
64
65       "put"
66           Takes an arrayref containing hashrefs of IRC data and returns an
67           arrayref containing IRC formatted lines.  Optionally, one can
68           specify 'colonify' to override the global colonification option.
69           eg.
70
71             $hashref = {
72                           command => 'PRIVMSG',
73                           prefix => 'FooBar!foobar@foobar.com',
74                           params => [ '#foobar', 'boo!' ],
75                           colonify => 1, # Override the global colonify option for this record only.
76                         };
77
78             $filter->put( [ $hashref ] );
79
80       "clone"
81           Makes a copy of the filter, and clears the copy's buffer.
82
83       "debug"
84           With a true or false argument, enables or disables debug output
85           respectively. Without an argument the behaviour is to toggle the
86           debug status.
87

SEE ALSO

89       POE
90
91       POE::Filter
92
93       POE::Filter::Stackable
94
95       POE::Component::Server::IRC
96
97       POE::Component::IRC
98
99       Parse::IRC
100

AUTHOR

102       Chris Williams <chris@bingosnet.co.uk>
103

105       This software is copyright (c) 2013 by Chris Williams and Jonathan
106       Steinert.
107
108       This is free software; you can redistribute it and/or modify it under
109       the same terms as the Perl 5 programming language system itself.
110
111
112
113perl v5.34.0                      2021-07-22              POE::Filter::IRCD(3)
Impressum