The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Net-IPAddress-Minimal-0.03
River stage zero No dependents
1 ++
/ Net::IPAddress::Minimal

NAME

Net::IPAddress::Minimal - IP string to number and back

VERSION

Version 0.03

SYNOPSIS

This module converts IPv4 strings to integer IP numbers and vice versa.

It's built to be used as quickly and easily as possible, which is why you can just simply use the invert_ip function.

It recognizes whether you have an IPv4 string or a number and converts it to the other form.

Here's a sample script:

    use Net::IPAddress::Minimal ('invert_ip');

    my $input_string = shift @ARGV;
    my $output       = invert_ip( $input_string );

    print "$output\n";

EXPORT

Three functions can be exported:

  • invert_ip

  • num_to_ip

  • ip_to_num

SUBROUTINES/METHODS

invert_ip

Gets an IPv4 string or an IP number and converts it to the other form.

    my $ip_num = invert_ip( '10.200.10.130' );
    #  $ip_str = 180882050
    
    my $ip_num = invert_ip( 180882050 );
    #  $ip_str = '10.200.10.130';

num_to_ip

Gets an IP number and returns an IPv4 string.

    my $ip_num = num_to_ip( 3232235778 );
    #  $ip_str = '192.168.1.2';

ip_to_num

Gets a IPv4 string and returns the matching IP number.

Note that at the moment this function does not ensure that each of the class numbers are between 0-255, and it can return unexpected results when misused

    my $ip_num = ip_to_num( '212.212.212.212' );
    #  $ip_num = 3570717908

test_string_structure

Checks the structure of the input string and returns flags indicating whether it's an IPv4 string, and IP number or something else (which is an error).

AUTHORS

Tamir Lousky, <tlousky at cpan.org>

SawyerX, <xsawyerx at cpan.org>

BUGS

Please report any bugs or feature requests to bug-net-ipaddress-minimal at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-IPAddress-Minimal. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Net::IPAddress::Minimal

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

Copyright 2010 Tamir Lousky.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.