Regexp::Common::URI(3pm)

1Regexp::Common::URI(3)User Contributed Perl DocumentationRegexp::Common::URI(3)
2
3
4

NAME

6       Regexp::Common::URI -- provide patterns for URIs.
7

SYNOPSIS

9           use Regexp::Common qw /URI/;
10
11           while (<>) {
12               /$RE{URI}{HTTP}/       and  print "Contains an HTTP URI.\n";
13           }
14

DESCRIPTION

16       Patterns for the following URIs are supported: fax, file, FTP, gopher,
17       HTTP, news, NTTP, pop, prospero, tel, telnet, tv and WAIS.  Each is
18       documented in the Regexp::Common::URI::scheme, manual page, for the
19       appropriate scheme (in lowercase), except for NNTP URIs which are found
20       in Regexp::Common::URI::news.
21
22       $RE{URI}
23
24       Return a pattern that recognizes any of the supported URIs. With
25       "{-keep}", only the entire URI is returned (in $1).
26

REFERENCES

28       [DRAFT-URI-TV]
29           Zigmond, D. and Vickers, M: Uniform Resource Identifiers for Tele‐
30           vision Broadcasts. December 2000.
31
32       [DRAFT-URL-FTP]
33           Casey, James: A FTP URL Format. November 1996.
34
35       [RFC 1035]
36           Mockapetris, P.: DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION.
37           November 1987.
38
39       [RFC 1738]
40           Berners-Lee, Tim, Masinter, L., McCahill, M.: Uniform Resource
41           Locators (URL). December 1994.
42
43       [RFC 2396]
44           Berners-Lee, Tim, Fielding, R., and Masinter, L.: Uniform Resource
45           Identifiers (URI): Generic Syntax. August 1998.
46
47       [RFC 2616]
48           Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L.,
49           Leach, P. and Berners-Lee, Tim: Hypertext Transfer Protocol --
50           HTTP/1.1.  June 1999.
51
52       [RFC 2806]
53           Vaha-Sipila, A.: URLs for Telephone Calls. April 2000.
54

HISTORY

56        $Log: URI.pm,v $
57        Revision 2.108  2004/06/09 21:45:24  abigail
58        POD
59
60        Revision 2.107  2003/03/25 23:20:30  abigail
61        pop and prospero URIs
62
63        Revision 2.106  2003/03/12 22:28:57  abigail
64        WAIS URIs
65
66        Revision 2.105  2003/02/21 14:49:41  abigail
67        Gopher added
68
69        Revision 2.104  2003/02/11 14:10:25  abigail
70        Changed 'nntp' to 'NNTP'
71
72        Revision 2.103  2003/02/10 21:18:07  abigail
73        Move most of the code into separate files. One file per URI, and
74        one file per RFC.
75
76        Revision 2.102  2003/02/07 15:24:17  abigail
77        telnet URIs
78
79        Revision 2.101  2003/02/01 22:55:31  abigail
80        Changed Copyright years
81
82        Revision 2.100  2003/01/21 23:19:40  abigail
83        The whole world understands RCS/CVS version numbers, that 1.9 is an
84        older version than 1.10. Except CPAN. Curse the idiot(s) who think
85        that version numbers are floats (in which universe do floats have
86        more than one decimal dot?).
87        Everything is bumped to version 2.100 because CPAN couldn't deal
88        with the fact one file had version 1.10.
89
90        Revision 1.11  2003/01/21 22:59:33  abigail
91        Fixed small errors with  and
92
93        Revision 1.10  2003/01/17 13:17:15  abigail
94        Fixed '$toplabel' and '$domainlabel'; they were both subexpressions
95        of the form: A⎪AB. Which passed the tests because most tests anchor
96        the regex at the beginning and end.
97
98        Revision 1.9  2003/01/01 23:00:54  abigail
99        TV URIs
100
101        Revision 1.8  2002/08/27 16:56:27  abigail
102        Support for fax URIs.
103
104        Revision 1.7  2002/08/06 14:44:07  abigail
105        Local phone numbers can have future extensions as well.
106
107        Revision 1.6  2002/08/06 13:18:03  abigail
108        Cosmetic changes
109
110        Revision 1.5  2002/08/06 13:16:27  abigail
111        Added $RE{URI}{tel}{nofuture}
112
113        Revision 1.4  2002/08/06 00:03:30  abigail
114        Added $RE{URI}{tel}
115
116        Revision 1.3  2002/08/04 22:51:35  abigail
117        Added FTP URIs.
118
119        Revision 1.2  2002/07/25 22:37:44  abigail
120        Added 'use strict'.
121        Added 'no_defaults' to 'use Regex::Common' to prevent loading of all
122        defaults.
123
124        Revision 1.1  2002/07/25 19:56:07  abigail
125        Modularizing Regexp::Common.
126

AUTHOR

131       Damian Conway (damian@conway.org)
132

MAINTAINANCE

134       This package is maintained by Abigail (regexp-common@abigail.nl).
135

BUGS AND IRRITATIONS

137       Bound to be plenty.
138
139       For a start, there are many common regexes missing.  Send them in to
140       regexp-common@abigail.nl.
141

COPYRIGHT

143            Copyright (c) 2001 - 2003, Damian Conway. All Rights Reserved.
144              This module is free software. It may be used, redistributed
145             and/or modified under the terms of the Perl Artistic License
146                   (see http://www.perl.com/perl/misc/Artistic.html)
147
148
149
150perl v5.8.8                       2003-03-23            Regexp::Common::URI(3)