パッケージトップレベル
public final class Number
継承Number Inheritance Object

IEEE-754 倍精度浮動小数点数を表すデータ型です。Number クラスに関連するメソッドとプロパティを使用してプリミティブな数値を処理することができます。このクラスは、JavaScript の Number クラスと同じです。

Number クラスのプロパティは静的であるため、プロパティを使用するためのオブジェクトは不要で、コンストラクタを使用する必要はありません。

Number データ型は、倍精度 IEEE-754 規格に準拠します。

Number データ型は、浮動小数値を使用する必要がある場合に便利です。Flash Player は Number よりも int および uint データ型を効率的に処理しますが、必要な値の範囲が int および uint の各データ型の有効範囲を超える場合は Number が便利です。Number クラスは、int および uint の各データ型の有効範囲を大きく超える整数値を表す場合に使用できます。整数値を表すのに int および uint では 32 ビットを使用できるのに対し、Number データ型は最大 53 ビットを使用することができます。Number 型として型指定されている変数のデフォルト値は NaN (非数) です。

例の表示

関連項目

int
uint
データ型の詳細
型変換


パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義
  Number(num:Object)
指定された値を持つ Number オブジェクトを作成します。
Number
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 InheritedisPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  toExponential(fractionDigits:uint):String
数値のストリング表現を指数表現で返します。
Number
  toFixed(fractionDigits:uint):String
数値のストリング表現を固定小数点表現で返します。
Number
  toPrecision(precision:uint):String
数値のストリング表現を指数表現または固定小数点表現で返します。
Number
  toString(radix:Number = 10):String
指定された Number オブジェクト (myNumber) のストリング表現を返します。
Number
  valueOf():Number
指定された Number オブジェクトのプリミティブな値のタイプを返します。
Number
パブリック定数
 定数定義
  MAX_VALUE : Number
[static] 表現可能な最大の数値 (倍精度 IEEE-754) です。
Number
  MIN_VALUE : Number
[static] 0 以外の正の値で、表現可能な最小の数値 (倍精度 IEEE-754) です。
Number
  NaN : Number
[static] 非数 (NaN) を表す IEEE-754 の値です。
Number
  NEGATIVE_INFINITY : Number
[static] 負の無限大を表す IEEE-754 値を指定します。
Number
  POSITIVE_INFINITY : Number
[static] 正の無限大を表す IEEE-754 値を指定します。
Number
コンストラクタの詳細
Number()コンストラクタ
public 関数 Number(num:Object)

指定された値を持つ Number オブジェクトを作成します。このコンストラクタの結果は、異なる型のオブジェクトをプリミティブな数値に変換する Number() パブリックネイティブ関数と同じものになります。

パラメータ
num:Object — 作成する Number インスタンスの数値、または Number に変換する値です。num が指定されなかった場合のデフォルト値は 0 です。num パラメータを指定せずにコンストラクタを使用することは、値を割り当てずに Number 型の変数を宣言すること (var myNumber:Number など) と同じではありません。この場合は、デフォルトが NaN になります。値の割り当てられていない数値は未定義で、new Number(undefined) と同等です。

関連項目

メソッドの詳細
toExponential()メソッド
AS3 function toExponential(fractionDigits:uint):String

数値のストリング表現を指数表現で返します。ストリングには、fractionDigits パラメータでの指定に従って小数点の前に 1 桁、小数点以下に最大 20 桁が含まれます。

パラメータ
fractionDigits:uint — 必要な小数の桁数を表す 0 ~ 20 の整数です。

戻り値
String

スロー
RangeError fractionDigits 引数が 0 ~ 20 の範囲外である場合に、例外をスローします。


次の例は、toExponential(2) を使用して、ストリングを 指数表現で返す方法を示しています。

var num:Number = 315003;
trace(num.toExponential(2)); // Output: 3.15e+5

toFixed()メソッド 
AS3 function toFixed(fractionDigits:uint):String

数値のストリング表現を固定小数点表現で返します。固定小数点表現とは、fractionDigits パラメータでの指定に従って、小数点以下の特定数の桁をストリングに含めたものです。fractionDigits パラメータの有効範囲は 0 ~ 20 です。この範囲外の値を指定すると例外がスローされます。

