ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
Najwyższy poziom 

int  - AS3

PakietNajwyższy poziom
Klasapublic final class int
Dziedziczenieint Inheritance Object

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Klasa int umożliwia pracę z typem danych reprezentującym 32-bitowe liczby całkowite (ze znakiem). Klasa int reprezentuje wartości z zakresu od 2 147 483 648 (-2^31) do 2 147 483 647 (2^31-1).

Właściwości stałe klasy int, MAX_VALUE oraz MIN_VALUE, to właściwości statyczne, co oznacza, że ich użycie nie wymaga obiektu, a więc i konstruktora. Jednakże metody nie są statyczne, co oznacza, że ich zastosowanie wymaga użycia obiektu. Obiekt int można utworzyć za pomocą konstruktora klasy int lub poprzez deklarację zmiennej typu int i przypisanie do niej literału.

Typ danych int sprawdza się w przypadku liczników pętli i w sytuacjach, które nie wymagają użycia liczby zmiennoprzecinkowej i jest podobny do typu danych int wykorzystywanych w językach Java i C++. Wartość domyślna dla zmiennej określonej jako typ int to 0

W przypadku liczb, które przekraczają wartość int.MAX_VALUE należy rozważyć użycie typu Number.

Poniższy przykład ilustruje wywołanie metody toString() klasy int, która zwraca ciąg 1234:

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

Poniższy przykład ilustruje przypisanie, bez użycia konstruktora, wartości właściwości MIN_VALUE do deklarowanej zmiennej:

 var smallest:int = int.MIN_VALUE;
 

Wyświetl przykłady

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
Metody publiczne
 MetodaZdefiniowane przez
  
int(num:Object)
Konstruktor; tworzy nowy obiekt int.
int
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
  
toExponential(fractionDigits:uint):String
Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej.
int
  
toFixed(fractionDigits:uint):String
Zwraca ciąg znaków reprezentujący liczbę w notacji dziesiętnej.
int
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
  
Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej lub dziesiętnej.
int
  
Zwraca ciąg znaków reprezentujący obiekt int.
int
  
Zwraca pierwotną wartość określonego obiektu int.
int
Stałe publiczne
 StałaZdefiniowane przez
  MAX_VALUE : int = 2147483647
[statyczny] Największa 32-bitowa liczba całkowita, czyli 2147483647.
int
  MIN_VALUE : int = -2147483648
[statyczny] Najmniejsza 32-bitowa liczba całkowita, czyli –2147483648.
int
Konstruktor Szczegół

int

()Konstruktor
public function int(num:Object)

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Konstruktor; tworzy nowy obiekt int. W przypadku korzystania z metod int.toString() i int.valueOf() należy użyć konstruktora int. Konstruktora nie używa się w przypadku korzystania z właściwości obiekty int. Konstruktor new int jest zazwyczaj używany jako element zastępczy. Obiekt int nie jest równoważny funkcji int() konwertującej parametr na wartość pierwotną.

Parametry
num:Object — Wartość liczbowa utworzonego obiektu int lub wartość konwertowana na liczbę. Jeśli parametr value nie zostanie określony, wartością domyślną będzie 0.

Powiązane elementy interfejsu API


Przykład
Sposób korzystania z tego przykładu
Za pomocą poniższego kodu można utworzyć nowe obiekty int:
	 var n1:int = new int(3.4);
	 var n2:int = new int(-10);
	 
Szczegół metody

toExponential

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej. Ciąg znaków zawiera jedną cyfrę przed przecinkiem i do 20 cyfr po przecinku określonych za pomocą parametru fractionDigits.

Parametry

fractionDigits:uint — Liczba całkowita z zakresu od 0 do 20 włącznie, która reprezentuje żądaną liczbę miejsc dziesiętnych.

Zwraca
String

Zgłasza
RangeError — Generuje wyjątek, jeśli argument fractionDigits znajduje się poza zakresem wartości od 0 do 20.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zwrot za pomocą metody toExponential(2) ciągu znaków w notacji wykładniczej.
var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków reprezentujący liczbę w notacji dziesiętnej. Notacja dziesiętna oznacza, że po przecinku ciąg będzie zawierał daną liczbę cyfr określoną za pomocą parametru fractionDigits. Zakres poprawnych wartości dla parametru fractionDigits to wartości od 0 do 20. Określenie wartości spoza tego zakresu wygeneruje wyjątek.

Parametry

fractionDigits:uint — Liczba całkowita z zakresu od 0 do 20 włącznie, która reprezentuje żądaną liczbę miejsc dziesiętnych.

