Le funzioni di primo livello o globali sono disponibili a qualunque parte di un file SWF in cui è utilizzato ActionScript o in qualunque classe definita dall'utente. La maggior parte delle funzioni globali di ActionScript 2.0 è stata trasferita (migrata) nelle classi.
Funzioni globali
 FunzioneDefinito da
  
Array(... args):Array
Crea un nuovo array.
Primo livello
  
Boolean(expression:Object):Boolean
Converte il parametro expression in un valore booleano e restituisce il valore.
Primo livello
  
Restituisce una rappresentazione in formato stringa dei valori correnti del giorno, della data, dell'ora e del fuso orario.
Primo livello
  
Decodifica in stringa un URI codificato.
Primo livello
  
Decodifica in stringa un componente URI codificato.
Primo livello
  
Codifica una stringa in un URI (Uniform Resource Identifier) valido.
Primo livello
  
Codifica una stringa in un componente URI valido.
Primo livello
  
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.
Primo livello
  
int(value:Number):int
Converte un valore numerico dato in un valore intero.
Primo livello
  
Restituisce true se il valore è un numero finito oppure false se il valore è Infinity o -Infinity.
Primo livello
  
Restituisce true se il valore è NaN (Not a Number, Non un numero).
Primo livello
  
Determina se la stringa specificata è un nome valido per un elemento o un attributo XML.
Primo livello
  
Number(expression:Object):Number
Converte un valore dato in un valore Number.
Primo livello
  
Ogni valore in ActionScript 3.0 è un oggetto, il che significa che se si chiama Object() su un valore viene restituito il valore stesso.
Primo livello
  
Converte una stringa in un numero a virgola mobile.
Primo livello
  
parseInt(str:String, radix:uint = 0):Number
Converte una stringa in un numero intero.
Primo livello
  
String(expression:Object):String
Restituisce una rappresentazione sotto forma di stringa del parametro specificato.
Primo livello
  
trace(... arguments):void
Visualizza le espressioni, o scrive nei file di registro, durante il debug.
Primo livello
  
uint(value:Number):uint
Converte un valore numerico dato in un valore intero senza segno.
Primo livello
  
Valuta il parametro str come stringa, decodifica la stringa dal formato URL (convertendo tutte le sequenze esadecimali in caratteri ASCII) e restituisce la stringa.
Primo livello
  
XML(expression:Object):XML
Converte un oggetto in un oggetto XML.
Primo livello
  
XMLList(expression:Object):XMLList
Converte un oggetto in un oggetto XMLList.
Primo livello


Le costanti di primo livello o globali sono disponibili in tutti gli script e visibili a tutte le linee temporali e aree di validità del documento.
Costanti globali
 CostanteDefinito da
  Infinity: Number
Un valore speciale che rappresenta un valore Infinity positivo.
Primo livello
  -Infinity: Number
Un valore speciale che rappresenta un valore Infinity negativo.
Primo livello
  NaN: Number
Un membro speciale del tipo di dati Number che rappresenta un valore diverso da un numero (NaN).
Primo livello
  undefined: *
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.
Primo livello
Descrizione delle costanti
InfinityCostante
public const Infinity:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Vedere anche


Esempio

Il risultato della divisione per 0 è Infinity, ma solo quando il divisore è un numero positivo.

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


-InfinityCostante 
public const -Infinity:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Vedere anche


Esempio

Il risultato della divisione per 0 è Infinity, ma solo quando il divisore è un numero negativo.

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


NaNCostante 
public const NaN:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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 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, utilizzare isNaN().

Vedere anche

undefinedCostante 
public const undefined:*

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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:

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:

Non confondere 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.

Vedere anche


Esempio

Nell'esempio seguente la variabile senza tipo myVar viene dichiarata ma non inizializzata. Il valore di myVar è undefined in quanto la variabile è senza tipo. Ciò si verifica se la variabile non ha l'annotazione del tipo o se utilizza l'annotazione speciale senza tipo (*) (var myVar:*;).

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