パラメータ
fractionDigits:uint — 必要な小数の桁数を表す 0 ~ 20 の整数です。

戻り値
String

スロー
RangeError fractionDigits 引数が 0 ~ 20 の範囲外である場合に、例外をスローします。


次の例は、toFixed(3) を使用して、小数点以下 3 桁に四捨五入したストリングを 返す方法を示しています。

var num:Number = 7.31343;
trace(num.toFixed(3)); // Output: 7.313

次の例は、toFixed(2) を使用して、末尾にゼロを追加したストリングを 返す方法を示しています。

var num:Number = 4;
trace(num.toFixed(2)); // Output: 4.00

toPrecision()メソッド 
AS3 function toPrecision(precision:uint):String

数値のストリング表現を指数表現または固定小数点表現で返します。ストリングには、precision パラメータで指定された桁数が含まれます。

パラメータ
precision:uint — 結果のストリングに必要な桁数を表す 1 ~ 21 の整数です。

戻り値
String

スロー
RangeError precision 引数が 1 ~ 21 の範囲外である場合に、例外をスローします。


次の例は、toPrecision(3) を使用して、ストリングを 3 桁のみで返す方法を示しています。指数表現は必要でないため、ストリングは固定小数点表現で表されます。

var num:Number = 31.570;
trace(num.toPrecision(3)); // Output: 31.6

次の例は、toPrecision(3) を使用して、ストリングを 3 桁のみで返す方法を示しています。結果の数値には固定小数点表現に必要な桁が含まれないため、 ストリングは指数表現で表されます。

var num:Number = 4000;
trace(num.toPrecision(3)); // Output: 4.00e+3

toString()メソッド 
AS3 function toString(radix:Number = 10):String

指定された Number オブジェクト (myNumber) のストリング表現を返します。Number オブジェクトの値が先行ゼロを持たない小数 (.4 など) の場合、Number.toString() は先行ゼロを追加します。結果は 0.4 となります。

パラメータ
radix:Number (default = 10) — 数値からストリングへの変換に使用する基数 (2 ~ 36) を指定します。radix パラメータを指定しない場合、デフォルト値は 10 です。

戻り値
String — Number オブジェクトの数値表現のストリングです。
valueOf()メソッド 
AS3 function valueOf():Number

指定された Number オブジェクトのプリミティブな値のタイプを返します。

戻り値
Number — Number オブジェクトのプリミティブな型の値です。
定数の詳細
MAX_VALUE定数
public static const MAX_VALUE:Number

表現可能な最大の数値 (倍精度 IEEE-754) です。この数値は、約 1.79e+308 です。

MIN_VALUE定数 
public static const MIN_VALUE:Number

0 以外の正の値で、表現可能な最小の数値 (倍精度 IEEE-754) です。この数値は約 5e-324 です。全体的に表現可能な最小の数値は、実際には -Number.MAX_VALUE です。

NaN定数 
public static const NaN:Number

非数 (NaN) を表す IEEE-754 の値です。

関連項目

NEGATIVE_INFINITY定数 
public static const NEGATIVE_INFINITY:Number

負の無限大を表す IEEE-754 値を指定します。このプロパティの値は、-Infinity 定数の値と同じです。

負の無限大は、数学演算または関数が表現できる下限を超える負の値を返すときに返される特別な数値です。

POSITIVE_INFINITY定数 
public static const POSITIVE_INFINITY:Number

正の無限大を表す IEEE-754 値を指定します。このプロパティの値は、Infinity 定数の値と同じです。

正の無限大は、数学演算または関数が表現できる上限を超える正の値を返すときに返される特別な数値です。


次の例は、小数点以下 6 桁の数値を四捨五入によって 小数点以下 2 桁の数値に切り詰める方法を示しています。

package {
    import flash.display.Sprite;

    public class NumberExample extends Sprite {
        public function NumberExample() {
            var num:Number = new Number(10.456345);
            var str:String = num.toFixed(2);
            trace(num); // 10.456345
            trace(str); // 10.46
        }
    }
}