sort-numbers.js


Sort numbers in ascending or descending order

``javascript
sortNumbers([0.45, Infinity, -2]); //=> [-2, 0.45, Infinity]
sortNumbers.desc([ 0.45, Infinity, -2]); //=> [Infinity, 0.45, -2]
`

Installation

$3

#### npm
`sh
npm install sort-numbers
`

#### Bower

`sh
bower install sort-numbers
`

#### Duo

`javascript
var sortNumbers = require('shinnn/sort-numbers.js');
`

$3

Download the script file directly.

API

$3

numbers: Array of Number without NaN
Return: Array of Number

It returns the array numerically sorted in ascending order.

Note that Array.prototype.sort works as lexical sort by default.

`javascript
var arr = [100, -2, -Infinity];

sortNumbers(arr); //=> [ -Infinity, -2, 100 ]
arr.sort(); //=> [ -2, -Infinity, 100 ]
`

It returns an empty array when the argument is an empty array.

It throws a TypeError when the array contains non-number values or NaN.

`javascript
sortNumbers(new Array()); //=> []

sortNumbers([1, '2', 3]); // throw a type error
sortNumbers([NaN]); // throw a type error
`

$3

numbers: Array of Number without NaN
Return: Array of Number

It returns the array numerically sorted in descending order.

`javascript
var arr = [0, 1, 2 ,3];

sortNumbers.desc(arr) //=> [3, 2, 1, 0]
sortNumbers(arr) //=> [0, 1, 2, 3]
`

$3

An alias to sortNumbers.

CLI

You can use this module as a CLI tool by installing it globally.

`sh
npm install -g sort-numbers
`

$3

`sh
Usage: sort-numbers [ ...]

Options:
--desc, -d Sort numbers in descending order (ascending order by default)
--help, -h Print usage information
--version, -v Print version
`

$3

`sh
sort-numbers -23 7 -Infinity Infinity
`

yields:

`sh
-Infinity,-23,7,Infinity
``

License

Copyright (c) 2014 - 2015 Shinnosuke Watanabe

Licensed under the MIT License.