annotate default/node_modules/javascript-natural-sort/README.md @ 0:1d038bc9b3d2 default tip

Up:default
author Liny <dev@neowd.com>
date Sat, 31 May 2025 09:21:51 +0800
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
1 ### Simple numerics
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
2
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
3 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
4 >>> ['10',9,2,'1','4'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
5 ['1',2,'4',9,'10']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
6 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
7
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
8 ### Floats
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
9
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
10 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
11 >>> ['10.0401',10.022,10.042,'10.021999'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
12 ['10.021999',10.022,'10.0401',10.042]
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
13 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
14
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
15 ### Float & decimal notation
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
16
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
17 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
18 >>> ['10.04f','10.039F','10.038d','10.037D'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
19 ['10.037D','10.038d','10.039F','10.04f']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
20 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
21
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
22 ### Scientific notation
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
23
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
24 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
25 >>> ['1.528535047e5','1.528535047e7','1.528535047e3'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
26 ['1.528535047e3','1.528535047e5','1.528535047e7']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
27 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
28
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
29 ### IP addresses
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
30
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
31 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
32 >>> ['192.168.0.100','192.168.0.1','192.168.1.1'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
33 ['192.168.0.1','192.168.0.100','192.168.1.1']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
34 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
35
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
36 ### Filenames
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
37
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
38 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
39 >>> ['car.mov','01alpha.sgi','001alpha.sgi','my.string_41299.tif'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
40 ['001alpha.sgi','01alpha.sgi','car.mov','my.string_41299.tif'
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
41 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
42
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
43 ### Dates
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
44
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
45 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
46 >>> ['10/12/2008','10/11/2008','10/11/2007','10/12/2007'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
47 ['10/11/2007', '10/12/2007', '10/11/2008', '10/12/2008']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
48 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
49
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
50 ### Money
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
51
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
52 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
53 >>> ['$10002.00','$10001.02','$10001.01'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
54 ['$10001.01','$10001.02','$10002.00']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
55 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
56
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
57 ### Movie Titles
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
58
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
59 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
60 >>> ['1 Title - The Big Lebowski','1 Title - Gattaca','1 Title - Last Picture Show'].sort(naturalSort)
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
61 ['1 Title - Gattaca','1 Title - Last Picture Show','1 Title - The Big Lebowski']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
62 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
63
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
64 ### By default - case-sensitive sorting
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
65
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
66 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
67 >>> ['a', 'B'].sort(naturalSort);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
68 ['B', 'a']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
69 ```
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
70
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
71 ### To enable case-insensitive sorting
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
72 ```javascript
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
73 >>> naturalSort.insensitive = true;
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
74 >>> ['a', 'B'].sort(naturalSort);
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
75 ['a', 'B']
1d038bc9b3d2 Up:default
Liny <dev@neowd.com>
parents:
diff changeset
76 ```