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.
| Funzione | Definito da | ||
|---|---|---|---|
Crea un nuovo array. | Primo livello | ||
Converte il parametro expression in un valore booleano e restituisce il valore. | 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 | ||
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 | ||
Converte un valore dato in un valore Number. | Primo livello | ||
Ogni valore in ActionScript 3.0 è un oggetto, il che significa che se chiamate Object() su un valore, viene restituito il valore stesso. | Primo livello | ||
Converte una stringa in un numero a virgola mobile. | Primo livello | ||
Converte una stringa in un numero intero. | Primo livello | ||
Restituisce una rappresentazione sotto forma di stringa del parametro specificato. | Primo livello | ||
Visualizza le espressioni, o scrive nei file di registro, durante il debug. | Primo livello | ||
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 | ||
Crea una nuova istanza Vector i cui elementi sono istanze del tipo di dati specificato. | Primo livello | ||
Converte un oggetto in un oggetto XML. | Primo livello | ||
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.
| Costante | Definito 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 | ||
-Infinity | Costante |
public const -Infinity:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Un valore speciale che rappresenta un valore Infinity negativo. Il valore di questa costante è uguale a Number.NEGATIVE_INFINITY.
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Infinity, ma solo quando il divisore è un numero negativo.
trace(0 / 0); // NaN trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
Infinity | Costante |
public const Infinity:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9 |
Un valore speciale che rappresenta un valore Infinity positivo. Il valore di questa costante è uguale a Number.POSITIVE_INFINITY.
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
Infinity, ma solo quando il divisore è un numero positivo.
trace(0 / 0); // NaN trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
NaN | Costante |
public const NaN:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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 risultato della divisione per 0 è
NaNsolo se anche il divisore è 0. Se il divisore è maggiore di 0, il risultato della divisione per 0 èInfinity-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).
Infinitysottratto daInfinity.Infinityo-Infinitydiviso perInfinityo-Infinity.Infinityo-Infinitymoltiplicato 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
undefined | Costante |
public const undefined:*| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, 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:
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"(undefinedviene convertito in stringa). - Il valore restituito da
Number(undefined)èNaN. - Il valore restituito da
int(undefined)euint(undefined)è 0. - Il valore restituito da
Object(undefined)è una nuova istanza Object. - Quando il valore
undefinedviene 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
Esempio ( Come utilizzare questo esempio )
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
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
Array | () | funzione |
public function Array(... args):Array| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Array() è simile alla creazione di un array con la funzione di costruzione di classi Array, ma la funzione Array() ammette un solo valore di parametro oppure nessun valore. Non è possibile utilizzare la funzione Array() per compilare il nuovo array con diversi valori.
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
... args — Potete non passare alcun argomento per un array vuoto, passare un argomento composto da un singolo intero per un array di lunghezza specifica oppure passare un oggetto singolo per creare un array contenente tale oggetto.
|
Array — Un array con una lunghezza pari a zero o a un valore superiore.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
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 chiamate 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
obj in un array, utilizzate 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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 input | Esempio | Valore restituito |
|---|---|---|
0 | Boolean(0) | false |
NaN | Boolean(NaN) | false |
Numero (diverso da 0 o NaN) | Boolean(4) | true |
| Stringa vuota | Boolean("") | false |
| Stringa non vuota | Boolean("6") | true |
null | Boolean(null) | false |
undefined | Boolean(undefined) | false |
| Istanza della classe Object | Boolean(new Object()) | true |
| Nessun argomento | Boolean() | 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.
|
Boolean — Il risultato della conversione in Boolean.
|
decodeURI | () | funzione |
public function decodeURI(uri:String):String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
| Sequenze di escape non codificate | Caratteri equivalenti |
|---|---|
%23 | # |
%24 | $ |
%26 | & |
%2B | + |
%2C | , |
%2F | / |
%3A | : |
%3B | ; |
%3D | = |
%3F | ? |
%40 | @ |
Parametri
uri:String — Una stringa codificata con la funzione encodeURI.
|
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.
|
Elementi API correlati
Esempio ( Come utilizzare questo 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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
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.
|
Elementi API correlati
encodeURI | () | funzione |
public function encodeURI(uri:String):String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
String — Una stringa con determinati caratteri codificati come sequenze di escape UTF-8.
|
Elementi API correlati
Esempio ( Come utilizzare questo 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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 |
String |
Elementi API correlati
escape | () | funzione |
public function escape(str:String):String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 |
@ - _ . * + / |
Nota: utilizzate la funzione encodeURIComponent() invece di escape() per elaborare caratteri di separazione speciali (@ + /) come testo normale da codificare.
Parametri
str:String — L'espressione che consente di convertire in stringa e codificare in formato URL.
|
String — Una stringa con codifica URL.
|
Elementi API correlati
int | () | funzione |
public function int(value:Number):int| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
int — Il valore intero convertito.
|
Elementi API correlati
isFinite | () | funzione |
public function isFinite(num:Number):Boolean| Versione linguaggio: | ActionScript 3.0. |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
| Tipo/valore di input | Esempio | Valore restituito |
|---|---|---|
| 0 diviso per 0 | isNaN(0/0) | true |
Numero diverso da zero diviso per 0 | isNaN(5/0) | false |
| Radice quadrata di un numero negativo | isNaN(Math.sqrt(-1)) | true |
| Seno dell'arco di un numero maggiore di 1 o minore di 0 | isNaN(Math.asin(2)) | true |
| Stringa che può essere convertita in Number | isNaN("5") | false |
| Stringa che non può essere convertita in Number | isNaN("5a") | true |
Parametri
num:Number — Un valore numerico o un'espressione matematica da valutare.
|
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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se la stringa specificata è un nome valido per un elemento o un attributo XML.
Parametri
str:String — Una stringa da valutare.
|
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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Converte un valore dato in un valore Number. La tabella seguente mostra il risultato di vari tipi di input:
| Tipo/valore di input | Esempio | Valore restituito |
|---|---|---|
undefined | Number(undefined) | NaN |
null | Number(null) | 0 |
true | Number(true) | 1 |
false | Number(false) | 0 |
NaN | Number(NaN) | NaN |
| Stringa vuota | Number("") | 0 |
| Stringa che viene convertita in Number | Number("5") | Il numero (ad esempio, 5) |
| Stringa che non viene convertita in Number | Number("5a") | NaN |
Parametri
expression:Object — Un valore da convertire in un numero.
|
Number — Il valore Number convertito
|
Altri esempi
Object | () | funzione |
public function Object(value:Object):Object| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ogni valore in ActionScript 3.0 è un oggetto, il che significa che se chiamate Object() su un valore, viene restituito il valore stesso.
Parametri
value:Object — Un oggetto o un valore Number, String o Boolean da convertire.
|
Object — Il valore specificato dal parametro value.
|
parseFloat | () | funzione |
public function parseFloat(str:String):Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
str:String — Una stringa da convertire in numero intero.
| |
radix:uint (default = 0) |
Number — Un numero o NaN (Not a Number, Non un numero).
|
String | () | funzione |
public function String(expression:Object):String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce una rappresentazione sotto forma di stringa del parametro specificato.
La tabella seguente mostra il risultato di vari tipi di input:
| Tipo/valore di input | Valore restituito |
|---|---|
undefined | undefined |
null | "null" |
true | "true" |
false | "false" |
NaN | "NaN" |
| String | String |
| Object | Object.toString() |
| Number | Rappresentazione in formato stringa del numero |
Parametri
expression:Object — Espressione che consente di convertire in stringa.
|
String — Una rappresentazione in formato stringa del valore passato per il parametro expression.
|
Altri esempi
trace | () | funzione |
public function trace(... arguments):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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 ( Come utilizzare questo esempio )
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 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 input | Esempio | Valore restituito |
|---|---|---|
undefined | uint(undefined) | 0 |
null | uint(null) | 0 |
0 | uint(0) | 0 |
NaN | uint(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 negativo | uint(-5) | Somma di uint.MAX_VALUE e del numero intero negativo (ad esempio, uint.MAX_VALUE + (-5)) |
true | uint(true) | 1 |
false | uint(false) | 0 |
| Stringa vuota | uint("") | 0 |
| Stringa che viene convertita in Number | uint("5") | Il valore number |
| Stringa che non viene convertita in Number | uint("5a") | 0 |
Parametri
value:Number — Un valore da convertire in un numero intero.
|
uint — Il valore intero convertito.
|
Elementi API correlati
unescape | () | funzione |
public function unescape(str:String):String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
String — Una stringa decodificata di un parametro in formato URL.
|
Vector | () | funzione |
public function Vector(sourceArray:Object):Vector.<T>| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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
sourceArray:Object — Un'istanza Array o Vector i cui elementi diventano gli elementi del vettore risultante. Se l'argomento è un'istanza Vector il cui tipo di dati associato è lo stesso del tipo di dati specificato, l'argomento viene restituito come risultato della funzione.
|
Vector.<T> — Un'istanza Vector compilata con gli elementi dell'array sourceArray.
|
Genera
TypeError — Se l'argomento sourceArray contiene un elemento che non può essere convertito nel tipo di dati specificato.
|
Elementi API correlati
XML | () | funzione |
public function XML(expression:Object):XML| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Converte un oggetto in un oggetto XML.
La tabella seguente descrive i valori restituiti per vari tipi di input.
| Tipo di parametro | Valore restituito |
|---|---|
| Boolean | Il valore viene convertito prima in una stringa e successivamente in un oggetto XML. |
| Null | Si verifica un errore di runtime (eccezione TypeError). |
| Number | Il valore viene convertito prima in una stringa e successivamente in un oggetto XML. |
| Object | Converte in XML solo se il valore è di tipo String, Number o Boolean. In caso contrario, si verifica un errore di runtime (eccezione TypeError). |
| String | Il valore viene convertito in XML. |
| Undefined | Si verifica un errore di runtime (eccezione TypeError). |
| XML | Il valore di input viene restituito invariato. |
| XMLList | Restituisce 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.
|
XML — Un oggetto XML che contiene valori contenuti nell'oggetto convertito.
|
Altre informazioni
Elementi API correlati
XMLList | () | funzione |
public function XMLList(expression:Object):XMLList| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Converte un oggetto in un oggetto XMLList.
La tabella seguente descrive i valori restituiti per vari tipi di input.
| Tipo di parametro | Valore restituito |
|---|---|
| Boolean | Il valore viene convertito prima in una stringa e successivamente in un oggetto XMLList. |
| Null | Si verifica un errore di runtime (eccezione TypeError). |
| Number | Il valore viene convertito prima in una stringa e successivamente in un oggetto XMLList. |
| Object | Converte in XMLList solo se il valore è di tipo String, Number o Boolean. In caso contrario, si verifica un errore di runtime (eccezione TypeError). |
| String | Il valore viene convertito in un oggetto XMLList. |
| Undefined | Si verifica un errore di runtime (eccezione TypeError). |
| XML | Il valore viene convertito in un oggetto XMLList. |
| XMLList | Il valore di input viene restituito invariato. |
Parametri
expression:Object — L'oggetto da convertire in un oggetto XMLList.
|
XMLList — Un oggetto XMLList che contiene valori contenuti nell'oggetto convertito.
|
Elementi API correlati
Tue Jun 12 2018, 03:02 PM Z