ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
Oberste Ebene 

int  - AS3

PaketOberste Ebene
Klassepublic final class int
Vererbungint Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die int-Klasse ermöglicht Ihnen die Arbeit mit einem Datentyp, der eine 32-Bit-Ganzzahl mit Vorzeichen repräsentiert. Der von der int-Klasse repräsentierte Wertebereich liegt zwischen -2.147.483.648 (-2^31) und 2.147.483.647 (2^31-1).

Die konstanten Eigenschaften der int-Klasse, MAX_VALUE MIN_VALUE, sind statisch, d. h., Sie können sie verwenden, ohne dass ein Objekt nötig ist. Somit ist kein Konstruktor erforderlich. Die Methoden sind allerdings nicht statisch, d. h., Sie benötigen ein Objekt, um sie zu verwenden. Sie können ein int-Objekt erstellen, indem Sie den int-Klassenkonstruktor verwenden oder eine Variable vom Typ int deklarieren und der Variable einen Literalwert zuweisen.

Der int-Datentyp ist nützlich für Schleifenzähler und andere Situationen, in denen keine Gleitkommazahl benötigt wird, und ähnelt dem int-Datentyp in Java und C++. Der Standardwert einer Variable vom Typ int lautet 0

Wenn Sie mit Zahlen arbeiten, die den Wert int.MAX_VALUE überschreiten, sollten Sie es in Betracht ziehen, den Datentyp Number zu verwenden.

Im folgenden Beispiel wird die Methode toString() der int-Klasse aufgerufen, die den String 1234 zurückgibt:

 var myint:int = 1234;
 myint.toString();
 

Im folgenden Beispiel wird der Wert der Eigenschaft MIN_VALUE einer Variablen zugewiesen, die ohne den Konstruktor deklariert wurde:

 var smallest:int = int.MIN_VALUE;
 

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
int(num:Object)
Konstruktor; erstellt ein neues int-Objekt.
int
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
toExponential(fractionDigits:uint):String
Gibt eine Zahl in Exponentialschreibweise als String zurück.
int
  
toFixed(fractionDigits:uint):String
Gibt eine Zahl in Festkommaschreibweise als String zurück.
int
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück.
int
  
Gibt das angegebene int-Objekt als String zurück.
int
  
Gibt den Grundwert des angegebenen int-Objekts zurück.
int
Öffentliche Konstanten
 KonstanteDefiniert von
  MAX_VALUE : int = 2147483647
[statisch] Die größte darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich 2.147.483.647.
int
  MIN_VALUE : int = -2147483648
[statisch] Die kleinste darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich -2.147.483.648.
int
Konstruktordetails

int

()Konstruktor
public function int(num:Object)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Konstruktor; erstellt ein neues int-Objekt. Wenn Sie mit int.toString() und int.valueOf() arbeiten, müssen Sie den int-Konstruktor verwenden. Wenn Sie mit den Eigenschaften eines int-Objekts arbeiten, verwenden Sie keinen Konstruktor. Der new int-Konstruktor dient hauptsächlich als Platzhalter. Ein int-Objekt entspricht nicht der Funktion int(), die einen Parameter in einen Grundwert umwandelt.

Parameter
num:Object — Der numerische Wert des zu erstellenden int-Objekts oder ein Wert, der in eine Zahl umgewandelt werden soll. Wenn value nicht angegeben wird, gilt der Standardwert 0.

Verwandte API-Elemente


Beispiel
Verwendung dieses Beispiels
Der folgende Code erstellt neue int-Objekte:
	 var n1:int = new int(3.4);
	 var n2:int = new int(-10);
	 
Methodendetails

toExponential

()Methode
AS3 function toExponential(fractionDigits:uint):String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 9, AIR 1.0, Flash Lite 4

Gibt eine Zahl in Exponentialschreibweise als String zurück. Der String enthält eine Ziffer vor der Dezimalstelle und bis zu 20 Nachkommastellen, gemäß der Angabe im Parameter fractionDigits.

Parameter

fractionDigits:uint — Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert.

Rückgabewerte
String

Auslöser
RangeError — Löst eine Ausnahme aus, wenn das Argument fractionDigits nicht zwischen 0 und 20 liegt.

Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt die Rückgabe eines Strings in Exponentialschreibweise durch toFixed(2).
var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

()Methode 
AS3 function toFixed(fractionDigits:uint):String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 9, AIR 1.0, Flash Lite 4

Gibt eine Zahl in Festkommaschreibweise als String zurück. Festkommaschreibweise bedeutet, dass der String eine bestimmte Anzahl an Nachkommastellen enthält, und zwar gemäß der Angabe im Parameter fractionDigits. Die zulässigen Werte für den Parameter fractionDigits liegen zwischen 0 und 20. Wird ein Wert außerhalb dieses Bereichs angegeben, wird eine Ausnahme ausgelöst.

Parameter

fractionDigits:uint — Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert.

Rückgabewerte
String

Auslöser
RangeError — Löst eine Ausnahme aus, wenn das Argument fractionDigits nicht zwischen 0 und 20 liegt.

Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt die Rückgabe eines Strings durch toFixed(3), mit dem auf drei Dezimalstellen aufgerundet wird.
var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

Das folgende Beispiel zeigt die Rückgabe eines Strings durch toFixed(2), mit dem nachgestellte Nullen hinzugefügt werden.
var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

