This module exports two functions, 'nsort' and 'ncmp'; they are used in implementing my idea of a "natural sorting" algorithm. Under natural sorting, numeric substrings are compared numerically, and other word-characters are compared lexically.
This is the way I define natural sorting:
Non-numeric word-character substrings are sorted lexically, case-insensitively: "Foo" comes between "fish" and "fowl".
Numeric substrings are sorted numerically: "100" comes after "20", not before.
\W substrings (neither words-characters nor digits) are ignored.
Our use of \w, \d, \D, and \W is locale-sensitive: Sort::Naturally uses a 'use locale' statement.
When comparing two strings, where a numeric substring in one place is not up against a numeric substring in another, the non-numeric always comes first. This is fudged by reading pretending that the lack of a number substring has the value -1, like so:
foo => "foo", -1 foobar => "foo", -1, "bar" foo13 => "foo", 13, foo13xyz => "foo", 13, "xyz"
That's so that "foo" will come before "foo13", which will come before "foobar".
The start of a string is exceptional: leading non-\W (non-word, non-digit) components are are ignored, and numbers come before letters.
I define "numeric substring" just as sequences matching m/\d+/ -- scientific notation, commas, decimals, etc., are not seen. If your data has thousands separators in numbers ("20,000 Leagues Under The Sea" or "20.000 lieues sous les mers"), consider stripping them before feeding them to 'nsort' or 'ncmp'.
Package Version | Update ID | Released | Package Hub Version | Platforms | Subpackages |
---|---|---|---|---|---|
1.03-bp156.3.1 info | GA Release | 2023-07-22 | 15 SP6 |
|
|
1.03-bp155.2.10 info | GA Release | 2023-05-17 | 15 SP5 |
|
|
1.03-bp154.1.23 info | GA Release | 2022-05-09 | 15 SP4 |
|
|
1.03-bp153.1.16 info | GA Release | 2021-03-06 | 15 SP3 |
|
|
1.03-bp152.3.19 info | GA Release | 2020-04-16 | 15 SP2 |
|
|
1.03-bp151.3.1 info | GA Release | 2019-07-16 | 15 SP1 |
|
|
1.03-bp151.2.14 info | GA Release | 2019-05-18 | 15 SP1 |
|
|
1.03-bp150.2.4 info | GA Release | 2018-07-30 | 15 |
|
|