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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
|
---
title: Int32Array
slug: Web/JavaScript/Reference/Global_Objects/Int32Array
translation_of: Web/JavaScript/Reference/Global_Objects/Int32Array
---
<div>{{JSRef}}</div>
<p>Объект <strong><code>Int32Array</code></strong> представляет типизированный массив 32-битных целых чисел со знаком с дополнением до двух с платформо-зависимым порядком байт. Если необходим контроль за порядком байт, то вместо этого объекта используйте <a class="new" href="https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/DataView" rel="nofollow" title="Документация об этом ещё не написана; пожалуйста, поспособствуйте её написанию!"><code>DataView</code></a>. Содержимое инициализируется значением <code>0</code>. Создав экземпляр <strong><code>Int32Array</code></strong>, можно получить доступ к элементам массива, используя методы объекта или стандартный синтаксис доступа к элементу массива по его индексу (с помощью скобочной нотации).</p>
<h2 id="Синтаксис">Синтаксис</h2>
<pre class="syntaxbox">new Int32Array(); // добавлено в ES2017
new Int32Array(length);
new Int32Array(typedArray);
new Int32Array(object);
new Int32Array(buffer [, byteOffset [, length]]);</pre>
<p>Для получения дополнительной информации о синтаксисе конструктора и параметрах <em><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#Syntax">TypedArray</a></em>.</p>
<h2 id="Свойства">Свойства</h2>
<dl>
<dt>{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int32Array.BYTES_PER_ELEMENT")}}</dt>
<dd>Возвращает числовое значение размера элемента. <code>4</code> в случае с <code>Int32Array</code>.</dd>
<dt>Int32Array.length</dt>
<dd>Свойство статического размера, значение которого равно 3. Для актуального размера (количества элементов), смотрите {{jsxref("TypedArray.prototype.length", "Int32Array.prototype.length")}}.</dd>
<dt>{{jsxref("TypedArray.name", "Int32Array.name")}}</dt>
<dd>Возвращает строковое значение названия конструктора. В случае с типом <code>Int32Array</code>: "Int32Array".</dd>
<dt>{{jsxref("TypedArray.prototype", "Int32Array.prototype")}}</dt>
<dd>Прототип для <em>TypedArray</em> объектов.</dd>
</dl>
<h2 id="Методы">Методы</h2>
<dl>
<dt>{{jsxref("TypedArray.from", "Int32Array.from()")}}</dt>
<dd>Создаёт новый <code>Int32Array</code> из массивоподобного или итеративного объекта. Смотрите также {{jsxref("Array.from()")}}.</dd>
<dt>{{jsxref("TypedArray.of", "Int32Array.of()")}}</dt>
<dd>Создаёт новый <code>Int32Array</code> with a variable number of arguments. See also {{jsxref("Array.of()")}}.</dd>
</dl>
<h2 id="Int32Array_прототип"><code>Int32Array</code> прототип</h2>
<p>All <code>Int32Array</code> objects inherit from {{jsxref("TypedArray.prototype", "%TypedArray%.prototype")}}.</p>
<h3 id="Свойства_2">Свойства</h3>
<dl>
<dt><code>Int32Array.prototype.constructor</code></dt>
<dd>Returns the function that created an instance's prototype. This is the <code>Int32Array</code> constructor by default.</dd>
<dt>{{jsxref("TypedArray.prototype.buffer", "Int32Array.prototype.buffer")}} {{readonlyInline}}</dt>
<dd>Returns the {{jsxref("ArrayBuffer")}} referenced by the <code>Int32Array</code> Fixed at construction time and thus <strong>read only</strong>.</dd>
<dt>{{jsxref("TypedArray.prototype.byteLength", "Int32Array.prototype.byteLength")}} {{readonlyInline}}</dt>
<dd>Returns the length (in bytes) of the <code>Int32Array</code> from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus <strong>read only.</strong></dd>
<dt>{{jsxref("TypedArray.prototype.byteOffset", "Int32Array.prototype.byteOffset")}} {{readonlyInline}}</dt>
<dd>Returns the offset (in bytes) of the <code>Int32Array</code> from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus <strong>read only.</strong></dd>
<dt>{{jsxref("TypedArray.prototype.length", "Int32Array.prototype.length")}} {{readonlyInline}}</dt>
<dd>Returns the number of elements hold in the <code>Int32Array</code>. Fixed at construction time and thus <strong>read only.</strong></dd>
</dl>
<h3 id="Методы_2">Методы</h3>
<dl>
<dt>{{jsxref("TypedArray.copyWithin", "Int32Array.prototype.copyWithin()")}}</dt>
<dd>Copies a sequence of array elements within the array. See also {{jsxref("Array.prototype.copyWithin()")}}.</dd>
<dt>{{jsxref("TypedArray.entries", "Int32Array.prototype.entries()")}}</dt>
<dd>Returns a new <code>Array Iterator</code> object that contains the key/value pairs for each index in the array. See also {{jsxref("Array.prototype.entries()")}}.</dd>
<dt>{{jsxref("TypedArray.every", "Int32Array.prototype.every()")}}</dt>
<dd>Tests whether all elements in the array pass the test provided by a function. See also {{jsxref("Array.prototype.every()")}}.</dd>
<dt>{{jsxref("TypedArray.fill", "Int32Array.prototype.fill()")}}</dt>
<dd>Fills all the elements of an array from a start index to an end index with a static value. See also {{jsxref("Array.prototype.fill()")}}.</dd>
<dt>{{jsxref("TypedArray.filter", "Int32Array.prototype.filter()")}}</dt>
<dd>Creates a new array with all of the elements of this array for which the provided filtering function returns true. See also {{jsxref("Array.prototype.filter()")}}.</dd>
<dt>{{jsxref("TypedArray.find", "Int32Array.prototype.find()")}}</dt>
<dd>Returns the found value in the array, if an element in the array satisfies the provided testing function or <code>undefined</code> if not found. See also {{jsxref("Array.prototype.find()")}}.</dd>
<dt>{{jsxref("TypedArray.findIndex", "Int32Array.prototype.findIndex()")}}</dt>
<dd>Returns the found index in the array, if an element in the array satisfies the provided testing function or -1 if not found. See also {{jsxref("Array.prototype.findIndex()")}}.</dd>
<dt>{{jsxref("TypedArray.forEach", "Int32Array.prototype.forEach()")}}</dt>
<dd>Calls a function for each element in the array. See also {{jsxref("Array.prototype.forEach()")}}.</dd>
<dt>{{jsxref("TypedArray.includes", "Int32Array.prototype.includes()")}} {{experimental_inline}}</dt>
<dd>Determines whether a typed array includes a certain element, returning <code>true</code> or <code>false</code> as appropriate. See also {{jsxref("Array.prototype.includes()")}}.</dd>
<dt>{{jsxref("TypedArray.indexOf", "Int32Array.prototype.indexOf()")}}</dt>
<dd>Returns the first (least) index of an element within the array equal to the specified value, or -1 if none is found. See also {{jsxref("Array.prototype.indexOf()")}}.</dd>
<dt>{{jsxref("TypedArray.join", "Int32Array.prototype.join()")}}</dt>
<dd>Joins all elements of an array into a string. See also {{jsxref("Array.prototype.join()")}}.</dd>
<dt>{{jsxref("TypedArray.keys", "Int32Array.prototype.keys()")}}</dt>
<dd>Returns a new <code>Array Iterator</code> that contains the keys for each index in the array. See also {{jsxref("Array.prototype.keys()")}}.</dd>
<dt>{{jsxref("TypedArray.lastIndexOf", "Int32Array.prototype.lastIndexOf()")}}</dt>
<dd>Returns the last (greatest) index of an element within the array equal to the specified value, or -1 if none is found. See also {{jsxref("Array.prototype.lastIndexOf()")}}.</dd>
<dt>{{jsxref("TypedArray.map", "Int32Array.prototype.map()")}}</dt>
<dd>Creates a new array with the results of calling a provided function on every element in this array. See also {{jsxref("Array.prototype.map()")}}.</dd>
<dt>{{jsxref("TypedArray.move", "Int32Array.prototype.move()")}} {{non-standard_inline}} {{unimplemented_inline}}</dt>
<dd>Former non-standard version of {{jsxref("TypedArray.copyWithin", "Int32Array.prototype.copyWithin()")}}.</dd>
<dt>{{jsxref("TypedArray.reduce", "Int32Array.prototype.reduce()")}}</dt>
<dd>Apply a function against an accumulator and each value of the array (from left-to-right) as to reduce it to a single value. See also {{jsxref("Array.prototype.reduce()")}}.</dd>
<dt>{{jsxref("TypedArray.reduceRight", "Int32Array.prototype.reduceRight()")}}</dt>
<dd>Apply a function against an accumulator and each value of the array (from right-to-left) as to reduce it to a single value. See also {{jsxref("Array.prototype.reduceRight()")}}.</dd>
<dt>{{jsxref("TypedArray.reverse", "Int32Array.prototype.reverse()")}}</dt>
<dd>Reverses the order of the elements of an array — the first becomes the last, and the last becomes the first. See also {{jsxref("Array.prototype.reverse()")}}.</dd>
<dt>{{jsxref("TypedArray.set", "Int32Array.prototype.set()")}}</dt>
<dd>Stores multiple values in the typed array, reading input values from a specified array.</dd>
<dt>{{jsxref("TypedArray.slice", "Int32Array.prototype.slice()")}}</dt>
<dd>Extracts a section of an array and returns a new array. See also {{jsxref("Array.prototype.slice()")}}.</dd>
<dt>{{jsxref("TypedArray.some", "Int32Array.prototype.some()")}}</dt>
<dd>Returns true if at least one element in this array satisfies the provided testing function. See also {{jsxref("Array.prototype.some()")}}.</dd>
<dt>{{jsxref("TypedArray.sort", "Int32Array.prototype.sort()")}}</dt>
<dd>Sorts the elements of an array in place and returns the array. See also {{jsxref("Array.prototype.sort()")}}.</dd>
<dt>{{jsxref("TypedArray.subarray", "Int32Array.prototype.subarray()")}}</dt>
<dd>Returns a new <code>Int32Array</code> from the given start and end element index.</dd>
<dt>{{jsxref("TypedArray.values", "Int32Array.prototype.values()")}}</dt>
<dd>Returns a new <code>Array Iterator</code> object that contains the values for each index in the array. See also {{jsxref("Array.prototype.values()")}}.</dd>
<dt>{{jsxref("TypedArray.toLocaleString", "Int32Array.prototype.toLocaleString()")}}</dt>
<dd>Returns a localized string representing the array and its elements. See also {{jsxref("Array.prototype.toLocaleString()")}}.</dd>
<dt>{{jsxref("TypedArray.toString", "Int32Array.prototype.toString()")}}</dt>
<dd>Returns a string representing the array and its elements. See also {{jsxref("Array.prototype.toString()")}}.</dd>
<dt>{{jsxref("TypedArray.@@iterator", "Int32Array.prototype[@@iterator]()")}}</dt>
<dd>Returns a new <code>Array Iterator</code> object that contains the values for each index in the array.</dd>
</dl>
<h2 id="Примеры">Примеры</h2>
<p>Разные способы создания <code>Int32Array</code>:</p>
<pre class="brush: js">// С указанием размера
var int32 = new Int32Array(2);
int32[0] = 42;
console.log(int32[0]); // 42
console.log(int32.length); // 2
console.log(int32.BYTES_PER_ELEMENT); // 4
// Из массива (Array)
var arr = new Int32Array([21,31]);
console.log(arr[1]); // 31
// Из другого типизированного массива (TypedArray)
var x = new Int32Array([21, 31]);
var y = new Int32Array(x);
console.log(y[0]); // 21
// Из ArrayBuffer
var buffer = new ArrayBuffer(16);
var z = new Int32Array(buffer, 0, 4);
// Из итерируемого объекта (iterable)
var iterable = function*(){ yield* [1,2,3]; }();
var int32 = new Int32Array(iterable);
// Int32Array[1, 2, 3]
</pre>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Статус</th>
<th scope="col">Комментарии</th>
</tr>
<tr>
<td>{{SpecName('Typed Array')}}</td>
<td>{{Spec2('Typed Array')}}</td>
<td>Superseded by ECMAScript 2015.</td>
</tr>
<tr>
<td>{{SpecName('ES2015', '#table-49', 'TypedArray constructors')}}</td>
<td>{{Spec2('ES2015')}}</td>
<td>Initial definition in an ECMA standard. Specified that <code>new</code> is required.</td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#table-49', 'TypedArray constructors')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td>ECMAScript 2017 changed the <code>Int32Array</code> constructor to use the <code>ToIndex</code> operation and allows constructors with no arguments.</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{Compat("javascript.builtins.Int32Array")}}</p>
<h2 id="Compatibility_notes">Compatibility notes</h2>
<p>Начиная с ECMAScript 2015, конструкторы <code>Int32Array</code> требуют оператор {{jsxref("Operators/new", "new")}}. Вызов <code>Int32Array</code> конструктора как функцию без оператора <code>new</code>, вызовет ошибку {{jsxref("TypeError")}}.</p>
<pre class="brush: js example-bad">var dv = Int32Array([1, 2, 3]);
// TypeError: calling a builtin Int32Array constructor
// without new is forbidden</pre>
<pre class="brush: js example-good">var dv = new Int32Array([1, 2, 3]);</pre>
<h2 id="See_also">See also</h2>
<ul>
<li><a href="/en-US/docs/Web/JavaScript/Typed_arrays" title="en/JavaScript typed arrays">JavaScript typed arrays</a></li>
<li>{{jsxref("ArrayBuffer")}}</li>
<li>{{jsxref("DataView")}}</li>
</ul>
|
