Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Path::Dispatcher::RuleUserkContributed Perl DPath::Dispatcher::Rule::Tokens(3)

NAME
       Path::Dispatcher::Rule::Tokens -	predicate is a list of tokens

VERSION
       version 1.08

SYNOPSIS
	   my $rule = Path::Dispatcher::Rule::Tokens->new(
	       tokens	 => [ "comment", "show", qr/^\d+$/ ],
	       delimiter => '/',
	       block	 => sub	{ display_comment(shift->pos(3)) },
	   );

	   $rule->match("/comment/show/25");

DESCRIPTION
       Rules of	this class use a list of tokens	to match the path.

ATTRIBUTES
   tokens
       Each token can be a literal string, a regular expression, or a list of
       either (which are taken to mean alternations). For example, the tokens:

	   [ 'ticket', [ 'show', 'display' ], [	qr/^\d+$/, qr/^#\w{3}/ ] ]

       first matches "ticket". Then, the next token must be "show" or
       "display". The final token must be a number or a	pound sign followed by
       three word characters.

       The results are the tokens in the original string, as they were
       matched.	If you have three tokens, then "match->pos(1)" will be the
       string's	first token ("ticket"),	"match->pos(2)"	its second
       ("display"), and	"match->pos(3)"	its third ("#AAA").

       Capture groups inside a regex token are completely ignored.

   delimiter
       A string	that is	used to	tokenize the path. The delimiter must be a
       string because prefix matches use "join"	on unmatched tokens to return
       the leftover path. In the future	this may be extended to	support	having
       a regex delimiter.

       The default is a	space, but if you're matching URLs you probably	want
       to change this to a slash.

   case_sensitive
       Decide whether the rule matching	is case	sensitive. Default is 1, case
       sensitive matching.

SUPPORT
       Bugs 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>).

AUTHOR
       Shawn M Moore, "<sartak at bestpractical.com>"

COPYRIGHT AND LICENSE
       This 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.

perl v5.32.1			  2020-07-12 Path::Dispatcher::Rule::Tokens(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SUPPORT | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Path::Dispatcher::Rule::Tokens&sektion=3&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help