Vector  - AS3

Указывает, можно ли изменить свойство length вектора. Если присвоено значение true, свойство length невозможно изменить. Это означает, что если свойству fixed присвоено значение true, следующие операции не разрешены:

• установка свойства length напрямую;
• присвоение значения позиции индекса length;
• вызов метода, изменяющего свойство length, включая
  • pop(),
  • push(),
  • shift(),
  • unshift(),
  • splice() (если вызов метода splice() приводит к изменению length вектора).

Диапазон действительных индексов, которые доступны в векторе. Экземпляр вектора обладает позициями индекса вплоть до значения length, но не включает само это значение.

Каждому элементу вектора всегда присваивается либо экземпляр базового типа, либо значение null. Когда свойству length присваивается значение, которое превышает предыдущее значение, создаются дополнительные элементы, которые заполняются значениями по умолчанию, соответствующими базовому типу (null для ссылочных типов).

Когда свойству length присваивается значение, которое меньше предыдущего значения, из вектора удаляются все значения с позициями индекса, которые превышают или равняются новому значению length.

Создает вектор с указанным базовым типом.

При вызове конструктора Vector.<T>() укажите базовый тип с помощью синтаксиса параметра типа. Синтаксис параметра типа представляет собой последовательность, состоящую из точки (.), открывающей угловой скобки (<), имени класса и закрывающей угловой скобки (>), как показано в примере:

     var v:Vector.<String> = new Vector.<String>();
     

Чтобы создать экземпляр Vector на основе экземпляра Array или другого экземпляра Vector (который, например, имеет другой базовый тип), воспользуйтесь глобальной функцией Vector().

Чтобы создать предварительно заполненный экземпляр Vector, используйте следующий синтаксис вместо перечисленных ниже параметров.

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

К данному синтаксису относится следующая информация.

• Это поддерживается во Flash Professional CS5, Flash Builder 4 и Flex 4, а также в более поздних версиях этих приложений.
• Запятую в конце ставить не обязательно.
• Пустые элементы в массиве не поддерживаются; инструкция, такая как var v:Vector.<int> = new <int>[0,,2,] выдает ошибку компилятора.
• Для экземпляра Vector нельзя задать длину по умолчанию. Его длина равна числу элементов в списке инициализации.
• Для экземпляра Vector нельзя задать фиксированную длину. Вместо этого следует использовать свойство fixed.
• Использование значений, не соответствующих заданному типу, может привести к ошибкам или потере данных. Например:

     var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
     trace(v[0]); //returns 4 when not running in strict mode
     

Связанные элементы API

Указанные в списке параметров векторы сцепляются с элементами в этом векторе, и создается новый вектор. Векторы в списке параметров и этот вектор должны относиться к одному базовому типу (подтипу). Если параметры не передаются, возвращенный вектор дублирует исходный вектор (как поверхностный клон).

Параметры

Выполняет тестовую функцию для каждого элемента вектора, пока не будет достигнут элемент, возвращающий значение false для заданной функции. Этот метод используется для того, чтобы определить, все ли элементы вектора соответствуют критерию (например, их значения должны быть меньше определенного числа).

Второй параметр этого метода, thisObject, должен иметь значение null, если первый параметр, callback, завершает метод. Чаще всего данный метод используется именно так.

Однако предположим, что вы создаете функцию для кадра на основной временной шкале с помощью Flash Professional, но хотите, чтобы она вызывалась в другом контексте this:

    function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Допустим, что используется метод every() по отношению к вектору myVector:

    myVector.every(myFunction, someObject);
    

Поскольку функция myFunction принадлежит к основному классу этого SWF-файла, ее нельзя выполнить с другим контекстом this. Среды выполнения Flash выдают исключение при выполнении этого кода. Этой ошибки при выполнении можно избежать, присвоив функцию переменной следующим образом:

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

Параметры

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

Связанные элементы API

Выполняет тестовую функцию для каждого элемента вектора и формирует новый вектор из всех элементов, возвращающих значение true для заданной функции. Если элемент возвращает значение false, он не включается в получившийся вектор. Базовый тип возвращаемого вектора совпадает с базовым типом вектора, по которому вызывается метод.

