Объект Array

Предоставляет поддержку массивов expando, принадлежащих любому типу данных. Существует три формы конструктора Array.

function Array( [size : int] )
function Array( [... varargs : Object[]] ) 
function Array( [array : System.Array )

Аргументы

  • size
    Необязательный. Размер массива. Индексация массивов начинается с нуля: созданные элементы получают индексы от нуля до size -1.

  • varargs
    Необязательный. Типизированный массив, который содержит все параметры, передаваемые конструктору. Эти параметры используются в качестве первых элементов массива.

  • array
    Необязательный. Массив, который требуется скопировать в создаваемый массив.

Заметки

Если конструктору Array передается только один аргумент и этот аргумент является числом, то этот аргумент должен быть 32-разрядным целым числом (любым целым числом, не превышающим значение около четырех миллиардов). Передаваемое значение является размером массива. Если передаваемое значение меньше нуля или не является целым числом, возникает ошибка во время выполнения.

Конструктору Array можно передать переменную, принадлежащую типу данных System.Array. При этом создается массив JScript, который является копией входного массива. Массив System.Array может иметь только одно измерение.

Если конструктору Array передается одно значение, которое не является числом или массивом, для свойства length массива устанавливается значение 1 и значению первого элемента массива (элемента 0) присваивается единственный переданный аргумент. Если конструктору передается несколько аргументов, то для длины массива устанавливается количество аргументов и эти аргументы становятся первыми элементами нового массива.

Обратите внимание, что массивы JScript являются разреженными; это означает, что можно объявить массив с произвольным числом элементов, однако реально существуют только те элементы, которые содержат данные. Это позволяет сократить объем памяти, используемый для массива.

Объект Array object взаимодействует с типом данных System.Array. Поэтому объект Array может вызывать методы и свойства типа данных System.Array, а тип данных System.Array может вызывать методы и свойства объекта Array. Кроме того, объекты Array можно использовать в функциях, которые принимают параметры типа System.Array, и наоборот. Дополнительные сведения см. в разделе Члены массивов.

Если объект Array передается функции, которая принимает параметры типа System.Array, или методы System.Array вызываются из объекта Array, содержимое объекта Array копируется. Таким образом, исходный объект Array не может быть изменен с помощью методов System.Array или посредством передачи этого объекта в функцию, которая принимает параметры типа System.Array. Для типа данных System.Array можно вызывать только неразрушающие методы Array.

Совет

Объекты Array удобно использовать, если требуется создать универсальный стек или список элементов, а высокая производительность не является принципиальной.Во всех других ситуациях следует использовать типы данных типизированных массивов.Типизированный массив, который предоставляет примерно такие же функциональные возможности, что и объект Array, позволяет также обеспечить безопасность типов, повысить производительность и увеличить эффективность взаимодействия с другими языками.

Примечание

В JScript объект Array взаимодействует с типом данных System.Array платформы .NET Framework.Однако другие CLS-совместимые языки не могут использовать объект Array, поскольку он предоставляется только в JScript и не наследует от одного из типов .NET Framework.Поэтому при объявлении типов параметров и возвращаемых данных CLS-совместимых методов следует использовать не объект Array, а тип данных System.Array.Тем не менее, объект Array можно использовать для определения типов идентификаторов, которые не являются параметрами или возвращаемыми значениями.Дополнительные сведения см. в разделе Написание CLS-совместимого кода.

Пример

Доступ к отдельным элементам массива можно получить с помощью нотации [ ]. Пример.

var my_array = new Array();
for (var i = 0; i < 10; i++) {
   my_array[i] = i;
}
var x = my_array[4];

Поскольку индексация массивов Microsoft JScript начинается с нуля, завершающий оператор в предыдущем примере обращается к пятому элементу массива. Этот элемент содержит значение 4.

Свойства и методы

Свойства и методы объекта Array

Требования

Версия 2

См. также

Ссылки

Оператор new

Основные понятия

Типизированные массивы