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 と 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 と 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


このドキュメントは、Ja-Jakartaにより訳されました。 コメントがある場合は report@jajakarta.orgまでお願いします。
Translated into Japanese by jajakarta.org. The original page is here.
Copyright (c) 2002-2003 - Apache Software Foundation