org.apache.commons.lang
クラス NumberUtils

java.lang.Object
  org.apache.commons.lang.NumberUtils

public final class NumberUtils

extends Object

Java Number クラスに対する付加機能を提供します。

バージョン:

$Id: NumberUtils.java,v 1.1.1.1 2004/02/13 10:02:04 hioki Exp $

作成者:

Henri Yandell, Rand McNeely, Stephen Colebourne, Steve Downey

翻訳者:

日置 聡

コンストラクタの概要

NumberUtils()
NumberUtils のインスタンスは一般的なプログラムからは生成すべきではありません。

メソッドの概要

static int	compare(double lhs, double rhs) 2つの double の大きさを比べます。
static int	compare(float lhs, float rhs) 2つの float の大きさを比べます。
static BigDecimal	createBigDecimal(String val) String を BigDecimal に変換します。
static BigInteger	createBigInteger(String val) String を BigInteger に変換します。
static Double	createDouble(String val) String を Double に変換します。
static Float	createFloat(String val) String を Float に変換します。
static Integer	createInteger(String val) 16進数、8進数の記号をハンドリングして String を Integer に変換します。
static Long	createLong(String val) String を Long に変換します。
static Number	createNumber(String val) 文字列の値を java.lang.Number に変換します。
private static boolean	isAllZeros(String s) createNumber のためのユーティリティメソッド。
static boolean	isDigits(String str) String が数字の文字だけで構成されているかをチェックします。
static boolean	isNumber(String str) String が有効な Java の数値を示しているかをチェックします。
static int	maximum(int a, int b, int c) 3つの中で一番大きな int の値を取得します。
static long	maximum(long a, long b, long c) 3つの中で一番大きな long の値を取得します。
static int	minimum(int a, int b, int c) 3つの中で一番小さい int の値を取得します。
static long	minimum(long a, long b, long c) 3つの中で一番小さい long の値を取得します。
static int	stringToInt(String str) String を int に変換します。
static int	stringToInt(String str, int defaultValue) String を int に変換します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

NumberUtils

public NumberUtils()

NumberUtils のインスタンスは一般的なプログラムからは生成すべきではありません。 代わりに NumberUtils.stringToInt("6"); というように使用すべきです。 このコンストラクタは、処理に JavaBean インスタンスを必要とするツールのために public になっています。

メソッドの詳細

stringToInt

public static int stringToInt(String str)

String を int に変換します。変換に失敗した場合には 0 を返します。

パラメータ:

str - 変換する文字列

戻り値:

文字列が示す int の値、変換に失敗した場合には 0

stringToInt

public static int stringToInt(String str,
                              int defaultValue)

String を int に変換します。変換に失敗した場合にはデフォルトの値を返します。

パラメータ:

str - 変換する文字列

defaultValue - デフォルトの値

戻り値:

文字列が示す int の値、変換に失敗した場合にはデフォルトの値

createNumber

public static Number createNumber(String val)
                           throws NumberFormatException

文字列の値を java.lang.Number に変換します。 まず最初に文字列の末尾の修飾('f','F','d','D','l','L')を調べます。 これが見つかった場合、指定された型に該当する型を保持する値が小さいものから順に試行し生成します。

型を定義する記述が見つからなかった場合には、小数点がなかった場合には Integer から BigInteger まで、あった場合には Float から BigDecimal までを順に 試行し生成します。

文字列が "0x" または "-0x" で始まる場合には16進数とみなされます。 0 で始まる値は8進数とはみなされません。

パラメータ:

val - 数値を含んだ文字列

戻り値:

文字列から生成された Number

例外:

NumberFormatException - 変換が行えなかった場合

isAllZeros

private static boolean isAllZeros(String s)

createNumber のためのユーティリティメソッド。s が null だった場合に true を返します。

パラメータ:

s - 評価対象となる String

戻り値:

null または全て0だった場合

createFloat

public static Float createFloat(String val)

String を Float に変換します。

パラメータ:

val - 変換の対象となる String

戻り値:

変換された Float

例外:

NumberFormatException - 変換が行えなかった場合

createDouble

public static Double createDouble(String val)

String を Double に変換します。

パラメータ:

val - 変換の対象となる String

