---
name: "CGI::Application::Dispatch::Regexp"
section: "3pm"
platform: "linux"
package: "libcgi-application-dispatch-perl"
version: "3.12-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/CGI::Application::Dispatch::Regexp"
---

# CGI::Application::Dispatch::Regexp(3pm)

Dispatch requests to CGI::Application based objects using regular expressions

## NAME

CGI::Application::Dispatch::Regexp - Dispatch requests to CGI::Application based objects using regular expressions

## SYNOPSIS

```
    use CGI::Application::Dispatch::Regexp;
    CGI::Application::Dispatch::Regexp->dispatch(
        prefix  => 'MyApp',
        table   => [
            ''                                    => { app => 'Welcome',
                                                       rm  => 'start',
                                                     },
            qr|/([^/]+)/?|                        => { names => ['app'],
                                                     },
            qr|/([^/]+)/([^/]+)/?|                => { names =>
                                                         [qw(app rm)]
                                                     },
            qr|/([^/]+)/([^/]+)/page(\d+)\.html?| => { names =>
                                                         [qw(app rm page)]
                                                     },
        ],
    );
```

## DESCRIPTION

CGI::Application::Dispatch uses its own syntax dispatch table. `"CGI::Application::Dispatch::Regexp"` allows one to use flexible and powerful Perl regular expressions to transform a path into argument list.

## DISPATCH TABLE

The dispatch table should contain list of regular expressions with hashref of corresponding parameters. Hash element 'names' is a list of names of regular expression groups. The default table looks like this:

```
        table       => [
            qr|/([^/]+)/?|          => { names => ['app']      },
            qr|/([^/]+)/([^/]+)/?|  => { names => [qw(app rm)] },
        ],
```

Here's an example of defining a custom 'page' parameter:

```
        qr|/([^/]+)/([^/]+)/page(\d+)\.html/?| => {
            names => [qw(app rm page)],
        },
```

## COPYRIGHT & LICENSE

Copyright Michael Peters and Mark Stosberg 2008, all rights reserved.

## SEE ALSO

CGI::Application, CGI::Application::Dispatch