Primo livello 

Un valore speciale che rappresenta un valore Infinity negativo. Il valore di questa costante è uguale a Number.NEGATIVE_INFINITY.

Elementi API correlati

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

Un valore speciale che rappresenta un valore Infinity positivo. Il valore di questa costante è uguale a Number.POSITIVE_INFINITY.

Elementi API correlati

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

Un membro speciale del tipo di dati Number che rappresenta un valore diverso da un numero (NaN). Quando un'espressione matematica produce un valore che non può essere espresso come numero, il risultato è NaN (Not a Number, Non un numero). L'elenco seguente descrive le espressioni comuni che producono un valore NaN.

• Il risultato della divisione per 0 è NaN solo se anche il divisore è 0. Se il divisore è maggiore di 0, il risultato della divisione per 0 è Infinity. Se il divisore è minore di 0, il risultato della divisione per 0 è -Infinity.
• Radice quadrata di un numero negativo.
• Seno dell'arco di un numero che si trova al di fuori dell'intervallo valido (compreso tra 0 e 1).
• Infinity sottratto da Infinity.
• Infinity o -Infinity diviso per Infinity o -Infinity.
• Infinity o -Infinity moltiplicato per 0.

Il valore NaN non è un membro dei tipi di dati int o uint.

Il valore NaN non viene considerato uguale a nessun altro valore, compreso NaN, e ciò rende impossibile l'utilizzo dell'operatore di uguaglianza per provare se un'espressione è NaN. Per determinare se un numero è la funzione NaN, utilizzate isNaN().

Elementi API correlati

Un valore speciale che si applica alle variabili senza tipo che non sono state inizializzate o alle proprietà degli oggetti dinamici che non sono inizializzate. In ActionScript 3.0, solo le variabili che sono senza tipo possono contenere il valore undefined, mentre ciò non vale in ActionScript 1.0 e ActionScript 2.0. Ad esempio, entrambe le variabili seguenti sono undefined poiché sono senza tipo e non inizializzate:

• var foo;
• var bar:*;

Il valore undefined si applica anche alle proprietà non inizializzate o undefined degli oggetti dinamici. Ad esempio, se un oggetto è un'istanza della classe Object, il valore di qualunque proprietà aggiunta dinamicamente è undefined fino a quando alla proprietà non viene assegnato un valore.

I risultati variano quando si utilizza undefined con varie funzioni:

• Il valore restituito da String(undefined) è "undefined" (undefined viene convertito in stringa).
• Il valore restituito da Number(undefined) è NaN.
• Il valore restituito da int(undefined) e uint(undefined) è 0.
• Il valore restituito da Object(undefined) è una nuova istanza Object.
• Quando il valore undefined viene assegnato a una variabile con tipo, il valore viene convertito nel valore predefinito del tipo di dati.

Non confondete undefined con null. Quando null e undefined vengono confrontati mediante l'operatore di uguaglianza (==), risultano uguali. Tuttavia, quando null e undefined vengono confrontati mediante l'operatore di uguaglianza rigorosa (===), non risultano uguali.

Elementi API correlati

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

Crea un nuovo array. L'array può essere di lunghezza zero o maggiore, oppure un array compilato da un singolo oggetto specificato.

• Se chiamate Array() senza argomenti, viene restituito un array vuoto.
• Se chiamate Array() con un solo argomento costituito da un numero intero, viene restituito un array della lunghezza specificata ma con elementi dai valori undefined.
• Se chiamate Array() con un oggetto specificato, viene restituito un array con un elemento dell'oggetto specificato.

Nota: se tentate di usare la funzione Array() per creare un nuovo array e passate diversi valori come parametri per compilare l'array, verrà generato un errore del compilatore. La funzione Array() ammette un solo parametro. Utilizzate invece la funzione di costruzione di classi Array per creare e compilare un array di più valori.

La funzione Array() non inserisce il tipo di un oggetto in un array. Utilizzate l'operatore as per la conversione del tipo esplicita o per l'inserimento dei tipi, quando l'argomento non è un valore di base. Per ulteriori informazioni, vedete la sezione Esempio di questa voce. Se passate un oggetto come parametro nella funzione Array(), viene creato un nuovo array contenente l'oggetto come elemento.

Parametri

Elementi API correlati

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

Converte il parametro expression in un valore booleano e restituisce il valore.

Il valore restituito dipende dal tipo di dati e dal valore dell'argomento, come descritto nella tabella seguente:

A differenza delle versioni precedenti di ActionScript, la funzione Boolean() restituisce gli stessi risultati della funzione di costruzione della classe Boolean.

Parametri

Decodifica in stringa un URI codificato. Restituisce una stringa in cui tutti i caratteri precedentemente codificati dalla funzione encodeURI vengono riportati alla rappresentazione non codificata.

