summaryrefslogtreecommitdiff
path: root/desktop/node_modules/semver-compare/readme.markdown
blob: 927a369864d21864a7ae4f27dd6cbc05b5f6e87f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
# semver-compare

compare two semver version strings, returning -1, 0, or 1

The return value can be fed straight into `[].sort`.

[![build status](https://secure.travis-ci.org/substack/semver-compare.png)](http://travis-ci.org/substack/semver-compare)

# example

``` js
var cmp = require('semver-compare');
var versions = [
    '1.2.3',
    '4.11.6',
    '4.2.0',
    '1.5.19',
    '1.5.5',
    '4.1.3',
    '2.3.1',
    '10.5.5',
    '11.3.0'
];
console.log(versions.sort(cmp).join('\n'));
```

prints:

```
1.2.3
1.5.5
1.5.19
2.3.1
4.1.3
4.2.0
4.11.6
10.5.5
11.3.0
```

whereas the default lexicographic sort (`versions.sort()`) would be:

```
1.2.3
1.5.19
1.5.5
10.5.5
11.3.0
2.3.1
4.1.3
4.11.6
4.2.0
```

# methods

```
var cmp = require('semver-compare')
```

## cmp(a, b)

If the semver string `a` is greater than `b`, return `1`.
If the semver string `b` is greater than `a`, return `-1`.
If `a` equals `b`, return 0;

# install

With [npm](https://npmjs.org) do:

```
npm install semver-compare
```

# license

MIT