Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Sort::Key::IPv4(3)    User Contributed Perl Documentation   Sort::Key::IPv4(3)

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.

SEE ALSO
       Sort::Key, Sort::Key::Maker

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
       Copyright A(C) 2007, 2009, 2012 by Salvador FandiA+-o,
       <sfandino@yahoo.com>.

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself, either Perl	version	5.8.8 or, at
       your option, any	later version of Perl 5	you may	have available.

perl v5.24.1			  2012-05-21		    Sort::Key::IPv4(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | BUGS AND SUPPORT | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Sort::Key::IPv4&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help