La tabella seguente mostra il gruppo di sequenze di escape che non vengono decodificate in caratteri dalla funzione decodeURI. Utilizzate decodeURIComponent() per decodificare le sequenze di escape di questa tabella.

Parametri

Elementi API correlati

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

Decodifica in stringa un componente URI codificato. Restituisce una stringa in cui tutti i caratteri a cui è stata precedentemente assegnata una sequenza di escape dalla funzione encodeURIComponent vengono riportati alla rappresentazione non codificata.

Questa funzione si differenzia dalla funzione decodeURI() per il fatto che è progettata per essere utilizzata solo con una parte di una stringa URI, definita componente URI. Un componente URI è costituito da qualsiasi testo che compare tra caratteri speciali definiti separatori di componenti (: / ; e ? ). Esempi comuni di un componente URI sono "http" e "www.adobe.com".

Un'altra importante differenza tra questa funzione e decodeURI() consiste nel fatto che, poiché questa funzione presuppone di elaborare un componente URI, considera le sequenze di escape che rappresentano caratteri di separazione speciali (; / ? : @ & = + $ , #) come se si trattasse di normale testo da decodificare.

Parametri

Elementi API correlati

Codifica una stringa in un URI (Uniform Resource Identifier) valido. Converte un URI completo in una stringa in cui tutti i caratteri sono codificati come sequenze di escape UTF-8, a meno che un carattere appartenga a un gruppo ridotto di caratteri di base.

La tabella seguente mostra il gruppo completo di caratteri di base che non vengono decodificati in sequenze di escape UTF-8 dalla funzione encodeURI.

Parametri

Elementi API correlati

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

Codifica una stringa in un componente URI valido. Converte una sottostringa di un URI in una stringa in cui tutti i caratteri sono codificati come sequenze di escape UTF-8, a meno che un carattere appartenga a un gruppo molto ridotto di caratteri di base.

La funzione encodeURIComponent() si differenzia dalla funzione encodeURI() per il fatto che è progettata per essere utilizzata solo con una parte di una stringa URI, definita componente URI. Un componente URI è costituito da qualsiasi testo che compare tra caratteri speciali definiti separatori di componenti (: / ; e ? ). Esempi comuni di un componente URI sono "http" e "www.adobe.com".

Un'altra importante differenza tra questa funzione ed encodeURI() consiste nel fatto che, poiché questa funzione presuppone di elaborare un componente URI, considera i caratteri di separazione speciali (; / ? : @ & = + $ , #) come se si trattasse di normale testo da codificare.

La tabella seguente mostra tutti i caratteri di base che non vengono convertiti in sequenze di escape UTF-8 dalla funzione encodeURIComponent.

Parametri

Elementi API correlati

Converte il parametro in stringa e lo codifica in un formato URL in cui la maggior parte dei caratteri non alfanumerici viene sostituita con sequenze esadecimali %. Quando viene utilizzato in una stringa con formato di codifica URL, il simbolo della percentuale (%) introduce i caratteri escape e non equivale all'operatore modulo (%).

La tabella seguente mostra tutti i caratteri di base che non vengono convertiti in sequenze di escape dalla funzione escape().

Nota: utilizzate la funzione encodeURIComponent() invece di escape() per elaborare caratteri di separazione speciali (@ + /) come testo normale da codificare.

Parametri

Elementi API correlati

Converte un valore numerico dato in un valore intero. I valori decimali vengono troncati in corrispondenza del separatore decimale.

Parametri

Elementi API correlati

Restituisce true se il valore è un numero finito oppure false se il valore è Infinity o -Infinity. La presenza di un valore Infinity o -Infinity indica una condizione di errore matematico, come la divisione per 0.

Parametri

Restituisce true se il valore è NaN (Not a Number, Non un numero). La funzione isNaN() è utile per verificare se un'espressione matematica restituisce un numero. isNaN() viene comunemente utilizzata per controllare il valore restituito dalle funzioni parseInt()e parseFloat(). Il valore NaN è un membro speciale del tipo di dati Number che rappresenta un valore diverso da un numero.

Nota: Il valore NaN non è un membro dei tipi di dati int o uint.

La tabella seguente descrive il valore restituito da isNaN() su vari tipi e valori di input. Se gli avvisi del compilatore sono impostati su Modalità rigorosa, alcune delle seguenti operazioni generano avvisi del compilatore.

Parametri

Determina se la stringa specificata è un nome valido per un elemento o un attributo XML.

Parametri

Converte un valore dato in un valore Number. La tabella seguente mostra il risultato di vari tipi di input:

Parametri

Altri esempi

