NAME

Sort::Key::IPv4 - sort IP v4 addresses

SYNOPSIS

  use Sort::Key::IPv4 qw(ipv4sort);
  my @data = qw(1.1.1.1 1.1.1.0 1.1.1.2 2.1.0.3);
  my @sorted = ipv4sort @data;
  use Sort::Key::IPv4 qw(ipv4keysort);
  my @sorted = ipv4keysort { $_->ip_address } @hosts;

DESCRIPTION

This module extends the Sort::Key family of modules to support sorting of IP v4 addresses and networks.

IPv4 addresses have to match the regular expression "/^\d+\.\d+\.\d+\.\d+$/". For instance 192.168.20.102.

IPv4 networks have to match the regular expression "/^\d+\.\d+\.\d+\.\d+\/\d+$/". For instance "10.2.4.0/24".

FUNCTIONS

The functions that can be imported from this module are:

ipv4sort @data: returns the IPv4 addresses in @data sorted.
ripv4sort @data: returns the IPv4 addresses in @data sorted in descending order.
ipv4keysort { CALC_KEY($_) } @data: returns the elements on @array sorted by the IPv4 addresses resulting from applying them "CALC_KEY".
ripv4keysort { CALC_KEY($_) } @data: is similar to "ipv4keysort" but sorts the elements in descending order.
ipv4sort_inplace @data
ripv4sort_inplace @data
ipv4keysort_inplace { CALC_KEY($_) } @data
ripv4keysort_inplace { CALC_KEY($_) } @data: these functions are similar respectively to "ipv4sort", "ripv4sort", "ipv4sortkey" and "ripv4sortkey", but they sort the array @data in place.
netipv4sort @data
rnetipv4sort @data
netipv4keysort { CALC_KEY($_) } @data
rnetipv4keysort { CALC_KEY($_) } @data
netipv4sort_inplace @data
rnetipv4sort_inplace @data
netipv4keysort_inplace { CALC_KEY($_) } @data
rnetipv4keysort_inplace { CALC_KEY($_) } @data: These functions sort network addreses (composed by an IP and a network length pair with and slash separatin them).
pack_ipv4 $key: converts the IPv4 value to a 32 bits unsigned integer.
pack_netipv4 $key: converts an string of the format "xxx.xxx.xxx.xxx/xxx" into two 32 bit unsigned numbers, the first representing the IP address and the second the network mask.

BUGS AND SUPPORT

Report bugs by email or using the CPAN RT system at <http://rt.cpan.org/>.

This module is hosted at GitHub: <http://github.com/salva/p5-Sort-Key-IPv4>.

COPYRIGHT AND LICENSE