2 URI::Template - Object for handling URI templates
6 my $template = URI::Template->new( 'http://example.com/{x}' );
7 my $uri = $template->process( x => 'y' );
8 # uri is a URI object with value 'http://example.com/y'
10 my %result = $template->deparse( $uri );
11 # %result is ( x => 'y' )
14 This is an initial attempt to provide a wrapper around URI templates as
16 http://www.ietf.org/internet-drafts/draft-gregorio-uritemplate-01.txt
26 Creates a new URI::Template instance with the template passed in as the
30 Returns the original template string. Also used when the object is
34 Returns an array of unique variable names found in the template. NB:
35 they are returned in random order.
38 Returns an array of variable names found as they appear in template --
39 in order, duplicates included.
41 process( %vars|\@values )
42 Given a list of key-value pairs or an array ref of values (for
43 positional substitution), it will URI escape the values and substitute
44 them in to the template. Returns a URI object.
46 process_to_string( %vars|\@values )
47 Processes input like the "process" method, but doesn't inflate the
48 result to a URI object.
51 Does some rudimentary deparsing of a uri based on the current template.
52 Returns a hash with the extracted values.
55 Brian Cassidy <bricas@cpan.org>
58 Copyright 2008 by Brian Cassidy
60 This library is free software; you can redistribute it and/or modify it
61 under the same terms as Perl itself.