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

FreeBSD Manual Pages

  
 
  

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

NAME
       Sort::Versions -	a perl 5 module	for sorting of revision-like numbers

SYNOPSIS
	       use Sort::Versions;
	       @l = sort { versioncmp($a, $b) }	qw( 1.2	1.2.0 1.2a.0 1.2.a 1.a 02.a );

	       ...

	       use Sort::Versions;
	       print 'lower' if	versioncmp('1.2', '1.2a') == -1;

	       ...

	       use Sort::Versions;
	       %h = (1 => 'd', 2 => 'c', 3 => 'b', 4 =>	'a');
	       @h = sort { versioncmp($h{$a}, $h{$b}) }	keys %h;

DESCRIPTION
       Sort::Versions allows easy sorting of mixed non-numeric and numeric
       strings,	like the 'version numbers' that	many shared library systems
       and revision control packages use. This is quite	useful if you are
       trying to deal with shared libraries. It	can also be applied to
       applications that intersperse variable-width numeric fields within
       text. Other applications	can undoubtedly	be found.

       For an explanation of the algorithm, it's simplest to look at these
       examples:

	 1.1   <  1.2
	 1.1a  <  1.2
	 1.1   <  1.1.1
	 1.1   <  1.1a
	 1.1.a <  1.1a
	 1     <  a
	 a     <  b
	 1     <  2
	 1.1-3 <  1.1-4
	 1.1-5 <  1.1.6

       More precisely (but less	comprehensibly), the two strings are treated
       as subunits delimited by	periods	or hyphens. Each subunit can contain
       any number of groups of digits or non-digits. If	digit groups are being
       compared	on both	sides, a numeric comparison is used, otherwise a ASCII
       ordering	is used. A group or subgroup with more units will win if all
       comparisons are equal.  A period	binds digit groups together more
       tightly than a hyphen.

       Some packages use a different style of version numbering: a simple real
       number written as a decimal. Sort::Versions has limited support for
       this style: when	comparing two subunits which are both digit groups, if
       either subunit has a leading zero, then both are	treated	like digits
       after a decimal point. So for example:

	 0002  <  1
	 1.06  <  1.5

       This won't always work, because there won't always be a leading zero in
       real-number style version numbers. There	is no way for Sort::Versions
       to know which style was intended. But a lot of the time it will do the
       right thing. If you are making up version numbers, the style with
       (possibly) more than one	dot is the style to use.

USAGE
       The function "versioncmp()" takes two arguments and compares them like
       "cmp".  With perl 5.6 or	later, you can also use	this function directly
       in sorting:

	   @l =	sort versioncmp	qw(1.1 1.2 1.0.3);

       The function "versions()" can be	used directly as a sort	function even
       on perl 5.005 and earlier, but its use is deprecated.

SEE ALSO
       version,	CPAN::Version which is part of the CPAN	distribution.

REPOSITORY
       <https://github.com/neilb/Sort-Versions>

AUTHOR
       Ed Avis <ed@membled.com>	and Matt Johnson <mwj99@doc.ic.ac.uk> for
       recent releases;	the original author is Kenneth J. Albanowski
       <kjahds@kjahds.com>.  Thanks to Hack KampbjA,rn and Slaven Rezic	for
       patches and bug reports.

COPYRIGHT AND LICENSE
       This software is	copyright (c) 1996 by Kenneth J. Albanowski.

       This is free software; you can redistribute it and/or modify it under
       the same	terms as the Perl 5 programming	language system	itself.

perl v5.32.1			  2015-12-13		     Sort::Versions(3)

NAME | SYNOPSIS | DESCRIPTION | USAGE | SEE ALSO | REPOSITORY | AUTHOR | COPYRIGHT AND LICENSE

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

home | help