DateTime::Format::Builder::Parser::Dispatch - phpMan

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

VERSION
    version 0.83

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 SYNOPSIS. They follow
    the same format as when you specify them for methods.

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

SEE ALSO
    "datetime AT perl.org" mailing list.

    http://datetime.perl.org/

    perl, DateTime, DateTime::Format::Builder

SUPPORT
    Bugs may be submitted at
    <https://github.com/houseabsolute/DateTime-Format-Builder/issues>.

    I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".

SOURCE
    The source code repository for DateTime-Format-Builder can be found at
    <https://github.com/houseabsolute/DateTime-Format-Builder>.

AUTHORS
    *   Dave Rolsky <autarch AT urth.org>

    *   Iain Truskett <spoon AT cpan.org>

COPYRIGHT AND LICENSE
    This software is Copyright (c) 2020 by Dave Rolsky.

    This is free software, licensed under:

      The Artistic License 2.0 (GPL Compatible)

    The full text of the license can be found in the LICENSE file included
    with this distribution.