Questa regola si applica anche alle proprietà non inizializzate di un oggetto dinamico. Ad esempio, data un'istanza obj della classe dinamica A, il valore di obj.propName, che è una proprietà non inizializzata dell'istanza obj, è undefined.

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

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

Dettagli delle funzioni
Array()funzione
public function Array(... args):Array

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un nuovo array. L'array può avere una lunghezza pari a zero o a un valore superiore, oppure può essere un array compilato da un elenco di elementi specificati, possibilmente di tipi di dati diversi. Il numero e il tipo di dati degli argomenti utilizzati per determinare il contenuto dell'array restituito.

L'utilizzo della funzione Array() è simile alla creazione di un array con la funzione di costruzione della classe Array.

Utilizzare 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, consultare la sezione Esempio di questa voce:

Parametri

... args — È possibile non passare alcun argomento per un array vuoto, passare un argomento singolo costituito da un numero intero per un array con una lunghezza specifica oppure passare una serie di valori separati da virgole di vari tipi per un array compilato con tali valori.

Restituisce
Array — Un array con una lunghezza pari a zero o a un valore superiore.

Vedere anche


Esempio

L'esempio seguente mostra il comportamento della funzione Array() nel caso in cui un argomento non sia un valore di base. Un uso comune dell'inserimento in un array è la conversione di un'istanza Object che memorizza i propri valori in formato array. Se si chiama Array() con un argomento di tipo Object o un altro tipo di dati di base, il riferimento all'oggetto viene memorizzato in un elemento del nuovo array. In altre parole, se l'unico argomento viene passato come oggetto, il riferimento a tale oggetto diventa il primo elemento del nuovo array.
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

Per inserire obj in un array, utilizzare l'operatore as che restituisce un riferimento all'array se obj è un array valido o, in caso contrario, 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()funzione 
public function Boolean(expression:Object):Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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:

Valore di inputEsempioValore restituito
0Boolean(0)false
NaNBoolean(NaN)false
Numero (diverso da 0 o NaN)Boolean(4)true
Stringa vuotaBoolean("")false
Stringa non vuotaBoolean("6")true
nullBoolean(null)false
undefinedBoolean(undefined)false
Istanza della classe ObjectBoolean(new Object())true
Nessun argomentoBoolean()false

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

Parametri

expression:Object — Un'espressione o un oggetto da convertire in Boolean.

Restituisce
Boolean — Il risultato della conversione in Boolean.

Vedere anche

Date()funzione 
public function Date():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una rappresentazione in formato stringa dei valori correnti del giorno, della data, dell'ora e del fuso orario. Il formato data per l'output è:

     Gio Mes Data HH:MM:SS TZD AAAA
     

Ad esempio:

     Mer Apr 12 15:30:17 GMT-0700 2006.
     

Per inserire un valore nel tipo Date, utilizzare x as Date invece di Date(x).

Restituisce
String — La data corrente sotto forma di tipo di dati String. Il valore restituito per Date() è lo stesso valore restituito per Date.toString().

Vedere anche

