NAME

Net::Address::IPv4 - Moose Object for IPv4 Addresses

SYNOPSIS

use Net::Address::IPv4;

# We try stay pretty loose on what we'll take in for object creation, so
my $ip = new Net::Address::IPv4 ( ip => "172.16.1.1",
                                  netmask => "255.255.255.0" );
# is the same as
my $ip = new Net::Address::IPv4 ( ip =>"10101100000100000000001001100001",
                                  netmask => "24" );
# As you see, the dot-quad, cidr, and binary notation are all valid ways to
# create a new instance. Internally, we store it all as the 32bit binary
# because it's the lowest common denominator for ip addresses.


print "My ip address is " . $ip->ip() . "\n";     # Prints the binary
print "My ip address is " . $ip->ip4() . "\n";    # Prints the dot-quad

print "My netmask is " . $ip->netmask() . "\n";   # Prints the binary
print "My netmask is " . $ip->netmask4() . "\n";  # Prints the dot-quad
print "My cidr is " . $ip->cidr() . "\n";         # Print the cidr mask


# And we can even easily get the inverse mask
print "Inverse netmask is " . $ip->netmask4_inv() . "\n"; # dot-quad inverse


# What is the next or previous ip address in the block.
my $next_ip = $ip->next_ip();
print "The next ip address is " . $next_ip->ip4() . "\n" if $next_ip;

my $prev_ip = $ip->previous_ip();
print "The previous ip address is " . $prev_ip->ip4() . "\n" if $prev_ip;

--OR--

print "The next ip address is " . $ip->next_ip->ip4() . "\n";

# next_ip() will return false if you are currently at the last ip address in
# the objects block. i.e if your ip is 172.16.0.254/24, calling next_ip()
# will return false, because 172.16.0.255 is the broadcast address and not
# a valid ip address. This is also the same behaviour of previous_ip()
# The caveat here is if the CIDR is /31 or /32, since those don't strictly
# adhear to the concept of network and broadcast address's


## We can easily see the network and broadcast address in our specified range

print "Broadcast Address: " . $ip->broadcast() . "\n"; ## Prints the binary
print "Broadcast Address: " . $ip->broadcast4() . "\n"; # Prints the dot-quad

print "Network Address: " . $ip->network() . "\n"; ## Prints the binary
print "Network Address: " . $ip->network4() . "\n"; # Prints the dot-quad


# We also have some pretty generic true-false tests to determine more info
# about our IP address

$self->is_class_d();    # 224.0.0.0/4
$self->is_class_e();    # 240.0.0.0/4
$self->is_linklocal();  # 169.254.0.0/16
$self->is_localhost();  # 127.0.0.0/8
$self->is_reserved();   # See RFC3330; 128.0.0.0/16, 191.255.0.0/16,
                        #              192.0.0.0/24, 223.255.255.0/24

$self->is_rfc1918();    # 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16
$self->is_rfc2544();    # 198.18.0.0/15
$self->is_testnet();    # 192.0.2.0/24

DESCRIPTION

Provides an object for an IPv4 address.

SEE ALSO

MooseX::Types::IPv4

AUTHOR

Kyle Hultman, <khultman@gmail.com<gt>

COPYRIGHT

Copyright 2009 the above AUTHORS

LICENSE

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.