forked from webplatform/webplatform.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathindex.html
More file actions
158 lines (147 loc) · 7.36 KB
/
Copy pathindex.html
File metadata and controls
158 lines (147 loc) · 7.36 KB
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
<!DOCTYPE html>
<html lang="en" dir="ltr" class="client-nojs with-toc">
<head>
<meta charset="UTF-8" />
<title>sort · WebPlatform Docs</title>
<link rel="stylesheet" href="/assets/css/docs.css" />
<link rel="stylesheet" href="/assets/css/highlight.css" />
<link rel="shortcut icon" href="/favicon.ico" />
<meta name="viewport" content="width=device-width" />
<!--[if lt IE 7]><script src="/bower_components/ie7-js/lib/IE7.js"></script><![endif]-->
<!--[if lt IE 8]><script src="/bower_components/ie7-js/lib/IE8.js"></script><![endif]-->
<!--[if lt IE 9]><script src="/bower_components/ie7-js/lib/IE9.js"></script><![endif]-->
<!--[if lt IE 8]><link rel="stylesheet" href="/assets/css/ie7.css"><![endif]-->
<meta property="readiness" content="Ready to Use" />
<meta name="description" content="Sorts an Array." />
<script src="/bower_components/jquery/dist/jquery.min.js"></script>
<script src="/bower_components/vue/dist/vue.min.js"></script>
</head>
<body class="mediawiki ltr sitedir-ltr skin-webplatform action-view">
<div class="readiness-state Ready_to_Use"><p>This page is <a>Ready to Use</a></p></div>
<header id="mw-head" class="noprint">
<div class="container">
<div id="p-logo">
<a href="/" title="Visit the home page"></a>
</div>
</div>
</header>
<nav id="sitenav">
<div class="container">
<ul class="links">
<li><a href="/" class="active">THE DOCS</a></li>
<li><a href="/docs/Community">CONNECT</a></li>
<li><a href="/docs/WPD/Contributors_Guide/">CONTRIBUTE</a></li>
<li><a href="/blog/">BLOG</a></li>
</ul>
</div>
</nav>
<div id="siteNotice">
<div id="localNotice" dir="ltr" lang="en">
<div class="notice" style="margin:10px auto; position: relative; width: 90%; max-width: 950px;">
<div style="padding: 10px; border-radius: 4px; background-color: rgb(249, 247, 243); box-shadow: 0px 0px 1px rgb(167, 169, 172);">
<strong>Notice:</strong> The WebPlatform project, supported by various stewards between 2012 and 2015, has been <b>discontinued</b>. This site is now available on <a href="https://github.com/webplatform/webplatform.github.io/">github</a>.
</div>
</div>
</div>
</div>
<div id="content" class="mw-body">
<div class="container">
<a id="top"></a>
<div class="tool-area">
<div id="hierarchy-menu">
<ol id="breadcrumb-info" class="breadcrumbs">
<li><a href="/">DOCS</a></li>
<li><a href="/docs/javascript/">javascript</a></li><li><a href="/docs/javascript/Array/">Array</a></li><li><a href="/docs/javascript/Array/sort/">sort</a></li>
</ol>
</div>
</div>
<div id="page">
<div id="page-content">
<div id="main-content">
<h1>sort</h1>
<h2>Summary</h2>
<p>Sorts an Array.</p>
<h2>Syntax</h2>
<pre><code>sort( sortFunction )
</code></pre>
<dl>
<dt><strong>sortFunction</strong></dt>
<dd>Optional. The name of the function used to determine the order of the elements. If omitted, the elements are sorted in ascending, ASCII character order.
</dd>
</dl>
<h2>Return Value</h2>
<p>The sorted array.</p>
<h2>Examples</h2>
<p>The following example shows how to use the <strong>sort</strong> method.</p>
<pre><code class="js"><span class="hljs-keyword">var</span> a = <span class="hljs-keyword">new</span> <span class="hljs-built_in">Array</span>(<span class="hljs-number">4</span>, <span class="hljs-number">11</span>, <span class="hljs-number">2</span>, <span class="hljs-number">10</span>, <span class="hljs-number">3</span>, <span class="hljs-number">1</span>);
<span class="hljs-keyword">var</span> b = a.sort();
<span class="hljs-built_in">document</span>.write(b);
<span class="hljs-built_in">document</span>.write(<span class="hljs-string">"<br/>"</span>);
<span class="hljs-comment">// This is ASCII character order.</span>
<span class="hljs-comment">// Output: 1,10,11,2,3,4)</span>
<span class="hljs-comment">// Sort the array elements with a function that compares array elements.</span>
b = a.sort(CompareForSort);
<span class="hljs-built_in">document</span>.write(b);
<span class="hljs-built_in">document</span>.write(<span class="hljs-string">"<br/>"</span>);
<span class="hljs-comment">// Output: 1,2,3,4,10,11.</span>
<span class="hljs-comment">// Sorts array elements in ascending order numerically.</span>
<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">CompareForSort</span>(<span class="hljs-params">first, second</span>)
</span>{
<span class="hljs-keyword">if</span> (first == second)
<span class="hljs-keyword">return</span> <span class="hljs-number">0</span>;
<span class="hljs-keyword">if</span> (first < second)
<span class="hljs-keyword">return</span> -<span class="hljs-number">1</span>;
<span class="hljs-keyword">else</span>
<span class="hljs-keyword">return</span> <span class="hljs-number">1</span>;
}
</code></pre>
<h2>Remarks</h2>
<p>The <strong>sort</strong> method sorts the <strong>Array</strong> object in place; no new <strong>Array</strong> object is created during execution.</p>
<p>If you supply a function in the sortFunction argument, it must return one of the following values:</p>
<ul>
<li>A negative value if the first argument passed is less than the second argument.</li>
<li>Zero if the two arguments are equivalent.</li>
<li>A positive value if the first argument is greater than the second argument.</li>
</ul>
<h2>See also</h2>
<h3>Specification</h3>
<p><a href="http://www.ecma-international.org/ecma-262/5.1/#sec-15.4.4.11">15.4.4.11 Array.prototype.sort (comparefn)</a> ECMAScript® Language Specification Standard ECMA-262 5.1 Edition / June 2011</p>
<h2>Attributions</h2>
<ul>
<li><p>Microsoft Developer Network: <a href="http://msdn.microsoft.com/en-us/library/ie/4b4fbfhk(v=vs.94).aspx">Article</a></p>
</li>
</ul>
</div>
<div class="topics-nav">
<ul>
<li><a href="/docs/Beginners">Beginners</a></li>
<li><a href="/docs/concepts">Concepts</a></li>
<li><a href="/docs/html">HTML</a></li>
<li><a href="/docs/css">CSS</a></li>
<li><a href="/docs/concepts/accessibility">Accessibility</a></li>
<li><a href="/docs/javascript">JavaScript</a></li>
<li><a href="/docs/dom">DOM</a></li>
<li><a href="/docs/svg">SVG</a></li>
</ul>
</div>
<div class="clear"></div>
</div>
</div>
</div>
</div>
<footer id="mw-footer">
<div class="container">
<div id="footer-wordmark">
<a href="https://github.com/webplatform/docs/blob/master/LICENSE.md" class="license">
<img src="/assets/cc-by-black.svg" width="120" height="42" alt="Content available under CC-BY, except where otherwise noted.">
</a>
<a href="/"><span id="footer-title">WebPlatform<span id="footer-title-light">.org</span></span></a>
</div>
<!-- ul class="stewards">
<li class="steward-w3c"><a href="/stewards/w3c">W3C</a></li>
</ul -->
</div>
</footer>
<script src="/assets/js/docs.js"></script>
</body>
</html>