NAME

Regexp::Common::net -- provide regexes for IPv4 addresses.

SYNOPSIS

use Regexp::Common qw /net/;

while (<>) {
    /$RE{net}{IPv4}/       and print "Dotted decimal IP address";
    /$RE{net}{IPv4}{hex}/  and print "Dotted hexadecimal IP address";
    /$RE{net}{IPv4}{oct}{-sep => ':'}/ and
                           print "Colon separated octal IP address";
    /$RE{net}{IPv4}{bin}/  and print "Dotted binary IP address";
}

DESCRIPTION

Please consult the manual of Regex::Common for a general description of the works of this interface.

Do not use this module directly, but load it via Regex::Common.

This modules gives you regular expressions for various style IPv4 addresses.

$RE{net}{IPv4}

Returns a pattern that matches a valid IP address in "dotted decimal"

For this pattern and the next four, under -keep (See Regexp::Common):

$1

captures the entire match

$2

captures the first component of the address

$3

captures the second component of the address

$4

captures the third component of the address

$5

captures the final component of the address

$RE{net}{IPv4}{dec}{-sep}

Returns a pattern that matches a valid IP address in "dotted decimal"

If -sep=>P is specified the pattern P is used as the separator. By default P is qr/[.]/.

$RE{net}{IPv4}{hex}{-sep}

Returns a pattern that matches a valid IP address in "dotted hexadecimal"

If -sep=>P is specified the pattern P is used as the separator. By default P is qr/[.]/. -sep=>"" and -sep=>" " are useful alternatives.

$RE{net}{IPv4}{oct}{-sep}

Returns a pattern that matches a valid IP address in "dotted octal"

If -sep=>P is specified the pattern P is used as the separator. By default P is qr/[.]/.

$RE{net}{IPv4}{bin}{-sep}

Returns a pattern that matches a valid IP address in "dotted binary"

If -sep=>P is specified the pattern P is used as the separator. By default P is qr/[.]/.

SEE ALSO

Regexp::Common for a general description of how to use this interface.

AUTHOR

Damian Conway (damian@conway.org)

MAINTAINANCE

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

BUGS AND IRRITATIONS

Bound to be plenty.

For a start, there are many common regexes missing. Send them in to regexp-common@abigail.nl.

COPYRIGHT

Copyright (c) 2001 - 2002, 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)