decodeURI()funzione 
public function decodeURI(uri:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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. Utilizzare decodeURIComponent() per decodificare le sequenze di escape di questa tabella.

Sequenze di escape non codificateCaratteri equivalenti
%23#
%24$
%26&
%2B+
%2C,
%2F/
%3A:
%3B;
%3D=
%3F?
%40@

Parametri

uri:String — Una stringa codificata con la funzione encodeURI.

Restituisce
String — Restituisce una stringa in cui tutti i caratteri a cui è stata precedentemente assegnata una sequenza di escape dalla funzione encodeURI vengono riportati alla rappresentazione senza sequenza di escape.

Vedere anche


Esempio

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()funzione 
public function decodeURIComponent(uri:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

uri:String — Una stringa codificata con la funzione encodeURIComponent.

Restituisce
String — Restituisce una stringa in cui tutti i caratteri a cui è stata precedentemente assegnata una sequenza di escape dalla funzione encodeURIComponent vengono riportati alla rappresentazione senza sequenza di escape.

Vedere anche

encodeURI()funzione 
public function encodeURI(uri:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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.

Caratteri non codificati
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
; / ? : @ & = + $ , #
- _. ! ~ * ' ( )

Parametri

uri:String — Una stringa che rappresenta un URI completo.

Restituisce
String — Una stringa con determinati caratteri codificati come sequenze di escape UTF-8.

Vedere anche


Esempio

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()funzione 
public function encodeURIComponent(uri:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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.

Caratteri non codificati
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
- _. ! ~ * ' ( )

Parametri

uri:String — Una stringa che rappresenta un URI completo.

Restituisce
String — Una stringa con determinati caratteri codificati come sequenze di escape UTF-8.

Vedere anche

escape()funzione 
public function escape(str:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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().

Caratteri non codificati
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
@ - _. * + /

Parametri

str:String — L'espressione che consente di convertire in stringa e codificare in formato URL.

Restituisce
String — Una stringa con codifica URL.

Vedere anche

int()funzione 
public function int(value:Number):int

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Parametri

value:Number — Un valore da convertire in un numero intero.

Restituisce
int — Il valore intero convertito.

Vedere anche

isFinite()funzione 
public function isFinite(num:Number):Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

num:Number — Un numero da valutare come finito o infinito.

Restituisce
Boolean — Restituisce true se si tratta di un numero finito oppure false se si tratta di un valore infinito o infinito negativo.
isNaN()funzione 
public function isNaN(num:Number):Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Tipo/valore di inputEsempioValore restituito
0 diviso per 0isNaN(0/0)true
Numero diverso da zero diviso per 0isNaN(5/0)false
Radice quadrata di un numero negativoisNaN(Math.sqrt(-1))true
Seno dell'arco di un numero maggiore di 1 o minore di 0isNaN(Math.asin(2))true
Stringa che può essere convertita in NumberisNaN("5")false
Stringa che non può essere convertita in NumberisNaN("5a")true

Parametri

num:Number — Un valore numerico o un'espressione matematica da valutare.

Restituisce
Boolean — Restituisce true se il valore è NaN (Not a Number, Non un numero) e false in caso contrario.
isXMLName()funzione 
public function isXMLName(str:String):Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Parametri

str:String — Una stringa da valutare.

Restituisce
Boolean — Restituisce true se l'argomento str è un nome XML valido; false in caso contrario.
Number()funzione 
public function Number(expression:Object):Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Tipo/valore di inputEsempioValore restituito
undefinedNumber(undefined)NaN
nullNumber(null)0
trueNumber(true)1
falseNumber(false)0
NaNNumber(NaN)NaN
Stringa vuotaNumber("")0
Stringa che converte in NumberNumber("5")Il numero (ad esempio, 5)
Stringa che non converte in NumberNumber("5a")NaN

Parametri

expression:Object — Un valore da convertire in un numero.

Restituisce
Number — Il valore Number convertito.

Vedere anche

Object()funzione 
public function Object(value:Object):Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Parametri

value:Object — Un oggetto o un valore Number, String o Boolean da convertire.

Restituisce
Object — Il valore specificato dal parametro value.

Vedere anche

parseFloat()funzione 
public function parseFloat(str:String):Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

str:String — La stringa da leggere e convertire in numero a virgola mobile.

Restituisce
Number — Un numero o NaN (Not a Number, Non un numero).
parseInt()funzione 
public function parseInt(str:String, radix:uint = 0):Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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. È necessario 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

str:String — Una stringa da convertire in numero intero.
 
radix:uint (default = 0) — Un numero intero che rappresenta la radice (base) del numero da analizzare. I valori accettabili sono quelli compresi tra 2 e 36.

Restituisce
Number — Un numero o NaN (Not a Number, Non un numero).
String()funzione 
public function String(expression:Object):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una rappresentazione sotto forma di stringa del parametro specificato.

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

Tipo/valore di inputValore restituito
undefinedundefined
null"null"
true"true"
false"false"
NaN"NaN"
StringString
ObjectObject.toString()
NumberRappresentazione in formato stringa del numero

Parametri

expression:Object — Espressione che consente di convertire in stringa.

Restituisce
String — Una rappresentazione in formato stringa del valore passato per il parametro expression.

Vedere anche

trace()funzione 
public function trace(... arguments):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

... arguments — Una o più espressioni (separate da virgola) da valutare. In caso di espressioni multiple, nell'output viene inserito uno spazio tra un'espressione e l'altra.


Esempio

L'esempio seguente utilizza la classe TraceExample per mostrare come è possibile utilizzare il metodo trace() per stampare una stringa semplice. In genere, il messaggio viene stampato su una console di debug.
package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}
uint()funzione 
public function uint(value:Number):uint

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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.

Tipo/valore di inputEsempioValore restituito
undefineduint(undefined)0
nulluint(null)0
0uint(0)0
NaNuint(NaN)0
Un numero a virgola mobile positivo.uint(5,31)Numero intero senza segno troncato (ad esempio, 5)
Un numero a virgola mobile negativo.uint(-5,78)Esegue un troncamento per ottenere un numero, quindi applica la regola per i numeri interi negativi
Numero intero negativouint(-5)Somma di uint.MAX_VALUE e del numero intero negativo (ad esempio, uint.MAX_VALUE + (-5))
trueuint(true)1
falseuint(false)0
Stringa vuotauint("")0
Stringa che converte in Numberuint("5")Il valore number
Stringa che non converte in Numberuint("5a")0

Parametri

value:Number — Un valore da convertire in un numero intero.

Restituisce
uint — Il valore intero convertito.

Vedere anche

unescape()funzione 
public function unescape(str:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

str:String — Una stringa con sequenze esadecimali da decodificare mediante escape.

Restituisce
String — Una stringa decodificata di un parametro in formato URL.
XML()funzione 
public function XML(expression:Object):XML

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Converte un oggetto in un oggetto XML.

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

Tipo di parametroValore restituito
BooleanIl valore viene convertito prima in una stringa e successivamente in un oggetto XML.
NullSi verifica un errore di runtime (eccezione TypeError).
NumberIl valore viene convertito prima in una stringa e successivamente in un oggetto XML.
ObjectConverte in XML solo se il valore è di tipo String, Number o Boolean. In caso contrario, si verifica un errore di runtime (eccezione TypeError).
StringIl valore viene convertito in XML.
UndefinedSi verifica un errore di runtime (eccezione TypeError).
XMLIl valore di input viene restituito invariato.
XMLListRestituisce un oggetto XML solo se l'oggetto XMLList contiene una sola proprietà di tipo XML. In caso contrario, si verifica un errore di runtime (eccezione TypeError).

Parametri

expression:Object — L'oggetto da convertire in XML.

Restituisce
XML — Un oggetto XML che contiene valori contenuti nell'oggetto convertito.

Vedere anche

XMLList()funzione 
public function XMLList(expression:Object):XMLList

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Converte un oggetto in un oggetto XMLList.

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

Tipo di parametroValore restituito
BooleanIl valore viene convertito prima in una stringa e successivamente in un oggetto XMLList.
NullSi verifica un errore di runtime (eccezione TypeError).
NumberIl valore viene convertito prima in una stringa e successivamente in un oggetto XMLList.
ObjectConverte in XMLList solo se il valore è di tipo String, Number o Boolean. In caso contrario, si verifica un errore di runtime (eccezione TypeError).
StringIl valore viene convertito in un oggetto XMLList.
UndefinedSi verifica un errore di runtime (eccezione TypeError).
XMLIl valore viene convertito in un oggetto XMLList.
XMLListIl valore di input viene restituito invariato.

Parametri

expression:Object — L'oggetto da convertire in un oggetto XMLList.

Restituisce
XMLList — Un oggetto XMLList che contiene valori contenuti nell'oggetto convertito.

Vedere anche

 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/package.html