Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
Верхний уровень 

RangeError  - AS3

ПакетВерхний уровень
Классpublic dynamic class RangeError
НаследованиеRangeError Inheritance Error Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 9, AIR 1.0, Flash Lite 4

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

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

  • Любой API среды выполнения Flash, ожидающий ввода показателя глубины, вызывается с указанием недействительного числа глубины.
  • Любой API среды выполнения Flash, ожидающий ввода номера кадра, вызывается с указанием недействительного номера кадра.
  • Любой API среды выполнения Flash, ожидающий ввода номера слоя, вызывается с указанием недействительного номера слоя.

Посмотреть примеры

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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritederrorID : int
[только для чтения] Содержит номер ссылки, связанный с конкретным сообщением об ошибке.
Error
 Inheritedmessage : String
Содержит сообщение, связанное с объектом Error.
Error
 Inheritedname : String
Содержит имя объекта Error.
Error
Общедоступные методы
 МетодОпределено
  
RangeError(message:String = "")
Создает новый объект RangeError.
RangeError
 Inherited
Возвращает список вызовов для данной ошибки в момент ее конструирования в форме строки.
Error
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
[переопределить] Возвращает строку Error по умолчанию или значение, содержащееся в свойстве Error.message, если оно определено.
Error
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о конструкторе

RangeError

()Конструктор
public function RangeError(message:String = "")

Версии среды выполнения: Flash Lite 4, Flash Player 9, AIR 1.0

Создает новый объект RangeError.

Параметры
message:String (default = "") — Содержит сообщение, связанное с объектом RangeError.
RangeErrorExample.as

В следующем примере показано, как генерируется и обрабатывается исключение RangeError в операторе try..catch.
package {
    import flash.display.Sprite;

    public class RangeErrorExample extends Sprite {

        public function RangeErrorExample() {
            var child:Sprite = new Sprite();
            try {
                addChildAt(child, 1);
            }
            catch(e:RangeError) {
                trace(e);
            }
        }
    }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.