Ogni valore in ActionScript 3.0 è un oggetto, il che significa che se chiamate Object() su un valore, viene restituito il valore stesso.

Parametri

Converte una stringa in un numero a virgola mobile. La funzione legge, o analizza, e restituisce i numeri in una stringa finché non trova un carattere che non fa parte del numero iniziale. Se la stringa non inizia con un numero che può essere analizzato, parseFloat() restituisce NaN. Lo spazio bianco che precede i numeri interi validi viene ignorato, allo stesso modo dei caratteri non numerici finali.

Parametri

Converte una stringa in un numero intero. Se la stringa specificata nei parametri non può essere convertita in numero, la funzione restituisce NaN. Le stringhe che iniziano con 0x vengono interpretate come numeri esadecimali. A differenza delle versioni precedenti di ActionScript, i numeri interi che iniziano con 0 non vengono interpretati come numeri ottali. Dovete specificare una radice di 8 per i numeri ottali. Lo spazio bianco e gli zeri che precedono i numeri interi validi vengono ignorati, allo stesso modo dei caratteri non numerici finali.

Parametri

Restituisce una rappresentazione sotto forma di stringa del parametro specificato.

La tabella seguente mostra il risultato di vari tipi di input:

Parametri

Altri esempi

Visualizza le espressioni, o scrive nei file di registro, durante il debug. Un'istruzione trace singola può supportare più argomenti. Se un qualsiasi argomento in un'istruzione trace include un tipo di dati diverso da String, la funzione trace richiama il metodo toString() associato per tale tipo di dati. Ad esempio, se l'argomento è un valore booleano, la funzione trace richiama Boolean.toString() e visualizza il valore restituito.

Parametri

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

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

Converte un valore numerico dato in un valore intero senza segno. I valori decimali vengono troncati in corrispondenza del separatore decimale.

La tabella seguente descrive il valore restituito da uint() su vari tipi e valori di input.

Parametri

Elementi API correlati

Valuta il parametro str come stringa, decodifica la stringa dal formato URL (convertendo tutte le sequenze esadecimali in caratteri ASCII) e restituisce la stringa.

Parametri

Crea una nuova istanza Vector i cui elementi sono istanze del tipo di dati specificato. Quando chiamate questa funzione, dovete specificare il tipo di dati degli elementi del vettore risultante (il tipo di base del vettore) utilizzando un parametro type. Questa funzione utilizza la stessa sintassi utilizzata quando si dichiara un'istanza Vector o si chiama la funzione di costruzione new Vector.<T>():

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

Il vettore risultante viene compilato con i valori presenti negli elementi dell'argomento sourceArray. Se l'argomento sourceArray è già un'istanza Vector.<T> in cui T è il tipo di base, la funzione restituisce tale vettore. Diversamente, il vettore risultante viene compilato con gli elementi dell'array sourceArray o del vettore.

In entrambi i casi, il tipo di dati di tutti gli elementi dell'argomento sourceArray deve corrispondere al tipo di base T specificato nella chiamata di funzione.

Se nell'argomento sourceArray il valore di length è pari a 0, la funzione restituisce un vettore vuoto.

Se un vettore viene passato come argomento sourceArray e il relativo tipo di base non è T oppure se viene passato un array e i relativi elementi non sono tutti istanze del tipo di dati T, viene eseguito il tentativo di convertire i valori nel tipo di base. Se i valori possono essere convertiti automaticamente, il vettore risultante contiene i valori convertiti. Se non può essere effettuata la conversione, si verifica un errore.

In modo analogo, se un elemento nell'argomento sourceArray è un'istanza di una sottoclasse del tipo di base T, la chiamata viene eseguita e l'elemento viene aggiunto al vettore risultante. Ciò è vero anche se l'argomentosourceArray è un vettore il cui tipo di base è una sottoclasse di T. Questo è infatti il solo modo di convertire un vettore con il tipo di base T in un vettore con un tipo di base corrispondente a una superclasse di T.

Il seguente codice, ad esempio, genera un errore di compilazione in modalità rigorosa oppure un TypeError in fase di runtime, in quanto tenta di assegnare Vector.<Sprite> a una variabile Vector.<DisplayObject> (Sprite è una sottoclasse di DisplayObject):

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

La seguente versione alternativa del codice copia invece correttamente gli elementi di un'istanza Vector.<Sprite> in un'istanza Vector.<DisplayObject>:

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

Parametri

Elementi API correlati

Converte un oggetto in un oggetto XML.

La tabella seguente descrive i valori restituiti per vari tipi di input.

Parametri

Altre informazioni

Elementi API correlati

Converte un oggetto in un oggetto XMLList.

La tabella seguente descrive i valori restituiti per vari tipi di input.

Parametri

Elementi API correlati