#sorting #natural #order #human #string #aka #txt

nightly natural_sort

Rust implementation of natural sorting (aka "human sorting")

1 unstable release

Uses old Rust 2015

0.0.1 Dec 9, 2014

#22 in #aka

8KB
132 lines

Natural-Sort

A Rust library that implements "natural sorting" (aka "human sorting"). See Jeff Atwood's Sorting for Humans: Natural Sort Order.


lib.rs:

natural_sort is a crate that deals with sorting strings using "natural sorting", (also known as "human sorting").

With normal string-based searching, strings are always compared alphabetically:

let mut files = ["file2.txt", "file11.txt", "file1.txt"];
files.sort();

// "file11.txt" comes before "file2.txt" because the string "11" comes
// before the string "2" in the dictionary.
assert_eq!(files, ["file1.txt", "file11.txt", "file2.txt"]);

This crate provides a function natural_sort which will order strings numerically when doing so makes sense:

use natural_sort::natural_sort;

let mut files = ["file1.txt", "file11.txt", "file2.txt"];
natural_sort(&mut files);

// Here, "file11.txt" comes last because `natural_sort` saw that there was a
// number inside the string, and did a numerical, rather than lexical,
// comparison.
assert_eq!(files, ["file1.txt", "file2.txt", "file11.txt"]);

Human-comparable strings can be created directly using natural_sort::HumanString::from_str.

No runtime deps