Regexp::Common::URI::file

Section: User Contributed Perl Documentation (3)
Updated: 2021-01-27
Page Index

NAME

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

SYNOPSIS

    use Regexp::Common qw /URI/;

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

DESCRIPTION

$RE{URI}{file}

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

    "file:" "//" [ host | "localhost" ] "/" fpath

Under "{-keep}", the following are returned:

$1: The complete URI.
$2: The scheme.
$3: The part of the URI following ``file://''.
$4: The hostname.
$5: The path name, including the leading slash.
$6: The path name, without the leading slash.

REFERENCES

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

AUTHOR

Damian Conway (damian@conway.org)

MAINTENANCE

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

BUGS AND IRRITATIONS

Bound to be plenty.

LICENSE and COPYRIGHT

This module is free software, and maybe used under any of the following licenses:

 1) The Perl Artistic License.     See the file COPYRIGHT.AL.
 2) The Perl Artistic License 2.0. See the file COPYRIGHT.AL2.
 3) The BSD License.               See the file COPYRIGHT.BSD.
 4) The MIT License.               See the file COPYRIGHT.MIT.