library__sort

#sort

Synopsis

Functions to sort lists of elements.

The functions in this library come in three versions:

• simple sort: the list is sorted, duplicates and equivalent elements are kept;
• sort and remove duplicates: the list is sorted and duplicates are removed, however equivalent elements are kept (modifier: "u");
• sort and remove equivalents: the list is sorted and equivalent elements are removed (modifier: "n").

Functons

comp

sort:comp(list, comparator)

Evaluates list as a list of elements, then sorts the result according to the expression comparator. The comparator expression is evaluated as an integer and must return a number below zero (lower than), zero (equals) or above zero (greater than).

dval

sort:dval(list, value)

Evaluates list as a list of elements, then evaluates value as a double for each element. Returns the list sorted by value.

ival

sort:ival(list, value)

Evaluates list as a list of elements, then evaluates value as an integer for each element. Returns the list sorted by value.

ncomp

sort:ncomp(list, comparator)

Same as comp, remove equivalents.

ndval

sort:ndval(list, value)

Same as dval, remove equivalents.

nival

sort:nival(list, value)

Same as ival, remove equivalents.

nsval

sort:nsval(list, value)

Same as sval, remove equivalents.

reverse

sort:reverse(list)

Evaluates list as a list of elements and returns this list reversed.

sval

sort:sval(list, value)

Evaluates list as a list of elements, then evaluates value as a string for each element. Returns the list sorted by value (lexical sort).

ucomp

sort:ucomp(list, comparator)

Same as comp, remove duplicates.

udval

sort:udval(list, value)

Same as dval, remove duplicates.

uival

sort:uival(list, value)

Same as ival, remove duplicates.

usval

sort:usval(list, value)

Same as sval, remove duplicates.