Dokumentacja języka JavaScript 1.5:Obiekty:Number

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Spis treści 1 Podsumowanie 2 Tworzone przez 3 Parametry 4 Opis 5 Własności 6 Metody 7 Przykłady 7.1 Przykład: Zastosowanie obiektu Number, przy przypisaniu wartości zmiennym liczbowym 7.2 Przykład: Zastosowanie obiektu Number do modyfikacji wszystkich obiektów Number

[edytuj] Podsumowanie

Obiekt główny

Pozwala pracować z wartościami liczbowymi. Obiekt Number jest opakowaniem (ang. wrapper) dla prymitywnych wartości numerycznych.

[edytuj] Tworzone przez

Konstruktor Number:

new Number(value)

[edytuj] Parametry

value 

Wartość numeryczna tworzonego obiektu.

[edytuj] Opis

Obiekt Number jest głównie stosowany do:

• Uzyskania dostępu do jego stałych własnościach, które reprezentują najmniejszą i największa możliwą (przestawialną) liczbę, dodatnią lub ujemną nieskończoność i wartość nieliczbową (Not-a-Number).

• Aby stworzyć obiekty liczbowe do których możesz dodać własności. Najprawdopodobniej rzadko, kiedy będziesz musiał stworzyć obiekt typu Number.

Własności Number są własnościami jego klasy, nieindywidualnymi własnościami obiektu.

JavaScript 1.2: Number(x) teraz tworzy raczej NaN niż błąd jeśli x jest ciągiem znaków, który nie zawiera poprawnie sformatowanej liczby. Na przykład, poniższy kod drukuje NaN:

x=Number("three");
document.write(x + "<BR>");

Możesz przekonwertować, każdy obiekt na liczbę używając funkcji wysokiego poziomu Number.

[edytuj] Własności

constructor: Oznacza funkcję, która tworzy prototyp obiektu.

MAX_VALUE: Największa możliwa do przedstawienia liczba.

MIN_VALUE: Najmniejsza możliwa do przedstawienia liczba.

NaN: Specjalna wartość "nie jest liczbą" (Not-a-Number).

NEGATIVE_INFINITY: Specjalna wartość reprezentująca negatywną nieskończoność; zwracana przy przepełnieniu.

POSITIVE_INFINITY: Specjalna wartość reprezentująca nieskończoność; zwracana przy przepełnieniu.

prototype: Pozwala na dodawanie (tworzenie) nowych własności obiektu Number.

[edytuj] Metody

toExponential: Zwraca ciąg znaków, reprezentujący liczbę zapisaną w postaci wykładniczej.

toFixed: Zwraca ciąg znaków, reprezentujący liczbę stałoprzecinkową.

toLocaleString: Zwraca czytelny dla ludzi ciąg znaków reprezentujący liczbę zapisaną przy wykorzystaniu lokalnego formatu zapisu liczb. Przesłania metodę Object.toLocaleString.

toPrecision: Zwraca ciąg znaków reprezentujący liczbę stałoprzecinkową o podanej precyzji.

toSource: Zwraca literał obiektu reprezentujący podany obiekt Number; możesz użyć tą wartość, przy tworzeniu nowego obiektu. Przesłania metodę Object.toSource.

toString: Zwraca ciąg znaków reprezentujący podany obiekt. Przesłania metodę Object.toString.

valueOf: Zwraca zmienną typu prostego reprezentującą wartość podanego obiektu. Przesłania metodę Object.valueOf.

Dodatkowo, ten obiekt dziedziczy metody watch i unwatch z Object.

[edytuj] Przykłady

[edytuj] Przykład: Zastosowanie obiektu Number, przy przypisaniu wartości zmiennym liczbowym

Poniższy przykład używa własności obiektu Number, aby przypisać wartości do kilku wartości numerycznych:

najwiekszaLiczba = Number.MAX_VALUE;
najmniejszaLiczba = Number.MIN_VALUE;
nieskonczonosc = Number.POSITIVE_INFINITY;
negatywnaNieskonczonosc = Number.NEGATIVE_INFINITY;
nieJestLiczba = Number.NaN;

[edytuj] Przykład: Zastosowanie obiektu Number do modyfikacji wszystkich obiektów Number

Poniższy przykład tworzy obiekt typu Number, <code.mojaLiczba</code>, wtedy dodaje własność opis, wszystkim obiektom Number. Następnie wartość jest przypisana do własności opis obiektu mojaLiczba.

mojaLiczba = new Number(65);
Number.prototype.opis = null;
mojaLiczba.opis = "prędkość wiatru";