RangeError  - AS3

Pacote	Nível superior
Classe	public dynamic class RangeError
Herança	RangeError Error Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 9, AIR 1.0, Flash Lite 4

Uma exceção RangeError é lançada quando um valor numérico está fora da faixa aceitável. Ao trabalhar com matrizes, fazer referência a uma posição de índice de um item de matriz inexistente lançará uma exceção RangeError. O uso dos métodos Number.toExponential(), Number.toPrecision() e Number.toFixed() lançará uma exceção RangeError nos casos em que os argumentos estiverem fora da faixa de números aceitável. É possível estender Number.toExponential(), Number.toPrecision() e Number.toFixed() para evitar o lançamento de RangeError.

Outras situações que resultam no lançamento dessa exceção incluem:

• Qualquer API do tempo de execução do Flash que espera que um número de profundidade seja chamado com um número de profundidade inválido.
• Qualquer API do tempo de execução do Flash que espera que um número de quadro seja chamado com um número de quadro inválido.
• Qualquer API do tempo de execução do Flash que espera que um número de camada seja chamado com um número de camada inválido.

Veja os exemplos

Elementos da API relacionados

---

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