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



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

the Regexp::Common::URI manpage 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)

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