NAME

Regexp::Common::URI::news -- Returns a pattern for file URIs.

SYNOPSIS

    use Regexp::Common qw /URI/;

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

DESCRIPTION

$RE{URI}{news}

Returns a pattern that matches news URIs, as defined by RFC 1738. News URIs have the form:

    "news:"; ( "*" | group | article "@" host )

Under {-keep}, the following are returned:

$1: The complete URI.
$2: The scheme.
$3: The part of the URI following ``news://''.

$RE{URI}{NNTP}

Returns a pattern that matches NNTP URIs, as defined by RFC 1738. NNTP URIs have the form:

    "nntp://" host [ ":" port ] "/" group [ "/" digits ]

Under {-keep}, the following are returned:

$1: The complete URI.
$2: The scheme.
$3: The part of the URI following ``nntp://''.
$4: The host and port, separated by a colon. If no port was given, just the host.
$5: The host.
$6: The port, if given.
$7: The group.
$8: The digits, if given.

REFERENCES

[RFC 1738]: Berners-Lee, Tim, Masinter, L., McCahill, M.: Uniform Resource Locators (URL). December 1994.

HISTORY

 $Log: news.pm,v $
 Revision 2.100  2003/02/11 14:11:29  abigail
 NNTP and news 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::news -- Returns a pattern for file URIs.