()Methode 
AS3 function toPrecision(precision:uint):String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 9, AIR 1.0, Flash Lite 4

Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück. Der String enthält die im Parameter precision angegebene Anzahl an Ziffern.

Parameter

precision:uint — Eine Ganzzahl zwischen 1 und 21 (einschließlich), die die gewünschte Anzahl an Nachkommastellen für die Darstellung des Strings repräsentiert.

Rückgabewerte
String

Auslöser
RangeError — Löst eine Ausnahme aus, wenn das Argument precision nicht zwischen 1 und 21 liegt.

Beispiel  ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch toFixed(3). Der String wird in Festkommaschreibweise zurückgegeben, da Exponentialschreibweise nicht erforderlich ist.
var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch toFixed(3). Der String wird in Exponentialschreibweise zurückgegeben, da die Anzahl an Stellen der sich ergebenden Zahl nicht ausreichen für die Festkommaschreibweise.
var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

()Methode 
AS3 function toString(radix:uint):String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt das angegebene int-Objekt als String zurück.

Parameter

radix:uint — Gibt die numerische Basis (von 2 bis 36) an, die bei der Umwandlung von Zahlen in Strings verwendet werden soll. Wenn Sie den Parameter radix nicht angeben, wird als Standardwert 10 verwendet.

Rückgabewerte
String — Ein String.

Beispiel
Verwendung dieses Beispiels
Im folgenden Beispiel wird 2 und 8 für den radix-Parameter verwendet und eine Zeichenfolge ausgegeben, in der die entsprechende Angabe der Zahl 9 enthalten ist.
	 var myint:int = new int(9);
	 trace(myint.toString(2)); // 1001
	 trace(myint.toString(8)); // 11
	 

Das folgende Beispiel ergibt einen Hexadezimalwert.

	 var r:int = new int(250);
	 var g:int = new int(128);
	 var b:int = new int(114);
	 var rgb:String = "0x"+ r.toString(16)+g.toString(16)+b.toString(16);
	 trace(rgb); // 0xfa8072
	 

valueOf

()Methode 
AS3 function valueOf():int

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den Grundwert des angegebenen int-Objekts zurück.

Rückgabewerte
int — Ein int-Wert.

Beispiel
Verwendung dieses Beispiels
Das folgende Beispiel ergibt den Grundwert des numSocks-Objekts.
	 var numSocks:int = new int(2);
	 trace(numSocks.valueOf()); // 2
	 
Konstantendetails

MAX_VALUE

Konstante
public static const MAX_VALUE:int = 2147483647

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die größte darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich 2.147.483.647.


Beispiel
Verwendung dieses Beispiels
Der folgende ActionScript-Code zeigtdas größte und kleinste darstellbare „int“-Objekt im Bedienfeld „Ausgabe“ an:
	trace("int.MIN_VALUE = "+int.MIN_VALUE);
	trace("int.MAX_VALUE = "+int.MAX_VALUE);
	

Mit diesem Code werden die folgenden Werte angezeigt:

	int.MIN_VALUE = -2147483648
	int.MAX_VALUE = 2147483647
	

MIN_VALUE

Konstante 
public static const MIN_VALUE:int = -2147483648

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die kleinste darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich -2.147.483.648.


Beispiel
Verwendung dieses Beispiels
Der folgende ActionScript-Code zeigtdas größte und kleinste darstellbare „int“-Objekt im Bedienfeld „Ausgabe“ an:
     trace("int.MIN_VALUE = "+int.MIN_VALUE);
     trace("int.MAX_VALUE = "+int.MAX_VALUE);
     

Mit diesem Code werden die folgenden Werte angezeigt:

	int.MIN_VALUE = -2147483648
	int.MAX_VALUE = 2147483647
     
IntExample.as

Im folgenden Beispiel wird mithilfe der IntExample-Klasse veranschaulicht, wie Sie mit int-Datentypen arbeiten und ihre Gültigkeit prüfen:
  1. Im Konstruktor werden zwei int-Variablen a und b deklariert.
  2. Diese beiden int-Variablen werden mithilfe der Methode addIntegers() hinzugefügt.
  3. Einer dritten int-Variablen c wird das Ergebnis von parseInteger() zugewiesen. Sie überprüft die Gültigkeit des ihr übergebenen Strings, um sicherzustellen, dass es sich um eine Ganzzahl im für int-Datentypen akzeptierbaren Zahlenbereich handelt. Ist dies der Fall, wird ein „int“ gleich der Ganzzahl des Strings zurückgegeben.
  4. Die int-Variablen a und c werden mihilfe von addIntegers() hinzugefügt.
package {
    import flash.display.Sprite;

    public class IntExample extends Sprite {    
        public function IntExample() {
            var a:int = 512;
            var b:int = -128;
            
            trace(addIntegers(a, b)); // 384

            var c:int = parseInteger("32");
            
            trace(addIntegers(a, c)); // 544
        }
            
        public function addIntegers(a:int, b:int):int {
            return a + b;
        }
        
        public function parseInteger(str:String):int {
            var num:Number = parseInt(str);
            if(!isNaN(num) && num <= int.MAX_VALUE && num >= int.MIN_VALUE) {
                return int(num);
            }
            
            return 0;
        }
        
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.