Верхний уровень 

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

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

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

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

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

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

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

• В результате деления на 0 NaN указывается только тогда, когда делителем является также 0. Если делитель больше 0, результатом деления на 0 является Infinity. Если делитель меньше 0, результатом деления на 0 является -Infinity;
• квадратный корень отрицательного числа;
• арксинус числа за пределами действительного диапазона от 0 до 1;
• Infinity, отнятая от Infinity;
• Infinity или -Infinity, деленная на Infinity или -Infinity;
• Infinity или -Infinity, умноженная на 0;

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

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

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

Специальное значение, применяемое к неинициализированным переменным без типа или неинициализированным свойствам динамического объекта. В 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 сравниваются с оператором строгого равенства (===), они не рассматриваются как равные.

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

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

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

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

Создает новый массив. Массив может иметь нулевую или большую длину, или может быть заполнен одним указанным объектом.

• Вызов функции Array() без аргументов возвращает пустой массив.
• Вызов функции Array() с единственным целочисленным аргументом возвращает массив указанной длины, значения элементов которого, тем не менее, не определены.
• При вызове функции Array() с указанным объектом возвращается массив с одним элементом указанного объекта.

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

Функция Array() не приводит тип объекта массива. Воспользуйтесь оператором as для явного преобразования или приведения типов, когда аргумент не является элементарным значением. Дополнительную информацию см. в разделе «Пример» данной записи. Если объект передается в качестве параметра в функцию Array(), создается новый массив, содержащий объект в качестве элемента.

Параметры

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

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

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

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

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

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

Параметры

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

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

Параметры

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

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>
        }
    }
}

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

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

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

Параметры

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

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

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

Параметры

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

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>
        }
    }
}

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

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

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

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

Параметры

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

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

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

Примечание. При кодировании используйте функцию encodeURIComponent() вместо функции escape() для обработки специальных символов разделителей (@ + /) как обычного текста.

Параметры

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

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

Параметры

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

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

Параметры

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

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

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

Параметры

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

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

Параметры

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

Параметры

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

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

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

Параметры

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

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

Параметры

Создает новый экземпляр вектора, элементы которого являются экземплярами указанного типа данных. При вызове этой функции указывается тип данных для элементов итогового вектора (базового типа вектора) с помощью параметра типа. В этой функции используется тот же синтаксис, что и при объявлении экземпляра вектора или вызове конструктора 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);
     

Параметры

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

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

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

Параметры

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

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

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

Параметры

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