uint

Paket	Oberste Ebene
Klasse	public final class uint
Vererbung	uint Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die uint-Klasse stellt Methoden für die Arbeit mit einem Datentyp bereit, der eine vorzeichenlose 32-Bit-Ganzzahl (engl. „unsigned integer“) repräsentiert. Da eine vorzeichenlose Ganzzahl nur positiv sein kann, entspricht ihr maximaler Wert dem Doppelten des Werts der int-Klasse.

Der von der uint-Klasse repräsentierte Wertebereich liegt zwischen 0 und 4.294.967.295 (2^32-1).

Sie können ein uint-Objekt erstellen, indem Sie eine Variable vom Typ uint erstellen und der Variable einen Literalwert zuweisen. Der Standardwert einer Variable vom Typ „uint“ lautet 0.

Die uint-Klasse ist insbesondere bei der Verwendung von Pixelfarbwerten (ARGB und RGBA) nützlich sowie in anderen Situationen, bei denen der Datentyp „int“ nicht gut funktioniert. Die Zahl 0xFFFFFFFF beispielsweise, die den Farbwert Weiß mit einem Alphawert von 255 repräsentiert, lässt sich mit dem Datentyp „int“ nicht darstellen, da sie sich außerhalb des für „int“-Werte zulässigen Wertebereichs befindet.

Mit dem folgenden Beispiel wird ein uint-Objekt erstellt und die Methode toString() aufgerufen:

 var myuint:uint = 1234;
 trace(myuint.toString()); // 1234

Im folgenden Beispiel wird der Wert der Eigenschaft MIN_VALUE einer Variablen zugewiesen ohne den Konstruktor zu verwenden:

 var smallest:uint = uint.MIN_VALUE;
 trace(smallest.toString()); // 0

Beispiele anzeigen

Verwandte API-Elemente

int
Number

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		uint(num:Object) Erstellt ein neues uint-Objekt.	uint
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 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.	uint
		toFixed(fractionDigits:uint):String Gibt eine Zahl in Festkommaschreibweise als String zurück.	uint
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toPrecision(precision:uint):String Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück.	uint
		toString(radix:uint):String Gibt den Wert des uint-Objekts als String zurück.	uint
		valueOf():uint Gibt den uint-Grundwert des angegebenen uint-Objekts zurück.	uint

Öffentliche Konstanten

	Konstante		Definiert von
		MAX_VALUE : uint = 4294967295 [statisch] Die größte darstellbare vorzeichenlose 32-Bit-Ganzzahl, nämlich 4.294.967.295.	uint
		MIN_VALUE : uint = 0 [statisch] Die kleinste darstellbare vorzeichenlose Ganzzahl, nämlich 0.	uint

Konstruktordetails

()

Konstruktor

public function uint(num:Object)

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein neues uint-Objekt. Sie können eine Variable vom Typ uint erstellen und ihr einen Literalwert zuweisen. Der Konstruktor new uint() wird hauptsächlich als Platzhalter verwendet. Ein uint-Objekt entspricht nicht der Funktion uint(), die einen Parameter in einen Grundwert umwandelt.

Parameter

num:Object — Der numerische Wert des zu erstellenden uint-Objekts oder ein Wert, der in eine Zahl umgewandelt werden soll. Wird num nicht bereitgestellt, lautet der Standardwert 0.

Beispiel
Verwendung dieses Beispiels
Der folgende Code erstellt zwei neue uint-Objekte; das erste, indem ein Literalwert zugewiesen wird und das zweite, indem die Konstruktorfunktion verwendet wird:

	 var n1:uint = 3;
	 var n2:uint = new uint(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 den Wert des uint-Objekts 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 — Die Stringdarstellung des uint-Objekts.

Beispiel
Verwendung dieses Beispiels
Im folgenden Beispiel werden für die radix-Parameter die Werte 2 und 8 verwendet, und es wird ein String mit der entsprechenden Repräsentation der Zahl 9 ausgegeben.

	 var myuint:uint = 9;
	 trace(myuint.toString(2)); // 1001
	 trace(myuint.toString(8)); // 11

Das folgende Beispiel erstellt Hexadezimalwerte:

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

valueOf

()

Methode

AS3 function valueOf():uint

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Rückgabewerte

uint — Der uint-Grundwert dieses uint-Objekts.

Beispiel
Verwendung dieses Beispiels
Das folgende Beispiel gibt den Grundwert des Objekts numSocks aus.

	 var numSocks:uint = 2;
	 trace(numSocks.valueOf()); // 2

Konstantendetails

MAX_VALUE

Konstante

public static const MAX_VALUE:uint = 4294967295

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die größte darstellbare vorzeichenlose 32-Bit-Ganzzahl, nämlich 4.294.967.295.

Beispiel
Verwendung dieses Beispiels
Der folgende ActionScript-Code zeigt die den größten und kleinsten darstellbaren uint-Wert an:

	trace("uint.MIN_VALUE = " + uint.MIN_VALUE);
	trace("uint.MAX_VALUE = " + uint.MAX_VALUE);

Die Werte sind wie folgt:

	uint.MIN_VALUE = 0
	uint.MAX_VALUE = 4294967295

MIN_VALUE

Konstante

public static const MIN_VALUE:uint = 0

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die kleinste darstellbare vorzeichenlose Ganzzahl, nämlich 0.

Beispiel
Verwendung dieses Beispiels
Der folgende ActionScript-Code zeigt die den größten und kleinsten darstellbaren uint-Wert an:

	 trace("uint.MIN_VALUE = " + uint.MIN_VALUE);
	 trace("uint.MAX_VALUE = " + uint.MAX_VALUE);

Die Werte sind wie folgt:

	 uint.MIN_VALUE = 0
	 uint.MAX_VALUE = 4294967295

Beispiele Verwendung dieses Beispiels

UintExample.as

Im folgenden Beispiel wird i als Wert für ein „uint“ in einer for-Schleife deklariert, wodurch die Zahlen 0 bis geduckt werden (da der Standardwert von „uint“ 0 lautet).

package {
    import flash.display.Sprite;

    public class UintExample extends Sprite {
        public function UintExample() {
            for(var i:uint; i < 10; i++) {
                trace(i);
            }
        }
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

uint - AS3

Paketex

Sprachelemente

Anhänge

Klassen x

uint

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE