CGI::PathParam - Add the feature of parsing path_info to CGI.


CGI-PathParam documentation Contained in the CGI-PathParam distribution.

Index


Code Index:

NAME

Top

CGI::PathParam - Add the feature of parsing path_info to CGI.

VERSION

Top

0.04

SYNOPSIS

Top

    use CGI;
    use CGI::PathParam;

    my $q = CGI->new;

    $q->path_param(qw(foo bar baz));    # same as $q->path_info('/foo/bar/baz')
    my @results = $q->path_param;       # @results is ( 'foo', 'bar', 'baz' ).

DESCRIPTION

Top

This module adds the feature of parsing PATH_INFO to CGI as a plugin.

SUBROUTINES/METHODS

Top

path_param(@)

If the arguments are specified, the values joined by / is set to path_info. Otherwise, it returns the list of path_info split.

DIAGNOSTICS

Top

Use of uninitialized value in join or string at ...

If you pass undef to path_param then you will see this message.

CONFIGURATION AND ENVIRONMENT

Top

DEPENDENCIES

Top

CGI

INCOMPATIBILITIES

Top

BUGS AND LIMITATIONS

Top

The path_param() does not provide a setter feature yet.

Please report any bugs or feature requests to bug-cgi-pathparam@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CGI-PathParam. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

You can find documentation for this module with the perldoc command.

    perldoc CGI::PathParam

You can also look for information at:

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/CGI-PathParam

* CPAN Ratings

http://cpanratings.perl.org/d/CGI-PathParam

* RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=CGI-PathParam

* Search CPAN

http://search.cpan.org/dist/CGI-PathParam

AUTHOR

Top

Hironori Yoshida, <yoshida@cpan.org>

LICENSE AND COPYRIGHT

Top


CGI-PathParam documentation Contained in the CGI-PathParam distribution.
#
# $Revision: 1.5 $
# $Source: /home/cvs/CGI-PathParam/lib/CGI/PathParam.pm,v $
# $Date: 2006/06/01 06:23:22 $
#
package CGI::PathParam;
use strict;
use warnings;

our $VERSION = '0.04';

sub path_param {
    my $self = shift;

    if (@_) {

        # When path_info(undef), only returns current path_info data.
        # The behavior is same as path_info()
        # However, that of path_param(undef) is *NOT* same as path_param().
        # Because path_param($param) occurs two kinds of behavior
        # whether $param is undef or not.

        $self->path_info( join q{/}, map { $self->escape($_) } @_ );

        return $self;
    }

    if ( !$self->path_info ) {
        return;
    }

    return map { $self->unescape($_) }
      split m{/}msx, substr $self->path_info, 1;
}

*CGI::path_param = \&path_param;

1;    # End of CGI::PathParam