戻り値:

変換された Double

例外:

NumberFormatException - 変換が行えなかった場合

createInteger

public static Integer createInteger(String val)

16進数、8進数の記号をハンドリングして String を Integer に変換します。

パラメータ:

val - 変換の対象となる String

戻り値:

変換された Integer

例外:

NumberFormatException - 変換が行えなかった場合

createLong

public static Long createLong(String val)

String を Long に変換します。

パラメータ:

val - 変換の対象となる String

戻り値:

変換された Long

例外:

NumberFormatException - 変換が行えなかった場合

createBigInteger

public static BigInteger createBigInteger(String val)

String を BigInteger に変換します。

パラメータ:

val - 変換の対象となる String

戻り値:

変換された BigInteger

例外:

NumberFormatException - 変換が行えなかった場合

createBigDecimal

public static BigDecimal createBigDecimal(String val)

String を BigDecimal に変換します。

パラメータ:

val - 変換の対象となる String

戻り値:

変換された BigDecimal

例外:

NumberFormatException - 変換が行えなかった場合

minimum

public static long minimum(long a,
                           long b,
                           long c)

3つの中で一番小さい long の値を取得します。

パラメータ:

a - 値1

b - 値2

c - 値3

戻り値:

一番小さな値

minimum

public static int minimum(int a,
                          int b,
                          int c)

3つの中で一番小さい int の値を取得します。

パラメータ:

a - 値1

b - 値2

c - 値3

戻り値:

一番小さな値

maximum

public static long maximum(long a,
                           long b,
                           long c)

3つの中で一番大きな long の値を取得します。

パラメータ:

a - 値1

b - 値2

c - 値3

戻り値:

一番大きな値

maximum

public static int maximum(int a,
                          int b,
                          int c)

3つの中で一番大きな int の値を取得します。

パラメータ:

a - 値1

b - 値2

c - 値3

戻り値:

一番大きな値

compare

public static int compare(double lhs,
                          double rhs)

2つの double の大きさを比べます。

このメソッドは標準的なJavaの比較演算よりも包括的です。 最初の値が2つ目の値よりも小さい場合 -1 を返します。 最初の値が2つ目の値よりも大きい場合 +1 を返します。 両方の値が等しい場合 0 を返します。

評価される順番は大きい順に以下のようになります:

• NaN
• 正の無限大
• double の最大値
• 正の数値
• +0.0
• -0.0
• 負の数値
• double の最小値(-Double.MAX_VALUE)
• 負の無限大

NaN と NaN の比較は 0 を返します。

パラメータ:

lhs - 最初の double

rhs - 次の double

戻り値:

lhsの方が小さい場合 -1、lhsの方が大きい場合 +1、等しい場合 0

compare

public static int compare(float lhs,
                          float rhs)

2つの float の大きさを比べます。

このメソッドは標準的なJavaの比較演算よりも包括的です。 最初の値が2つ目の値よりも小さい場合 -1 を返します。 最初の値が2つ目の値よりも大きい場合 +1 を返します。 両方の値が等しい場合 0 を返します。

評価される順番は大きい順に以下のようになります:

• NaN
• 正の無限大
• float の最大値
• 正の数値
• +0.0
• -0.0
• 負の数値
• float の最小値(-Float.MAX_VALUE)
• 負の無限大

NaN と NaN の比較は 0 を返します。

パラメータ:

lhs - 最初の float

rhs - 次の float

戻り値:

lhsの方が小さい場合 -1、lhsの方が大きい場合 +1、等しい場合 0

isDigits

public static boolean isDigits(String str)

String が数字の文字だけで構成されているかをチェックします。 null 、空の文字列が指定された場合には false を返します。

パラメータ:

str - 評価対象となる文字列

戻り値:

数字の文字だけで構成されているかどうか

isNumber

public static boolean isNumber(String str)

String が有効な Java の数値を示しているかをチェックします。 有効な数値には "0x" の修飾のある16進数、数値を表す際に使用される記号、 型を定義する符号(例 123L)が含まれます。

null 、空の文字列が指定された場合には false を返します。

パラメータ:

str - 評価対象となる文字列

戻り値:

文字列が正しい数値のフォーマットだった場合 true