![]() |
![]()
| ![]() |
![]()
NAMEPath::Dispatcher::Match - the result of a successful rule match VERSIONversion 1.08 SYNOPSISmy $rule = Path::Dispatcher::Rule::Tokens->new( tokens => [ 'attack', qr/^\w+$/ ], block => sub { my $match = shift; attack($match->pos(2)) }, ); my $match = $rule->match("attack dragon"); # introspection $match->path # "attack dragon" $match->leftover # empty string (populated with prefix rules) $match->rule # $rule $match->positional_captures # ["attack", "dragon"] (decided by the rule) $match->pos(1) # "attack" $match->pos(2) # "dragon" $match->run # attack("dragon") DESCRIPTIONIf a Path::Dispatcher::Rule successfully matches a path, it creates one or more "Path::Dispatcher::Match" objects. ATTRIBUTESruleThe Path::Dispatcher::Rule that created this match. pathThe path that the rule matched. leftoverThe rest of the path. This is populated when the rule matches a prefix of the path. positional_capturesAny positional captures generated by the rule. For example, Path::Dispatcher::Rule::Regex populates this with the capture variables. named_capturesAny named captures generated by the rule. For example, Path::Dispatcher::Rule::Regex populates this with named captures. parentThe parent match object, if applicable (which may be set if this match is the child of, for exampl, a Path::Dispatcher::Rule::Under prefix) METHODSrunExecutes the rule's codeblock with the same arguments. pos($i)Returns the $ith positional capture, 1-indexed. SUPPORTBugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Path-Dispatcher> (or bug-Path-Dispatcher@rt.cpan.org <mailto:bug-Path-Dispatcher@rt.cpan.org>). AUTHORShawn M Moore, "<sartak at bestpractical.com>" COPYRIGHT AND LICENSEThis software is copyright (c) 2020 by Shawn M Moore. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
|