(examples-for sort
("sorts a list of numbers" (sort '(3 5 4 7 8 2)) (2 3 4 5 7 8)) ("sorts a list of syms" (sort '(c g d o a p b m e g a z m)) (a a b c d e g g m m o p z)) ("sorts a list of strings" (sort '("c" "g" "d" "o" "a" "p" "b" "m" "e" "g" "a" "z" "m")) ("a" "a" "b" "c" "d" "e" "g" "g" "m" "m" "o" "p" "z")))
(examples-for sort-by
("sorts a list of hashes by a specified key" (let hh (list { a 1 b 2 } { a 7 b 9 } { a 3 b 1 } { a 2 b 8 }) (pp (sort-by &a hh))) "({ a 1 b 2 } { a 2 b 8 } { a 3 b 1 } { a 7 b 9 })") ("sorts a list of strings according to their length" (sort-by len '("short" "very very very long" "somewhat long" "more medium" "min" "medium")) ("min" "short" "medium" "more medium" "somewhat long" "very very very long")) ("sort a list of strings according to their length even when some strings have the same length" (sort-by len '("short" "very long" "sport" "very song" "min" "max")) ("max" "min" "sport" "short" "very song" "very long")))
(examples-for safe-sort-by
("sorts a list of hashes by a specified key function, with default sort value if key function returns nil" (let hh (list { a 1 b 2 } { b 9 } { a 3 b 1 } { a nil b 8 }) (pp (safe-sort-by &a 99 hh))) "({ a 1 b 2 } { a 3 b 1 } { a nil b 8 } { b 9 })"))