Главная / Action Script 3

Глобальные функции или функции верхнего уровня доступны в любой части SWF-файла, где используется ActionScript, а также во всех определяемых пользователем классах. Большинство глобальных функций из ActionScript 2.0 стали классами.
Глобальные методы
 ФункцияОпределено
  
Создает новый массив.
Top Level
  
Boolean(expression:Object):Boolean
Преобразует параметр выражения в логическое значение и возвращает его.
Top Level
  
Расшифровывает зашифрованный URI-адрес в строку.
Top Level
  
Расшифровывает зашифрованный URI-компонент в строку.
Top Level
  
Зашифровывает строку в допустимый URI-адрес (унифицированный идентификатор ресурса).
Top Level
  
Зашифровывает строку в допустимый URI-компонент.
Top Level
  
Преобразует параметр в строку и зашифровывает ее в формат кодировки URL-адреса, где большинство символов, не являющихся алфавитно-цифровыми, заменяются шестнадцатеричными последовательностями %.
Top Level
  
int(value:Number):int
Преобразует данное числовое значение в целочисленное значение.
Top Level
  
Возвращает true, если значение является конечным числом, либо false, если значение является бесконечностью или минус бесконечностью.
Top Level
  
Возвращает true, если значение является не относится к числам (NaN).
Top Level
  
Определяет, является ли заданная строка допустимым именем для элемента или атрибута XML.
Top Level
  
Number(expression:Object):Number
Преобразует данное значение в значение Number.
Top Level
  
Все значения в ActionScript 3.0 являются объектами. Это означает, что при вызове метода Object() для значения возвращается данное значение.
Top Level
  
Преобразует строку в число с плавающей запятой.
Top Level
  
parseInt(str:String, radix:uint = 0):Number
Преобразует строку в целое число.
Top Level
  
String(expression:Object):String
Возвращает строковое представление заданного параметра.
Top Level
  
trace(... arguments):void
Отображает выражения, либо выполняет запись в файлы журнала во время отладки.
Top Level
  
Преобразует данное числовое значение в целочисленное значение без знака.
Top Level
  
Вычисляет параметр str как строку, расшифровывает строку из формата кодировки URL (с преобразованием всех шестнадцатеричных последовательностей в символы ASCII) и возвращает строку.
Top Level
  
Vector(sourceArray:Object):Vector.<T>
Создает новый экземпляр вектора, элементы которого являются экземплярами указанного типа данных.
Top Level
  
XML(expression:Object):XML
Преобразует объект в объект XML.
Top Level
  
XMLList(expression:Object):XMLList
Преобразует объект в объект XMLList.
Top Level


Глобальные константы или константы верхнего уровня доступны в любом сценарии и видны в любой временной шкале и области видимости в вашем документе.
Глобальные константы
 Константа Определено
  Infinity : Number
Специальное значение, представляющее плюс бесконечность.
Top Level
  -Infinity : Number
Специальное значение, представляющее минус бесконечность.
Top Level
  NaN : Number
Специальный элемент типа Number, представляющий значение NaN (не число).
Top Level
  undefined : *
Специальное значение, применяемое к неинициализированным переменным без типа или неинициализированным свойствам динамического объекта.
Top Level
Сведения о константе
InfinityКонстанта
public const Infinity:Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Специальное значение, представляющее плюс бесконечность. Значение этой константы совпадает со значением Number.POSITIVE_INFINITY.

См. также


Пример

Результатом деления на 0 является бесконечность, но лишь тогда, когда делитель — положительное число.

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity


-InfinityКонстанта  
public const -Infinity:Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Специальное значение, представляющее минус бесконечность. Значение этой константы совпадает со значением Number.NEGATIVE_INFINITY.

См. также


Пример

Результатом деления на 0 является минус бесконечность, но лишь тогда, когда делитель — отрицательное число.

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity


NaNКонстанта  
public const NaN:Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

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

Значение NaN не принадлежит типам данных int или uint.