Zwraca
String

Zgłasza
RangeError — Generuje wyjątek, jeśli argument fractionDigits znajduje się poza zakresem wartości od 0 do 20.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zwrot za pomocą metody toFixed(3) ciągu liczb, który jest zaokrąglany do trzech miejsc po przecinku.
var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

Poniższy przykład ilustruje zwrot za pomocą metody toFixed(2) ciągu liczb z dodanymi kończącymi zerami.
var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej lub dziesiętnej. Ciąg będzie zawierał liczbę cyfr określoną za pomocą parametru precision.

Parametry

precision:uint — Liczba całkowita z zakresu od 1 do 21 włącznie, określająca żądaną liczbę cyfr, które wynikowy ciąg znaków będzie zawierał.

Zwraca
String

Zgłasza
RangeError — Generuje wyjątek, jeśli argument precision znajduje się poza zakresem wartości od 1 do 21.

Przykład  ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zwrot za pomocą metody toPrecision(3) ciągu tylko trzech cyfr. Ciąg jest w notacji dziesiętnej, ponieważ notacja wykładnicza nie jest konieczna.
var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

Poniższy przykład ilustruje zwracanie za pomocą metody toPrecision(3) ciągu tylko trzech cyfr. Ciąg jest w notacji wykładniczej, ponieważ dla dziesiętnej notacji liczby wynikowej nie określono wystarczającej liczby miejsc dziesiętnych.
var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca ciąg znaków reprezentujący obiekt int.

Parametry

radix:uint — Określa wartość liczbową podstawy obliczeń (od 2 do 36) wykorzystywaną do konwersji liczby na ciąg znaków. Jeśli parametr radix nie został określony, wartością domyślną jest 10.

Zwraca
String — Ciąg znaków.

Przykład
Sposób korzystania z tego przykładu
Poniższy przykład ilustruje użycie liczb 2 i 8 dla parametru radix i zwrot ciągu z odpowiednią reprezentacją liczby 9:
	 var myint:int = new int(9);
	 trace(myint.toString(2)); // 1001
	 trace(myint.toString(8)); // 11
	 

Poniższy przykład ilustruje rezultaty o wartości szesnastkowej.

	 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

()metoda 
AS3 function valueOf():int

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca pierwotną wartość określonego obiektu int.

Zwraca
int — Wartość int.

Przykład
Sposób korzystania z tego przykładu
Poniższy przykład ilustruje rezultaty o wartości pierwotnej dla obiektu numSocks.
	 var numSocks:int = new int(2);
	 trace(numSocks.valueOf()); // 2
	 
Szczegół stałej

MAX_VALUE

Stała
public static const MAX_VALUE:int = 2147483647

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Największa 32-bitowa liczba całkowita, czyli 2147483647.


Przykład
Sposób korzystania z tego przykładu
Poniższe narzędzie ActionScript wyświetla/ największy i najmniejszy możliwy do zakodowania obiekt int w panelu Wyjście:
	trace("int.MIN_VALUE = "+int.MIN_VALUE);
	trace("int.MAX_VALUE = "+int.MAX_VALUE);
	

Ten kod /wyświetla następujące wartości:

	int.MIN_VALUE = -2147483648
	int.MAX_VALUE = 2147483647
	

MIN_VALUE

Stała 
public static const MIN_VALUE:int = -2147483648

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Najmniejsza 32-bitowa liczba całkowita, czyli -2147483648.


Przykład
Sposób korzystania z tego przykładu
Poniższe narzędzie ActionScript wyświetla/ największy i najmniejszy możliwy do zakodowania obiekt int w panelu Wyjście:
     trace("int.MIN_VALUE = "+int.MIN_VALUE);
     trace("int.MAX_VALUE = "+int.MAX_VALUE);
     

Ten kod /wyświetla następujące wartości:

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

Poniższy przykład ilustruje sposób użycia klasy IntExample i sprawdzenia poprawności typów danych int:
  1. Dla konstruktora deklarowane są dwie zmienne int: a i b.
  2. Te dwie zmienne int są dodawane za pomocą metody addIntegers().
  3. Trzecia zmienna c jest przypisywana do rezultatu metody parseInteger() sprawdzającej poprawność przekazanego jej ciągu znaków, który powinien być liczbą całkowitą z zakresu dopuszczalnego dla typów danych int. Jeśli ta wartość jest poprawna, zwracana wartość int równa jest wartości liczby całkowitej ciągu znaków.
  4. Zmienne int a i c są dodawane do siebie za pomocą metody addIntegers().
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 ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.