Второй параметр этого метода, thisObject, должен иметь значение null, если первый параметр, callback, завершает метод. Чаще всего данный метод используется именно так.

Однако предположим, что вы создаете функцию для кадра на основной временной шкале с помощью Flash Professional, но хотите, чтобы она вызывалась в другом контексте this:

     function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Допустим, что используется метод filter() по отношению к вектору myVector:

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

Поскольку функция myFunction принадлежит к основному классу этого SWF-файла, ее нельзя выполнить с другим контекстом this. Среды выполнения Flash выдают исключение при выполнении этого кода. Этой ошибки при выполнении можно избежать, присвоив функцию переменной следующим образом:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

Параметры

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

Связанные элементы API

Выполняет функцию для каждого элемента вектора.

Второй параметр этого метода, thisObject, должен иметь значение null, если первый параметр, callback, завершает метод. Чаще всего данный метод используется именно так.

Однако предположим, что вы создаете функцию для кадра на основной временной шкале с помощью Flash Professional, но хотите, чтобы она вызывалась в другом контексте this:

     function myFunction(item:T, index:int, vector:Vector.<T>):void {
        // your code here
     }
     

Допустим, что используется метод forEach() по отношению к вектору myVector:

     myVector.forEach(myFunction, someObject);
     

Поскольку функция myFunction принадлежит к основному классу этого SWF-файла, ее нельзя выполнить с другим контекстом this. Среды выполнения Flash выдают исключение при выполнении этого кода. Этой ошибки при выполнении можно избежать, присвоив функцию переменной следующим образом:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

Параметры

function callback(item:T, index:int, vector:Vector.<T>):void;

Выполняет поиск элемента в векторе и возвращает позицию индекса элемента. Этот элемент сравнивается с элементами вектора с помощью строгого равенства (===).

Параметры

Связанные элементы API

Вставьте один элемент в вектор. Этот метод изменяет вектор, не создавая копии.

Параметры

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

Параметры

Связанные элементы API

Поиск элемента в векторе, выполняемый в обратном направлении от указанной позиции индекса, и возврат позиции индекса совпадающего элемента. Этот элемент сравнивается с элементами вектора с помощью строгого равенства (===).

Параметры

Связанные элементы API

Выполняет функцию, относящуюся к каждому элементу вектора, и возвращает новый вектор, состоящий из элементов, соответствующих результатам вызова функции, которая выполняется для каждого элемента данного вектора. Итоговый вектор имеет тот же базовый тип и length, что и исходный. Элемент с индексом i в получаемом векторе является результатом вызова элемента с индексом i в исходном векторе.

Второй параметр этого метода, thisObject, должен иметь значение null, если первый параметр, callback, завершает метод. Чаще всего данный метод используется именно так.

Однако предположим, что вы создаете функцию для кадра на основной временной шкале с помощью Flash Professional, но хотите, чтобы она вызывалась в другом контексте this:

     function myFunction(item:Object, index:int, vector:Vector.<T>):T {
        // your code here
     }
     

Допустим, что используется метод map() по отношению к вектору myVector:

     myVector.map(myFunction, someObject);
     

Поскольку функция myFunction принадлежит к основному классу этого SWF-файла, ее нельзя выполнить с другим контекстом this. Среды выполнения Flash выдают исключение при выполнении этого кода. Этой ошибки при выполнении можно избежать, присвоив функцию переменной следующим образом:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

Параметры

function callback(item:T, index:int, vector:Vector.<T>):T;

Связанные элементы API

Удаляет последний элемент из вектора и возвращает его. Значение свойства length этого вектора уменьшается на 1 при вызове этой функции.

Связанные элементы API

Добавляет один или несколько элементов в конец вектора и возвращает новую длину вектора.

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

Параметры

Связанные элементы API

Удалите один элемент из вектора. Этот метод изменяет вектор, не создавая копии.

Параметры

Меняет порядок элементов вектора на обратный. Этот метод изменяет вектор, для которого он вызывается.

Удаляет первый элемент из вектора и возвращает этот элемент. Оставшиеся элементы вектора перемещаются с исходной позиции «i» на позицию «i-1».

Связанные элементы API

Возвращает новый вектор, состоящий из диапазона элементов исходного вектора, не модифицируя исходный вектор. Возвращенный вектор включает элемент startIndex и все элементы вплоть до него, исключая элемент endIndex.

Если параметры не передаются, новый экземпляр Vector дублирует исходный Vector (как поверхностный клон). Если для обоих параметров передано значение 0, создается новый пустой экземпляр Vector того же типа, что и исходный массив Vector.

Параметры

Выполняет тестовую функцию для каждого элемента вектора, пока не будет достигнут элемент, возвращающий значение true. Этот метод используется для того, чтобы определить, все ли элементы вектора соответствуют критерию (например, их значения должны быть меньше определенного числа).

Второй параметр этого метода, thisObject, должен иметь значение null, если первый параметр, callback, завершает метод. Чаще всего данный метод используется именно так.

Однако предположим, что вы создаете функцию для кадра на основной временной шкале, но хотите, чтобы она вызывалась в другом контексте this:

     function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

Допустим, что используется метод some() по отношению к вектору myVector:

     myVector.some(myFunction, someObject);
     

Поскольку функция myFunction принадлежит к основному классу этого SWF-файла, ее нельзя выполнить с другим контекстом this. Среды выполнения Flash выдают исключение при выполнении этого кода. Этой ошибки при выполнении можно избежать, присвоив функцию переменной следующим образом:

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

Параметры

function callback(item:T, index:int, vector:Vector.<T>):Boolean

Связанные элементы API

Упорядочивает элементы в объекте Vector и возвращает упорядоченный объект. Этот метод служит для сортировки в соответствии с параметром sortBehavior, который может являться функцией сравнения двух значений или набором параметров сортировки.

Этот метод принимает один параметр. Параметром может служить следующее:

• функция, принимающая два аргумента типа base (T) объекта Vector и возвращающая значение Number:

  function compare(x:T, y:T):Number {}

  Логика функции такова, что при наличии двух элементов x и y функция возвращает одно из следующих трех значений:

  • отрицательное число, если x стоит перед y после сортировки;
  • 0, если x равно y;
  • положительное число, если элемент x должен следовать за y в отсортированной последовательности.

• число, являющееся результатом побитового сравнения ИЛИ следующих значений:
  • 1 или Array.CASEINSENSITIVE
  • 2 или Array.DESCENDING
  • 4 или Array.UNIQUESORT
  • 8 или Array.RETURNINDEXEDARRAY
  • 16 или Array.NUMERIC

  Если значение равно 0, сортировка выполняется следующим образом.

  • Сортировка зависит от регистра (Z предшествует a).
  • Сортировка выполняется в восходящем порядке (a предшествует b).
  • Массив изменяется, отражая порядок сортировки; несколько элементов, имеющих идентичные поля сортировки последовательно размещаются в отсортированном массиве без определенного порядка.
  • Все элементы независимо от типа данных сортируются так, как если бы это были строки. Число 100 предшествует числу 99, поскольку «1» — это строковое значение, которое меньше «9».

Параметры

Связанные элементы API

Добавляет и удаляет элементы из вектора. Этот метод изменяет вектор, не создавая копии.

Примечание. Чтобы переопределить этот метод в подклассе Vector, укажите для параметров значение ...args как показано в примере:

     public override function splice(...args) {
       // your statements here
     }
     

Параметры

Возвращает строку, представляющую элементы указанного вектора. Каждый элемент в векторе, начиная с индекса 0 и заканчивая наибольшим индексом, преобразуется в сцепленную строку, разделенную запятыми. В рамках ActionScript 3.0 этот метод возвращает то же значение, что и метод Vector.toString().

Связанные элементы API

Возвращает строку, представляющую элементы вектора. Каждый элемент в векторе, начиная с индекса 0 и заканчивая наибольшим индексом, преобразуется в сцепленную строку, разделенную запятыми. Чтобы указать пользовательский разделитель, примените метод Vector.join().

Связанные элементы API

Добавляет один или несколько элементов в начало вектора и возвращает новую длину вектора. Другие элементы вектора перемещаются с исходной позиции (i) на позицию (i + количество новых элементов).

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

Параметры

Связанные элементы API