DateTime::Format::Builder::Parser::Dispatch (3)

Leading comments

Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/DateTime::Format::Builder::Parser::Dispatch.3pm".)

NAME

DateTime::Format::Builder::Parser::Dispatch - Dispatch parsers by group

VERSION

version 0.81

SYNOPSIS

    package SampleDispatch;
    use DateTime::Format::Builder
    (
        parsers => {
            parse_datetime => [
                {
                    Dispatch => sub {
                        return 'fnerk';
                    }
                }
            ]
        },
        groups => {
            fnerk => [
                {
                    regex => qr/^(\d{4})(\d\d)(\d\d)$/,
                    params => [qw( year month day )],
                },
            ]
        }
    );

DESCRIPTION

"Dispatch" adds another parser type to "Builder" permitting dispatch of parsing according to group names.

SPECIFICATION

"Dispatch" has just one key: "Dispatch". The value should be a reference to a subroutine that returns one of:

*

"undef", meaning no groups could be found.

*

An empty list, meaning no groups could be found.

*

A single string, meaning: use this group

*

A list of strings, meaning: use these groups in this order.

Groups are specified much like the example in the

. They follow the same format as when you specify them for methods.

SIDEEFFECTS

Your group parser can also be a Dispatch parser. Thus you could potentially end up with an infinitely recursive parser.

SUPPORT

See DateTime::Format::Builder for details.

SEE ALSO

"datetime@perl.org" mailing list.

datetime.perl.org

perl, DateTime, DateTime::Format::Builder

AUTHORS

*

Dave Rolsky <autarch@urth.org>

*

Iain Truskett

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)