Функция | Определено | ||
---|---|---|---|
Создает новый массив. | Top Level | ||
Преобразует параметр выражения в логическое значение и возвращает его. | Top Level | ||
Расшифровывает зашифрованный URI-адрес в строку. | Top Level | ||
Расшифровывает зашифрованный URI-компонент в строку. | Top Level | ||
Зашифровывает строку в допустимый URI-адрес (унифицированный идентификатор ресурса). | Top Level | ||
Зашифровывает строку в допустимый URI-компонент. | Top Level | ||
Преобразует параметр в строку и зашифровывает ее в формат кодировки URL-адреса, где большинство символов, не являющихся алфавитно-цифровыми, заменяются шестнадцатеричными последовательностями %. | Top Level | ||
Преобразует данное числовое значение в целочисленное значение. | Top Level | ||
Возвращает true, если значение является конечным числом, либо false, если значение является бесконечностью или минус бесконечностью. | Top Level | ||
Возвращает true, если значение является не относится к числам (NaN). | Top Level | ||
Определяет, является ли заданная строка допустимым именем для элемента или атрибута XML. | Top Level | ||
Преобразует данное значение в значение Number. | Top Level | ||
Все значения в ActionScript 3.0 являются объектами. Это означает, что при вызове метода Object() для значения возвращается данное значение. | Top Level | ||
Преобразует строку в число с плавающей запятой. | Top Level | ||
Преобразует строку в целое число. | Top Level | ||
Возвращает строковое представление заданного параметра. | Top Level | ||
Отображает выражения, либо выполняет запись в файлы журнала во время отладки. | Top Level | ||
Преобразует данное числовое значение в целочисленное значение без знака. | Top Level | ||
Вычисляет параметр str как строку, расшифровывает строку из формата кодировки URL (с преобразованием всех шестнадцатеричных последовательностей в символы ASCII) и возвращает строку. | Top Level | ||
Создает новый экземпляр вектора, элементы которого являются экземплярами указанного типа данных. | Top Level | ||
Преобразует объект в объект XML. | Top Level | ||
Преобразует объект в объект 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
Специальное значение, представляющее плюс бесконечность
. Значение этой константы совпадает со значением Number.POSITIVE_INFINITY
.
См. также
бесконечность
, но лишь тогда, когда делитель — положительное число.
trace(0 / 0); // NaN trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
-Infinity | Константа |
public const -Infinity:Number
Специальное значение, представляющее минус бесконечность
. Значение этой константы совпадает со значением Number.NEGATIVE_INFINITY
.
См. также
минус бесконечность
, но лишь тогда, когда делитель — отрицательное число.
trace(0 / 0); // NaN trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
NaN | Константа |
public const NaN:Number
Специальный элемент типа Number, представляющий значение NaN (не число
). Когда результатом математического выражения является значение, которое невозможно представить в виде числа, ему присваивается обозначение NaN
. В списке ниже описаны распространенные выражения, приводящие к появлению значения NaN
.
NaN
указывается только тогда, когда делителем является также 0. Если делитель больше 0, результатом деления на 0 является бесконечность
. Если делитель меньше 0, результатом деления на 0 является минус бесконечность
;бесконечность
, отнятая от бесконечности
;бесконечность
или минус бесконечность
, деленная на бесконечность
или минус бесконечность
;бесконечность
или минус бесконечность
, умноженная на 0;Значение NaN
не принадлежит типам данных int или uint.
Значение NaN
не считается равным какому-либо другому значению, включая NaN
. По этой причине невозможно проверить, имеет ли выражение значение NaN
, с помощью оператора равенства. Чтобы определить является ли число функцией NaN
, воспользуйтесь функцией isNaN()
.
См. также
undefined | Константа |
public const undefined:*
Специальное значение, применяемое к неинициализированным переменным без типа или неинициализированным свойствам динамического объекта. В ActionScript 3.0 значение undefined
присваивается только переменным без типа в отличие от ActionScript 1.0 и ActionScript 2.0. Так, например, две следующие переменные имеют значение undefined
, поскольку они не имеют типа и не инициализированы:
var foo;
var bar:*;
Значение undefined
применяется также к неинициализированным или неопределенным свойствам динамических объектов. Например, если в роли объекта выступает экземпляр класса Object, значением любого динамически добавленного свойства является undefined
до тех пор, пока данному свойству не будет присвоено значение.
Если значение undefined
используется в сочетании с разными функциями, результаты варьируют:
String(undefined)
возвращает значение "undefined"
(undefined
преобразуется в строку).Number(undefined)
возвращает значение NaN
.int(undefined)
и uint(undefined)
возвращают 0.Object(undefined)
возвращает значение в виде нового экземпляра Object.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
Создает новый массив. Он может иметь длину не меньше нуля или заполняться списком указанных элементов, возможно принадлежащих разным типам данных. Количество и тип данных используемых аргументов определяет содержимое возвращаемого массива.
Array()
без аргументов возвращает пустой массив.Array()
с единственным целочисленным аргументом возвращает массив указанной длины, значения элементов которого, тем не менее, не определены.Array()
со списком конкретных значений возвращает массив с элементами, содержащими каждое из указанных значений.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
Преобразует параметр expression
в логическое значение и возвращает его.
Возвращаемое значение зависит от типа данных и значения аргумента (см. таблицу ниже):
Введенное значение | Пример | Возвращаемое значение |
---|---|---|
0 | Boolean(0) | false |
Нечисловое значение | Boolean(нечисловое значение) | false |
Число (не 0 или нечисловое значение ) | Boolean(4) | true |
Пустая строка | Boolean("") | false |
Непустая строка | Boolean("6") | true |
null | Boolean(null) | false |
undefined | Boolean(не определено) | false |
Экземпляр класса Object | Boolean(new Object()) | true |
Нет аргумента | Boolean() | false |
В отличие от предыдущих версий ActionScript функция Boolean()
возвращает те же результаты, что и конструктор класса Boolean.
Параметры
expression:Object — Выражение или объект, преобразуемые в логическое значение.
|
Boolean — Результат преобразования в логическое значение.
|
decodeURI | () | функция |
public function decodeURI(uri:String):String
Расшифровывает зашифрованный 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
Расшифровывает зашифрованный 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
Зашифровывает строку в допустимый 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
Зашифровывает строку в допустимый 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
Преобразует параметр в строку и кодирует ее в формат кодировки 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
Преобразует данное числовое значение в целочисленное значение. Десятичные значения усекаются до целых чисел.
Параметры
value:Number — Значение, которое необходимо преобразовать в целочисленное.
|
int — Преобразованное целочисленное значение.
|
См. также
isFinite | () | функция |
public function isFinite(num:Number):Boolean
Возвращает true
, если значение является конечным числом, либо false
, если значение является бесконечностью
или минус бесконечностью
. Присутствие бесконечности
или минус бесконечности
указывает на условие математической ошибки (например, попытка деления на ноль).
Параметры
num:Number — Число, оцениваемое как конечное или бесконечное.
|
Boolean — Возвращает true , если оно является конечным числом или false , если это бесконечность или минус бесконечность.
|
isNaN | () | функция |
public function isNaN(num:Number):Boolean
Возвращает true
, если значение относится к разряду NaN
(нечисловое). Функция isNaN()
полезна при проверке успешности оценки математического выражения с помощью числа. Как правило, функция isNaN()
используется для проверки значения, возвращенного функциями parseInt()
и parseFloat()
. Значение NaN
— это специальный элемент типа данных Number, представляющий значение, которое "не является числом".
Примечание. Значение NaN
не принадлежит типам данных int или uint.
В таблице ниже описаны значения, возвращаемые isNaN()
при различных типах и значениях ввода. (Если для предупреждений компилятора задан "Строгий режим", некоторые из следующих операций вызовут появление предупреждений компилятора.)
Тип/значение ввода | Пример | Возвращаемое значение |
---|---|---|
0, разделенный на 0 | isNaN(0/0) | true |
Число, отличное от ноля, разделенное на 0 | isNaN(5/0) | false |
Квадратный корень отрицательного числа | isNaN(Math.sqrt(-1)) | true |
Арксинус числа, которое больше 1 или меньше 0 | isNaN(Math.asin(2)) | true |
Строка, которую можно преобразовать в тип данных Number | isNaN("5") | false |
Строка, которую нельзя преобразовать в тип данных Number | isNaN("5a") | true |
Параметры
num:Number — Оцениваемое числовое значение или математическое выражение.
|
Boolean — Возвращает true при наличии значения NaN (нечисловое) и false в противном случае.
|
isXMLName | () | функция |
public function isXMLName(str:String):Boolean
Определяет, является ли заданная строка допустимым именем для элемента или атрибута XML.
Параметры
str:String — Оцениваемая строка.
|
Boolean — Возвращает true , если аргументом str является действительное имя XML. В противном случае возвращается false .
|
Number | () | функция |
public function Number(expression:Object):Number
Преобразует данное значение в значение Number. В таблице ниже приведены результаты при различных типах ввода.
Тип/значение ввода | Пример | Возвращаемое значение |
---|---|---|
undefined | Number(не определено) | Нечисловое значение |
null | Number(null) | 0 |
true | Number(true) | 1 |
false | Number(false) | 0 |
Нечисловое значение | Number(Нечисловое значение) | Нечисловое значение |
Пустая строка | Number("") | 0 |
Строка, преобразуемая в значение Number | Number("5") | Число (например, 5 ) |
Строка, которая не преобразуется в значение Number | Number("5a") | Нечисловое значение |
Параметры
expression:Object — Значение, преобразуемое в число.
|
Number — Преобразованное числовое значение.
|
Object | () | функция |
public function Object(value:Object):Object
Все значения в ActionScript 3.0 являются объектами. Это означает, что при вызове метода Object()
для значения возвращается данное значение.
Параметры
value:Object — Преобразуемый объект или число, строка и логическое значение.
|
Object — Значение, указанное параметром value .
|
parseFloat | () | функция |
public function parseFloat(str:String):Number
Преобразует строку в число с плавающей запятой. Эта функция считывает или выполняет анализ чисел, которые возвращаются в виде строки до тех пор, пока не доходит до символа, который не входит в исходное число. Если строка не начинается с числа, которое можно проанализировать, parseFloat()
возвращает значение NaN
. Символ пробела, указанный перед допустимыми целыми числами, игнорируется так же, как и нечисловые символы после них.
Параметры
str:String — Строка, которая считывается и преобразуется в число с плавающей запятой.
|
Number — Число или значение NaN (нечисловое).
|
parseInt | () | функция |
public function parseInt(str:String, radix:uint = 0):Number
Преобразует строку в целое число. Если указанную в параметрах строку не удается преобразовать в число, функция возвращает NaN
. Строки, которые начинаются с 0x, считаются шестнадцатеричными числами. В отличие от предыдущих версий ActionScript целые числа, которые начинаются с 0 не рассматриваются в качестве восьмеричных. Для восьмеричных чисел указывается основание равное 8. Символы пробела и нули, стоящие перед целыми числами, игнорируются так же, как и нечисловые символы.
Параметры
str:String — Строка, преобразуемая в целое число.
| |
radix:uint (default = 0 ) — Целое число, представляющее основание (базу) разбираемого числа. Допускаются значения от 2 до 36.
|
Number — Число или значение NaN (нечисловое).
|
String | () | функция |
public function String(expression:Object):String
Возвращает строковое представление заданного параметра.
В таблице ниже приведены результаты при различных типах ввода.
Тип/значение ввода | Возвращаемое значение |
---|---|
undefined | undefined |
null | "null" |
true | true |
false | false |
Нечисловое значение | "NaN" |
String | String |
Object | Object.toString() |
Number | Строковое представление числа |
Параметры
expression:Object — Выражение, преобразуемое в строку.
|
String — Строковое представление значения, переданного для параметра expression .
|
trace | () | функция |
public function trace(... arguments):void
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 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
Преобразует данное числовое значение в целочисленное значение без знака. Десятичные значения усекаются до целых чисел.
В таблице ниже описано значение, возвращаемое uint()
при различных типах и значениях ввода.
Тип/значение ввода | Пример | Возвращаемое значение |
---|---|---|
undefined | uint(не определено) | 0 |
null | uint(null) | 0 |
0 | uint(0) | 0 |
Нечисловое значение | uint(Нечисловое значение) | 0 |
Положительное число с плавающей запятой | uint(5.31) | Усеченное целое число без знака (например, 5 ) |
Отрицательное число с плавающей запятой | uint(-5.78) | Усекает целое число, а затем применяет правило для отрицательных целых чисел |
Отрицательное число | uint(-5) | Сумма значения uint.MAX_VALUE и отрицательного целого числа (например, uint.MAX_VALUE + (-5) ) |
true | uint(true) | 1 |
false | uint(false) | 0 |
Пустая строка | uint("") | 0 |
Строка, преобразуемая в значение Number | uint("5") | Число |
Строка, которая не преобразуется в значение Number | uint("5a") | 0 |
Параметры
value:Number — Значение, которое необходимо преобразовать в целочисленное.
|
uint — Преобразованное целочисленное значение.
|
См. также
unescape | () | функция |
public function unescape(str:String):String
Вычисляет параметр str
как строку, раскодирует строку из формата кодировки URL (с преобразованием всех шестнадцатеричных последовательностей в символы ASCII) и возвращает строку.
Параметры
str:String — Строка, где необходимо маскировать шестнадцатеричные последовательности.
|
String — Строка, полученная в результате раскодирования параметра в кодировке URL-адреса.
|
Vector | () | функция |
public function Vector(sourceArray:Object):Vector
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 10 |
Создает новый экземпляр вектора, элементы которого являются экземплярами указанного типа данных. При вызове этой функции указывается тип данных для элементов итогового вектора (базового типа вектора) с помощью параметра типа. В этой функции используется тот же синтаксис, что и при объявлении экземпляра вектора или вызове конструктора 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 — Экземпляр вектора, заполненный элементами массива sourceArray .
|
TypeError — Если аргумент sourceArray содержит элемент, который невозможно преобразовать в указанный тип данных.
|
См. также
XML | () | функция |
public function XML(expression:Object):XML
Преобразует объект в объект 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
Преобразует объект в объект 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, содержащий значения, которые записаны в преобразованном объекте.
|
См. также