| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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()); // Ausgabe: 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()); // Ausgabe: 0
Beispiele anzeigen
public function uint(num:Object)
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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.
|
Siehe auch
Beispiel
Verwendung von Beispielen
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);
AS3 function toExponential(fractionDigits:uint):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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
Auslöser
| RangeError — Löst eine Ausnahme aus, wenn das Argument fractionDigits nicht zwischen 0 und 20 liegt.
|
Beispiel
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
AS3 function toFixed(fractionDigits:uint):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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
Auslöser
| RangeError — Löst eine Ausnahme aus, wenn das Argument fractionDigits nicht zwischen 0 und 20 liegt.
|
Beispiel
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
AS3 function toPrecision(precision:uint):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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
Auslöser
| RangeError — Löst eine Ausnahme aus, wenn das Argument precision nicht zwischen 1 und 21 liegt.
|
Beispiel
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
AS3 function toString(radix:uint):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
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 von Beispielen
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)); // Ausgabe: 1001
trace(myuint.toString(8)); // Ausgabe: 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
AS3 function valueOf():uint
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den uint-Grundwert des angegebenen uint-Objekts zurück.
Rückgabewerte
| uint — Der uint-Grundwert dieses uint-Objekts.
|
Beispiel
Verwendung von Beispielen
Das folgende Beispiel gibt den Grundwert des Objekts
numSocks aus.
var numSocks:uint = 2;
trace(numSocks.valueOf()); // 2
public static const MAX_VALUE:uint = 4294967295
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die größte darstellbare vorzeichenlose 32-Bit-Ganzzahl, nämlich 4.294.967.295.
Beispiel
Verwendung von Beispielen
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
public static const MIN_VALUE:uint = 0
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die kleinste darstellbare vorzeichenlose Ganzzahl, nämlich 0.
Beispiel
Verwendung von Beispielen
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
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);
}
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 2:03 AM GMT-07:00
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/uint.html