Значение NaN не считается равным какому-либо другому значению, включая NaN. По этой причине невозможно проверить, имеет ли выражение значение NaN, с помощью оператора равенства. Чтобы определить является ли число функцией NaN, воспользуйтесь функцией isNaN().

См. также

undefinedКонстанта  
public const undefined:*

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Специальное значение, применяемое к неинициализированным переменным без типа или неинициализированным свойствам динамического объекта. В ActionScript 3.0 значение undefined присваивается только переменным без типа в отличие от ActionScript 1.0 и ActionScript 2.0. Так, например, две следующие переменные имеют значение undefined, поскольку они не имеют типа и не инициализированы:

Значение undefined применяется также к неинициализированным или неопределенным свойствам динамических объектов. Например, если в роли объекта выступает экземпляр класса Object, значением любого динамически добавленного свойства является undefined до тех пор, пока данному свойству не будет присвоено значение.

Если значение undefined используется в сочетании с разными функциями, результаты варьируют:

Не путайте значения undefined и null. Если значения null и undefined сравниваются с оператором равенства (==), они считаются равными. Однако когда значения null и undefined сравниваются с оператором строгого равенства (===), они не рассматриваются как равные.

См. также


Пример

В следующем примере объявляется, но не инициализируется переменная без типа myVar. Переменная myVar принимает значение undefined, так как не относится к какому-либо типу. Это происходит, когда эта переменная не имеет аннотации с указанием типа или снабжена специальной аннотацией (*) об отсутствии типа (var myVar:*;).

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

То же самое правило применяется к неинициализированным свойствам динамического объекта. Например, если имеется экземпляр obj динамического класса A, неинициализированному свойству obj.propName экземпляра obj присваивается значение undefined.

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

Сведения о функции
Array()функция
public function Array(... args):Array

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Создает новый массив. Он может иметь длину не меньше нуля или заполняться списком указанных элементов, возможно принадлежащих разным типам данных. Количество и тип данных используемых аргументов определяет содержимое возвращаемого массива.

Использование функции Array() напоминает создание массива с конструктором класса Array.

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

Параметры

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

Возвращает
Array — Массив нулевой или большей длины.

См. также


Пример

В следующем примере демонстрируется поведение функции Array() в том случае, когда аргумент не является элементарным значением. Часто возникает ситуация, когда приведение типов к массиву состоит в преобразовании экземпляра Object, сохраняющего свои значения в формате массива. Если функция Array() вызывается с аргументом типа Object, или любого другого типа данных, не относящихся к элементарным. Ссылка на объект сохраняется в элементе нового массива. Иными словами, если единственный переданный аргумент является объектом, ссылка на этот объект становится первым элементом нового массива.
var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c

Чтобы привести тип obj к массиву, воспользуйтесь оператором as, который возвращает ссылку на массив, если obj является действительным массивом. В противном случае возвращается null:
var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c
Boolean()функция 
public function Boolean(expression:Object):Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует параметр expression в логическое значение и возвращает его.

Возвращаемое значение зависит от типа данных и значения аргумента (см. таблицу ниже):

Введенное значениеПримерВозвращаемое значение
0Boolean(0)false
Нечисловое значениеBoolean(нечисловое значение)false
Число (не 0 или нечисловое значение)Boolean(4)true
Пустая строкаBoolean("")false
Непустая строкаBoolean("6")true
nullBoolean(null)false
undefinedBoolean(не определено)false
Экземпляр класса ObjectBoolean(new Object())true
Нет аргументаBoolean()false

В отличие от предыдущих версий ActionScript функция Boolean() возвращает те же результаты, что и конструктор класса Boolean.

Параметры

expression:Object — Выражение или объект, преобразуемые в логическое значение.

Возвращает
Boolean — Результат преобразования в логическое значение.

См. также

