uri::queryparam(3) [suse man page]

URI::QueryParam(3)					User Contributed Perl Documentation					URI::QueryParam(3)

NAME

       URI::QueryParam - Additional query methods for URIs

SYNOPSIS

	 use URI;
	 use URI::QueryParam;

	 $u = URI->new("", "http");
	 $u->query_param(foo => 1, 2, 3);
	 print $u->query;    # prints foo=1&foo=2&foo=3

	 for my $key ($u->query_param) {
	     print "$key: ", join(", ", $u->query_param($key)), "
";
	 }

DESCRIPTION

       Loading the "URI::QueryParam" module adds some extra methods to URIs that support query methods.  These methods provide an alternative
       interface to the $u->query_form data.

       The query_param_* methods have deliberately been made identical to the interface of the corresponding "CGI.pm" methods.

       The following additional methods are made available:

       @keys = $u->query_param
       @values = $u->query_param( $key )
       $first_value = $u->query_param( $key )
       $u->query_param( $key, $value,... )
	   If $u->query_param is called with no arguments, it returns all the distinct parameter keys of the URI.  In a scalar context it returns
	   the number of distinct keys.

	   When a $key argument is given, the method returns the parameter values with the given key.  In a scalar context, only the first
	   parameter value is returned.

	   If additional arguments are given, they are used to update successive parameters with the given key.  If any of the values provided are
	   array references, then the array is dereferenced to get the actual values.

       $u->query_param_append($key, $value,...)
	   Adds new parameters with the given key without touching any old parameters with the same key.  It can be explained as a more efficient
	   version of:

	      $u->query_param($key,
			      $u->query_param($key),
			      $value,...);

	   One difference is that this expression would return the old values of $key, whereas the query_param_append() method does not.

       @values = $u->query_param_delete($key)
       $first_value = $u->query_param_delete($key)
	   Deletes all key/value pairs with the given key.  The old values are returned.  In a scalar context, only the first value is returned.

	   Using the query_param_delete() method is slightly more efficient than the equivalent:

	      $u->query_param($key, []);

       $hashref = $u->query_form_hash
       $u->query_form_hash( \%new_form )
	   Returns a reference to a hash that represents the query form's key/value pairs.  If a key occurs multiple times, then the hash value
	   becomes an array reference.

	   Note that sequence information is lost.  This means that:

	      $u->query_form_hash($u->query_form_hash);

	   is not necessarily a no-op, as it may reorder the key/value pairs.  The values returned by the query_param() method should stay the
	   same though.

SEE ALSO

       URI, CGI

COPYRIGHT

       Copyright 2002 Gisle Aas.

perl v5.12.1							    2009-05-28							URI::QueryParam(3)

Check Out this Related Man Page

REQUESTREC(1)						User Contributed Perl Documentation					     REQUESTREC(1)

NAME

       Apache::RequestRec -- A Perl API for Apache request object

SYNOPSIS

	 use Apache::RequestRec;
	 sub handler{
	     my $r = shift;

	     my $s = $r->server;
	     my $dir_config = $r->dir_config;
	     ...
	 }

DESCRIPTION

       "Apache::RequestRec" provides the Perl API for Apache request object.

API

       Function arguments (if any) and return values are shown in the function's synopsis.

       o server()
	     $s = $r->server;

	   Gets the "Apache::Server" object for the server the request $r is running under.

       o dir_config()
	   dir_config() provides an interface for the per-directory variable specified by the "PerlSetVar" and "PerlAddVar" directives, and also
	   can be manipulated via the "APR::Table" methods.

	   The keys are case-insensitive.

	     $apr_table = $r->dir_config();

	   dir_config() called in a scalar context without the $key argument returns a HASH reference blessed into the APR::Table class. This
	   object can be manipulated via the APR::Table methods. For available methods see APR::Table.

	     @values = $r->dir_config($key);

	   If the $key argument is passed in the list context a list of all matching values will be returned. This method is ineffective for big
	   tables, as it does a linear search of the table. Thefore avoid using this way of calling dir_config() unless you know that there could
	   be more than one value for the wanted key and all the values are wanted.

	     $value = $r->dir_config($key);

	   If the $key argument is passed in the scalar context only a single value will be returned. Since the table preserves the insertion
	   order, if there is more than one value for the same key, the oldest value assosiated with the desired key is returned. Calling in the
	   scalar context is also much faster, as it'll stop searching the table as soon as the first match happens.

	     $r->dir_config($key => $val);

	   If the $key and the $val arguments are used, the set() operation will happen: all existing values associated with the key $key (and the
	   key itself) will be deleted and $value will be placed instead.

	     $r->dir_config($key => undef);

	   If $val is undef the unset() operation will happen: all existing values associated with the key $key (and the key itself) will be
	   deleted.

       o

perl v5.8.0							    2002-05-19							     REQUESTREC(1)

Linux and UNIX Man Pages

uri::queryparam(3) [suse man page]

Check Out this Related Man Page