Regexp::Common::URI::news

Section: User Contributed Perl Documentation (3)
Updated: 2003-03-23
Index Return to Main Contents
 

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

 

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
$RE{URI}{news}
$RE{URI}{NNTP}
REFERENCES
HISTORY
SEE ALSO
AUTHOR
MAINTAINANCE
BUGS AND IRRITATIONS
COPYRIGHT

linux.jgfs.net manual pages