decodeURI()функция 
public function decodeURI(uri:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Расшифровывает зашифрованный URI-адрес в строку. Строка, все символы в которой были ранее закодированы с помощью функции encodeURI, восстанавливается и выводится в раскодированном представлении.

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

Нераскодированные управляющие последовательностиЭквиваленты символов
%23#
%24$
%26&
%2B+
%2C,
%2F/
%3A:
%3B;
%3D=
%3F?
%40@

Параметры

uri:String — Строка, закодированная с помощью функции encodeURI.

Возвращает
String — Строка, все символы в которой были ранее маскированы с помощью функции encodeURI восстанавливаются в немаскированном представлении.

См. также


Пример

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}
decodeURIComponent()функция 
public function decodeURIComponent(uri:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Расшифровывает зашифрованный URI-компонент в строку. Строка, все символы в которой были ранее маскированы с помощью функции encodeURIComponent, восстанавливается в немаскированном представлении.

Отличие этой функции от функции decodeURI() состоит в том, что она предназначена для использования только по отношению к части строки URI, которая называется компонентом URI. Компонент URI — это любой текст, который заключен между специальными символами, названными разделителями компонентов (":", "/", ";" и "?" ). Распространенные примеры компонентов URI: "http" и "www.adobe.com".

Другое важное различие между этой функцией и decodeURI() обусловлено тем, что эта функция предполагает, что обрабатывается компонент URI, управляющие последовательности, представляющие специальные символы разделителей (; / ? : @ & = + $ , #), обрабатываются как обычный текст, который требует раскодирования.

Параметры

uri:String — Строка, закодированная с помощью функции encodeURIComponent.

Возвращает
String — Строка, все символы в которой были ранее маскированы с помощью функции encodeURIComponent, восстанавливаются в немаскированном представлении.

См. также

encodeURI()функция 
public function encodeURI(uri:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Зашифровывает строку в допустимый URI-адрес (унифицированный идентификатор ресурса). Преобразует полный URI-адрес в строку, в которой все символы имеют кодировку UTF-8, если не принадлежат к небольшой группе базисных символов.

В таблице ниже полностью приведен список базисных символов, которые не преобразуются в управляющие последовательности UTF-8 с помощью функции encodeURI.

Символы, которые не кодируются
0 1 2 3 4 5 6 7 8 9
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
; / ? : @ & = + $ , #
- _ . ! ~ * ' ( )

Параметры

uri:String — Строка, представляющая весь URI-адрес.

Возвращает
String — Строка, где определенные символы закодированы в виде управляющих последовательностей UTF-8.

См. также


Пример

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}
encodeURIComponent()функция 
public function encodeURIComponent(uri:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Зашифровывает строку в допустимый URI-компонент. Преобразует подстроку URI-адреса в строку, в которой все символы кодируются в виде управляющих последовательностей UTF-8, если не принадлежат к очень ограниченному числу базисных символов.

Отличие функции encodeURIComponent() от функции encodeURI() состоит в том, что она предназначена для использования только по отношению к части строки URI, которая называется компонентом URI. Компонент URI — это любой текст, который заключен между специальными символами, названными разделителями компонентов (":", "/", ";" и "?" ). Распространенные примеры компонентов URI: "http" и "www.adobe.com".

Другое важное различие между этой функцией и encodeURI() обусловлено предположением о том, что она обрабатывает компонент URI. При этом специальные символы разделителей (; / ? : @ & = + $ , #) обрабатываются как обычный текст, который надо закодировать.

В таблице ниже приведены все символы, которые не преобразуются в управляющие последовательности UTF-8 функцией encodeURIComponent.

Символы, которые не кодируются
0 1 2 3 4 5 6 7 8 9
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
- _ . ! ~ * ' ( )

Параметры

uri:String

Возвращает
String

См. также

escape()функция 
public function escape(str:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

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

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

Символы, которые не кодируются
0 1 2 3 4 5 6 7 8 9
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
@ - _ . * + /

Параметры

str:String — Выражение, преобразуемое в строку с кодировкой URL-адреса.

Возвращает
String — Строка в кодировке URL-адреса

См. также

int()функция 
public function int(value:Number):int

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует данное числовое значение в целочисленное значение. Десятичные значения усекаются до целых чисел.

Параметры

value:Number — Значение, которое необходимо преобразовать в целочисленное.

Возвращает
int — Преобразованное целочисленное значение.

См. также

isFinite()функция 
public function isFinite(num:Number):Boolean

Язык версии : ActionScript 3.0.
Версии среды выполнения:  1.0 9

Возвращает true, если значение является конечным числом, либо false, если значение является бесконечностью или минус бесконечностью. Присутствие бесконечности или минус бесконечности указывает на условие математической ошибки (например, попытка деления на ноль).

Параметры

num:Number — Число, оцениваемое как конечное или бесконечное.

Возвращает
Boolean — Возвращает true, если оно является конечным числом или false, если это бесконечность или минус бесконечность
isNaN()функция 
public function isNaN(num:Number):Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Возвращает true, если значение относится к разряду NaN(нечисловое). Функция isNaN() полезна при проверке успешности оценки математического выражения с помощью числа. Как правило, функция isNaN() используется для проверки значения, возвращенного функциями parseInt() и parseFloat(). Значение NaN — это специальный элемент типа данных Number, представляющий значение, которое "не является числом".

Примечание. Значение NaN не принадлежит типам данных int или uint.

В таблице ниже описаны значения, возвращаемые isNaN() при различных типах и значениях ввода. (Если для предупреждений компилятора задан "Строгий режим", некоторые из следующих операций вызовут появление предупреждений компилятора.)

Тип/значение вводаПримерВозвращаемое значение
0, разделенный на 0isNaN(0/0)true
Число, отличное от ноля, разделенное на 0isNaN(5/0)false
Квадратный корень отрицательного числаisNaN(Math.sqrt(-1))true
Арксинус числа, которое больше 1 или меньше 0isNaN(Math.asin(2))true
Строка, которую можно преобразовать в тип данных NumberisNaN("5")false
Строка, которую нельзя преобразовать в тип данных NumberisNaN("5a")true

Параметры

num:Number — Оцениваемое числовое значение или математическое выражение.

Возвращает
Boolean — Возвращает true при наличии значения NaN (нечисловое) и false в противном случае.
isXMLName()функция 
public function isXMLName(str:String):Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

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

Параметры

str:String — Оцениваемая строка.

Возвращает
Boolean — Возвращает true, если аргументом str является действительное имя XML. В противном случае возвращается false.
Number()функция 
public function Number(expression:Object):Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует данное значение в значение Number. В таблице ниже приведены результаты при различных типах ввода.

Тип/значение вводаПримерВозвращаемое значение
undefinedNumber(не определено)Нечисловое значение
nullNumber(null)0
trueNumber(true)1
falseNumber(false)0
Нечисловое значениеNumber(Нечисловое значение)Нечисловое значение
Пустая строкаNumber("")0
Строка, преобразуемая в значение NumberNumber("5")Число (например, 5)
Строка, которая не преобразуется в значение NumberNumber("5a")Нечисловое значение

Параметры

expression:Object — Значение, преобразуемое в число.

Возвращает
Number — Преобразованное числовое значение

См. также

Object()функция 
public function Object(value:Object):Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Все значения в ActionScript 3.0 являются объектами. Это означает, что при вызове метода Object() для значения возвращается данное значение.

Параметры

value:Object — Преобразуемый объект или число, строка и логическое значение.

Возвращает
Object — Значение, указанное параметром value.

См. также

parseFloat()функция 
public function parseFloat(str:String):Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует строку в число с плавающей запятой. Эта функция считывает или выполняет анализ чисел, которые возвращаются в виде строки до тех пор, пока не доходит до символа, который не входит в исходное число. Если строка не начинается с числа, которое можно проанализировать, parseFloat() возвращает значение NaN. Символ пробела, указанный перед допустимыми целыми числами, игнорируется так же, как и нечисловые символы после них.

Параметры

str:String — Строка, которая считывается и преобразуется в число с плавающей запятой.

Возвращает
Number — Число или значение NaN (нечисловое).
parseInt()функция 
public function parseInt(str:String, radix:uint = 0):Number

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует строку в целое число. Если указанную в параметрах строку не удается преобразовать в число, функция возвращает NaN. Строки, которые начинаются с 0x, считаются шестнадцатеричными числами. В отличие от предыдущих версий ActionScript целые числа, которые начинаются с 0 не рассматриваются в качестве восьмеричных. Для восьмеричных чисел указывается основание равное 8. Символы пробела и нули, стоящие перед целыми числами, игнорируются так же, как и нечисловые символы.

Параметры

str:String — Строка, преобразуемая в целое число.
 
radix:uint (default = 0) — Целое число, представляющее основание (базу) разбираемого числа. Допускаются значения от 2 до 36.

Возвращает
Number — Число или значение NaN (нечисловое).
String()функция 
public function String(expression:Object):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Возвращает строковое представление заданного параметра.

В таблице ниже приведены результаты при различных типах ввода.

Тип/значение вводаВозвращаемое значение
undefinedundefined
null"null"
truetrue
falsefalse
Нечисловое значение"NaN"
StringString
ObjectObject.toString()
NumberСтроковое представление числа

Параметры

expression:Object — Выражение, преобразуемое в строку.

Возвращает
String — Строковое представление значения, переданного для параметра expression.

См. также

trace()функция 
public function trace(... arguments):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Отображает выражения, либо выполняет запись в файлы журнала во время отладки. Единичная инструкция trace может поддерживать несколько аргументов. Если любой аргумент инструкции trace включает тип данных, отличающийся от String, функция trace вызывает связанный метод toString() для этого типа данных. Например, если аргумент — это логическое значение, функция trace вызывает метод Boolean.toString() и показывает возвращаемое значение.

Параметры

... arguments — Одно или несколько выражений для оценки, разделенных запятыми. Если указывается несколько выражений, между выводимыми выражениями вставляются пробелы.


Пример

В следующем примере класс TraceExample используется для того, чтобы показать, как метод trace() можно использовать для печати простой строки. Обычно это сообщение выводится на печать с помощью консоли "Отладка".
package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}
uint()функция 
public function uint(value:Number):uint

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует данное числовое значение в целочисленное значение без знака. Десятичные значения усекаются до целых чисел.

В таблице ниже описано значение, возвращаемое uint() при различных типах и значениях ввода.

Тип/значение вводаПримерВозвращаемое значение
undefineduint(не определено)0
nulluint(null)0
0uint(0)0
Нечисловое значениеuint(Нечисловое значение)0
Положительное число с плавающей запятойuint(5.31)Усеченное целое число без знака (например, 5)
Отрицательное число с плавающей запятойuint(-5.78)Усекает целое число, а затем применяет правило для отрицательных целых чисел
Отрицательное числоuint(-5)Сумма значения uint.MAX_VALUE и отрицательного целого числа (например, uint.MAX_VALUE + (-5))
trueuint(true)1
falseuint(false)0
Пустая строкаuint("")0
Строка, преобразуемая в значение Numberuint("5")Число
Строка, которая не преобразуется в значение Numberuint("5a")0

Параметры

value:Number — Значение, которое необходимо преобразовать в целочисленное.

Возвращает
uint — Преобразованное целочисленное значение.

См. также

unescape()функция 
public function unescape(str:String):String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Вычисляет параметр str как строку, раскодирует строку из формата кодировки URL (с преобразованием всех шестнадцатеричных последовательностей в символы ASCII) и возвращает строку.

Параметры

str:String — Строка, где необходимо маскировать шестнадцатеричные последовательности.

Возвращает
String — Строка, полученная в результате раскодирования параметра в кодировке URL-адреса.
Vector()функция 
public function Vector(sourceArray:Object):Vector.<T>

Язык версии : ActionScript 3.0
Версии среды выполнения:  10, 1.5

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

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

Итоговый вектор заполняется значениями, указанными в элементах аргумента sourceArray. Если аргумент sourceArray уже является экземпляром Vector.<T>, где T это базовый тип, функция возвращает данный вектор. В противном случае итоговый вектор заполняется элементами массива или вектора, представленного аргументом sourceArray.

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

Если аргумент sourceArray имеет нулевое значение свойства length, функция возвращает пустой вектор.

Если вектор передан как аргумент sourceArray, а его базовый тип — не T, или если переда массив, и не все его элементы имеют тип данных T, выполняется попытка преобразовать значения в базовый тип. Если значения удается автоматически преобразовать, итоговый вектор содержит преобразованные значения. Если преобразование выполнить не удается, происходит ошибка.

Точно так же, если элемент в аргументе sourceArray является экземпляром подкласса базового типа T, вызов выполняется успешно, и элемент добавляется в итоговый вектор. Это происходит даже тогда, когда аргумент sourceArray является вектором, чей базовый тип является подклассом T. Фактически, только так можно преобразовать вектор с базовым типом T в вектор с базовым типом, который является суперклассом T.

Например, следующий код приводит к появлению ошибки компиляции в строгом режиме или ошибки TypeError во время выполнения, поскольку он пытается присвоить Vector.<Sprite> переменной Vector.<DisplayObject> (Sprite — это подкласс DisplayObject).

  var v1:Vector.<Sprite> = new Vector.<Sprite>();
  v1[0] = new Sprite();
  var v2:Vector.<DisplayObject> = v1;
  

Следующая альтернативная версия кода приводит к успешному копированию элементов экземпляра Vector.<Sprite> в экземпляр Vector.<DisplayObject>.

  var v1:Vector.<Sprite> = new Vector.<Sprite>();
  v1[0] = new Sprite();
  var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
  

Параметры

sourceArray:Object — Экземпляр Array или Vector, элементы которого становятся элементами итогового объекта Vector. Если аргумент — это экземпляр вектора, тип данных которого совпадает с указанным типом данных, этот аргумент возвращается в качестве результата функции.

Возвращает
Vector.<T> — Экземпляр вектора, заполненный элементами массива sourceArray.

Выдает
TypeError — Если аргумент sourceArray содержит элемент, который невозможно преобразовать в указанный тип данных.

См. также

XML()функция 
public function XML(expression:Object):XML

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует объект в объект XML.

В таблице ниже дается описание значений, возвращаемых при различных типах ввода.

Тип параметраВозвращаемое значение
BooleanЗначение сначала преобразуется в строку, а затем — в объект XML.
NullПроисходит ошибка при выполнении (исключение TypeError).
NumberЗначение сначала преобразуется в строку, а затем — в объект XML.
ObjectПреобразование в XML выполняется только тогда, когда значение относится к типам String, Number или Boolean. В противном случае происходит ошибка при выполнении (исключение TypeError).
StringЗначение преобразуется в XML.
UndefinedПроисходит ошибка при выполнении (исключение TypeError).
XMLВводимое значение возвращается без изменений.
XMLListВозвращает объект XML только в том случае, если объект XMLList содержит только одно свойство типа XML. В противном случае происходит ошибка при выполнении (исключение TypeError).

Параметры

expression:Object — Объект, преобразуемый в формат XML.

Возвращает
XML — Объект XML, содержащий значения, которые записаны в преобразуемом объекте.

См. также

XMLList()функция 
public function XMLList(expression:Object):XMLList

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Преобразует объект в объект XMLList.

В таблице ниже дается описание значений, возвращаемых при различных типах ввода.

Тип параметраВозвращаемое значение
BooleanЗначение сначала преобразуется в строку, а затем — в объект XMLList.
NullПроисходит ошибка при выполнении (исключение TypeError).
NumberЗначение сначала преобразуется в строку, а затем — в объект XMLList.
ObjectПреобразование в XMLList выполняется только тогда, когда значение относится к типам String, Number или Boolean. В противном случае происходит ошибка при выполнении (исключение TypeError).
StringЗначение преобразуется в объект XMLList
UndefinedПроисходит ошибка при выполнении (исключение TypeError).
XMLЗначение преобразуется в объект XMLList
XMLListВводимое значение возвращается без изменений.

Параметры

expression:Object — Объект, преобразуемый в объект XMLList

Возвращает
XMLList — Объект XMLList, содержащий значения, которые записаны в преобразованном объекте.

См. также