RegExp::Common::URI::http(3)
NAME
Regexp::Common::URI::http -- Returns a pattern for HTTP URIs.
SYNOPSIS
use Regexp::Common qw /URI/;
while (<>) {
/$RE{URI}{HTTP}/ and print "Contains an HTTP URI.\n";
}
DESCRIPTION
$RE{URI}{HTTP}{-scheme}
Provides a regex for an HTTP URI as defined by RFC 2396 (generic
syntax) and RFC 2616 (HTTP).
If "-scheme => P" is specified the pattern P is used as the scheme. By
default P is "qr/http/". "https" and "https?" are reasonable
alternatives.
The syntax for an HTTP URI is:
"http:" "//" host [ ":" port ] [ "/" path [ "?" query ]]
Under "{-keep}", the following are returned:
$1 The entire URI.
$2 The scheme.
$3 The host (name or address).
$4 The port (if any).
$5 The absolute path, including the query and leading slash.
$6 The absolute path, including the query, without the leading slash.
$7 The absolute path, without the query or leading slash.
$8 The query, without the question mark.
REFERENCES
[RFC 2396]
Berners-Lee, Tim, Fielding, R., and Masinter, L.: Uniform Resource
Identifiers (URI): Generic Syntax. August 1998.
[RFC 2616]
Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L.,
Leach, P. and Berners-Lee, Tim: Hypertext Transfer Protocol --
HTTP/1.1. June 1999.
HISTORY
$Log: http.pm,v $
Revision 2.103 2008/05/23 21:30:10 abigail
Changed email address
Revision 2.102 2008/05/23 21:28:02 abigail
Changed license
Revision 2.101 2004/06/09 21:42:48 abigail
POD nits
Revision 2.100 2003/02/10 21:06:41 abigail
http URI
SEE ALSO
Regexp::Common::URI(3) for other supported URIs.
AUTHOR
Damian Conway (damian@conway.org)
MAINTAINANCE
This package is maintained by Abigail (regexp-common@abigail.be).
BUGS AND IRRITATIONS
Bound to be plenty.
COPYRIGHT
This software is Copyright (c) 2001 - 2008, Damian Conway and Abigail.
This module is free software, and maybe used under any of the following
licenses:
1) The Perl Artistic License. See the file COPYRIGHT.AL.
2) The Perl Artistic License 2.0. See the file COPYRIGHT.AL2.
3) The BSD Licence. See the file COPYRIGHT.BSD.
4) The MIT Licence. See the file COPYRIGHT.MIT.
perl v5.10.0 2008-05-23 Regexp::Common::URI::http(3)
Mac OS X 10.6 - Generated Thu Sep 17 20:14:57 CDT 2009