Abigail > Regexp-Common-2.120 > Regexp::Common::URI::fax

Download:
Regexp-Common-2.120.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  25
Open  5
View Bugs
Report a bug
Module Version: 2.100   Source   Latest Release: Regexp-Common-2.122

NAME ^

Regexp::Common::URI::fax -- Returns a pattern for fax URIs.

SYNOPSIS ^

    use Regexp::Common qw /URI/;

    while (<>) {
        /$RE{URI}{fax}/       and  print "Contains a fax URI.\n";
    }

DESCRIPTION ^

$RE{URI}{fax}

Returns a pattern that matches fax URIs, as defined by RFC 2806. Under {-keep}, the following are returned:

$1

The complete URI.

$2

The scheme.

$3

The phone number, including any possible add-ons like ISDN subaddress, a post dial part, area specifier, service provider, etc.

$RE{URI}{fax}{nofuture}

As above (including what's returned by {-keep}), with the exception that future extensions are not allowed. Without allowing those future extensions, it becomes much easier to check a URI if the correct syntax for post dial, service provider, phone context, etc has been used - otherwise the regex could always classify them as a future extension.

REFERENCES ^

[RFC 1035]

Mockapetris, P.: DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION. November 1987.

[RFC 2396]

Berners-Lee, Tim, Fielding, R., and Masinter, L.: Uniform Resource Identifiers (URI): Generic Syntax. August 1998.

[RFC 2806]

Vaha-Sipila, A.: URLs for Telephone Calls. April 2000.

HISTORY ^

 $Log: fax.pm,v $
 Revision 2.100  2003/02/10 21:06:38  abigail
 fax URI

SEE ALSO ^

Regexp::Common::URI for other supported URIs.

AUTHOR ^

Damian Conway (damian@conway.org)

MAINTAINANCE ^

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

BUGS AND IRRITATIONS ^

Bound to be plenty.

COPYRIGHT ^

     Copyright (c) 2001 - 2003, Damian Conway. All Rights Reserved.
       This module is free software. It may be used, redistributed
      and/or modified under the terms of the Perl Artistic License
            (see http://www.perl.com/perl/misc/Artistic.html)