20. パッケージjava.lang

パッケージ java.langには，Java言語の設計にとって基本的なクラスが収められている。最も重要なクラスは Object 及び Class とする。 Object は，クラス階層のルートであり，Class は，そのインスタンスによって実行時のクラスを表現する。

プリミティブ型の値は，あたかもオブジェクトであるかのように表現する必要がある場合が多い。ラッパークラスであるBoolean，Character，Integer，Long，Float，及び Double はこの目的のために使用する。例えば，型 Double のオブジェクトは，型 double のフィールドをもち，その値への参照が、参照型の変数に格納できる方法によって、その値を表現している。これらのクラスは又，プリミティブ値の間で相互に変換するためのいくつかのメソッドを提供している。同様にequals,hashCode などの標準メソッドを使用可能とする。

クラス Math では，サイン，コサイン，平方根など広く使用されている数値演算を提供している。同様にクラス String 及び クラス StringBuffer では，広く使用されている文字列演算を提供している。

ClassLoader，Process，Runtime，SecurityManager，及びクラス System では，クラスの動的ロード，外部プロセスの作成，時刻などのホスト環境の照会，及びセキュリティ規則を管理する“システム処理”を提供している。

クラス Throwable は，throw 文 (14.16)によって投げられるオブジェクトを含んでいる。Throwable のサブクラスには，エラーと例外がある。

次にパッケージ java.lang で定義されるクラスの階層構造を示す。

Object                                                  20.1    
    interface Cloneable                                 20.2
    Class                                               20.3
    Boolean                                             20.4
    Character                                           20.5     
    Number                                              20.6
        Integer                                         20.7     
        Long                                            20.8
        Float                                           20.9
        Double                                          20.10
    Math                                                20.11
    String                                              20.12
    StringBuffer                                        20.13
    ClassLoader                                         20.14
    Process                                             20.15
    Runtime                                             20.16
    SecurityManager                                     20.17
    System                                              20.18
    interface Runnable                                  20.19
    Thread                                              20.20
    ThreadGroup                                         20.21
    Throwable                                           20.22
        Error
            LinkageError
                ClassCircularityError
                ClassFormatError
                ExceptionInInitializerError
                IncompatibleClassChangeError
                    AbstractMethodError
                    IllegalAccessError
                    InstantiationError
                    NoSuchFieldError
                    NoSuchMethodError
                NoClassDefFoundError
                UnsatisfiedLinkError
                VerifyError
            VirtualMachineError
                InternalError
                OutOfMemoryError
                StackOverflowError
                UnknownError
            ThreadDeath
        Exception
            ClassNotFoundException
            CloneNotSupportedException
            IllegalAccessException
            InstantiationException
            InterruptedException
                RuntimeException
                    ArithmeticException
                    ArrayStoreException
                    ClassCastException
                    IllegalArgumentException
                        IllegalThreadStateException
                        NumberFormatException
                    IllegalMonitorStateException
                    IndexOutOfBoundsException
                    NegativeArraySizeException
                    NullPointerException
                    SecurityException

20.1 クラス java.lang.Object

public class Object {
    public final Class getClass();
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    protected Object clone()
        throws CloneNotSupportedException;
    public final void wait()
        throws IllegalMonitorStateException,
            InterruptedException;
    public final void wait(long millis)
        throws IllegalMonitorStateException,
            InterruptedException;
    public final void wait(long millis, int nanos)
        throws IllegalMonitorStateException,
            InterruptedException;
    public final void notify()
        throws IllegalMonitorStateException;
    public final void notifyAll()
        throws IllegalMonitorStateException;
    protected void finalize()
        throws Throwable;
}

20.1.1 public final Class getClass()

このメソッドは，このオブジェクトのクラスを表現する型 Class の一意のオブジェクト (20.3)への参照を返す。このオブジェクト Class は，表現されたクラスの static メソッド synchronized によってロックされたオブジェクトである。

20.1.2 public String toString()

toString は，このオブジェクトをテキストで表す文字列を返す。これは，その文字列を読む人にとって簡潔で有用な情報を与える。

メソッド toString は クラス Object で定義され，そのオブジェクトインスタンスのクラス名，アットマーク @，オブジェクトのハッシュコード値の符号なし 16進数表現から構成される文字列を返す。つまり，このメソッドは，次の式の値に等しい文字列を返す。

getClass().getName() +
 '@' + Integer.toHexString(hashCode())

20.1.3 public boolean equals(Object obj)

このメソッドは，あるオブジェクトがこのオブジェクトと，“等しい”かを判定する。

equals に実装されている等価関係の一般規則を以下に挙げる。

• 反射性(reflexive)。任意の参照値 x について，x.equals(x) は code>true を返す。
• 対称性(symmetric)。任意の参照値 x 及び y について，y.equals(x) が true を返す場合に，かつその場合に限り，x.equals(y) は true を返す。
• 推移性(transitive)。任意の参照値 x，y，及び z について，x.equals(y) が true を返し，y.equals(z) が true を返す場合，x.equals(z) は true を返す。
• 一貫性(consistent)。任意の参照値 x 及び y について，equals 比較で使用される x 及び y の情報が変更されない限り，x.equals(y) の呼び出しは常に true を返すか，常にfalseを返す。
• nullではない任意の参照値 xについて，x.equals(null) は false を返す。

このメソッドは，次のクラスで上書きされる。Boolean (20.4)，Character (20.5) ，Integer (20.7)，Long (20.8)，Float (20.9)，Double (20.10)，String (20.12)，及び BitSet (21.2)。

20.1.4 public int hashCode()

このメソッドは，Javaライブラリクラス java.util.Hashtable (21.5)で提供されているハッシュテーブルを利用するために使用する。

hashCode の一般規則を以下に挙げる。

Javaアプリケーションの実行中に hashCode を同じオブジェクトに対して複数回呼び出しても，このメソッドは常に同じ整数を返す。整数は，正，負，又はゼロとする。ただし，この整数は，異なる Javaアプリケーション間，又は同じアプリケーションの異なる実行間で一定である必要はない。 二つのオブジェクトが メソッド equals(20.1.3)で等しいと判定された場合，それぞれのオブジェクトに対してメソッド hashCodeを呼び出したときの戻り値は，同じ整数である必要がある。 二つのオブジェクトが メソッド equals (20.1.3)で異なると判定された場合，それぞれのオブジェクトに対してメソッド hashCodeを呼び出したときの戻り値は，必ずしも異なる整数である必要はない。ただし，プログラマは，等価ではないオブジェクトに対しては異なる戻り値を取得するように実装しておくと，ハッシュテーブルのパフォーマンスが向上することがあることを知っておく必要がある。

このメソッドは，次のクラスで上書きされる。Boolean (20.4) ，Character (20.5)，Integer (20.7)，Long (20.8)，Float (20.9) ，Double (20.10)，String (20.12)，及び BitSet (21.2)。

20.1.5 protected Object clone()
throws CloneNotSupportedException

cloneは，このオブジェクトの複写を作成し，それを返す。“複写”の正確な意味は，オブジェクトのクラスによって異なる。通常，任意のオブジェクト x に対して，次の式は true になる。

x.clone() != x

x.clone.getClass() == x.getClass()

x.clone.equals(x)

クラス Object の メソッド clone は，特定の処理を行ってクローンを作成する。最初に，このオブジェクトのクラスが，インタフェースCloneableを実装していなければ，CloneNotSupportedExceptionが投げられる。すべての配列は インタフェースCloneNotSupportedExceptionを実装していると見なされる。その他の場合，このメソッドは，このオブジェクトのクラスの新しいインスタンスを作成し，すべてのフィールドを初期化し，このオブジェクトの対応するフィールドと同一の内容に，代入文と同じ方法で書き替える。つまり，フィールドの内容そのものがクローンされるのではない。したがって，このメソッドでは“深い複写”ではなく“浅い複写”を行なう。

クラス Object 自体は インタフェースCloneableを実装していない。したがってクラス Objectのオブジェクトに対して メソッド cloneを呼び出すと，実行時に例外が投げられる。メソッド clone は，クラス Object で実装されている。クラス Object の メソッド clone は，インタフェースCloneableを実装するサブクラス用の汎用ユーティリティとして実装されている。メソッド cloneは，上書きされることがある。この場合，次の呼び出しを行えば，上書きした定義から上書きされたクラス Object の メソッド clone を参照できる。

super.clone()

20.1.6 public final void wait()
throws IllegalMonitorStateException, InterruptedException

このメソッドは，別のスレッドがこのオブジェクトに対して メソッド notify (20.1.9)又は,メソッド notifyAll (20.1.10)を呼び出すまで，現在のスレッドを待機させる。

言い換えれば，このメソッドの動作は，単に wait(0) (20.1.7)の呼び出しを行うのと同じとする。

20.1.7 public final void wait(long millis)
throws IllegalMonitorStateException, InterruptedException

このメソッドは，別のスレッドがこのオブジェクトに対してメソッド notify (20.1.9) 又は,メソッド notifyAll (20.1.10)を呼び出すか，指定された実時間が経過するまで，現在のスレッドを待機させる。このメソッドは，現在のスレッドがこのオブジェクトに対して既に同期化されている場合にだけ，呼び出すことができる。現在のスレッドがこのオブジェクトのロックを所有していない場合，IllegalMonitorStateExceptionが投げられる。

このメソッドは，現在のスレッド (これを T とする)をこのオブジェクトの待機集合 (17.14)に入れ，このオブジェクトに対するすべての同期化の要求を放棄させる。スレッドTは，スレッドのスケジューリング上は無効になり，次の四つのいずれかが行われるまでスリープ状態になる。

• 別のメソッドがこのオブジェクトに対して メソッド notify を呼び出し，スレッド T がたまたま再開されるスレッドとして選択された。
• 別のメソッドがこのオブジェクトに対して，メソッド notifyAll を呼び出した。
• 別のメソッドがスレッド T に割り込んだ (20.20.31)。
• 指定した実時間が経過した。実時間は，ミリ秒単位で計測され，millis で指定する。ただし，millisがゼロの場合は実時間が考慮されず，スレッドは通知されるまで待機し続ける。

現在のスレッドが待機中に，他のスレッドによって割り込まれた場合(20.20.31)，InterruptedException が投げられる。この例外は，前述したように，このオブジェクトのロック状態が復元されるまで投げられない。

メソッド waitは，現在のスレッドをこのオブジェクトの待機集合に入れる時に，このオブジェクトのロックだけを解除する。現在のスレッドが同期化の対象にしている他のオブジェクトは，スレッドが待機している間，ロックされたままとする。

20.1.8 public final void wait(long millis, int nanos)
throws IllegalMonitorStateException, InterruptedException

このメソッドは，別のスレッドがこのオブジェクトに対して メソッド notify (20.1.9)又は,メソッド notifyAll (20.1.10)を呼び出すか，別のスレッドが現在のスレッドに割り込むか，指定された実時間が経過するまで，現在のスレッドを待機させる。

この時間はナノ秒単位で，次の式で求められる。

1000000*millis+nanos

20.1.9 public final void notify()
throws IllegalMonitorStateException

このオブジェクトに対して待機中 (20.1.7)のスレッドがある場合，そのうちの一つが選択されて再開される。この選択は任意であり、処理系の実装によって決定される。 メソッド notifyは，現在のスレッドがこのオブジェクトに対して既に同期化されている場合しか，呼び出すことができない。現在のスレッドがこのオブジェクトのロックを所有していない場合，IllegalMonitorStateExceptionが投げられる。

再開されたスレッドは，現在のスレッドがこのオブジェクトに対してかけたロックを放棄するまで，処理を進めることができない。再開されたスレッドは，通常通り，このオブジェクトに対する同期化をめぐって他のスレッドと競合することになる。例えば，再開したスレッドであっても，次にこのオブジェクトにロックをかける際に，有利も不利も受けない。

20.1.10 public final void notifyAll()
throws IllegalMonitorStateException

このオブジェクトに対して待機中(20.1.7)のすべてのスレッドを再開する。

メソッド notifyAllは，現在のスレッドがこのオブジェクトに対して既に同期化されている場合にだけ，呼び出すことができる。現在のスレッドがこのオブジェクトのロックを所有していない場合，IllegalMonitorStateExceptionが投げられる。

再開されたスレッドは，現在のスレッドがこのオブジェクトに対してかけたロックを放棄するまで，処理を進めることができない。再開されたスレッドは，通常通り，このオブジェクトに対する同期化をめぐって他のスレッドと競合することになる。例えば，再開したスレッドであっても，次にこのオブジェクトにロックをかける際に，有利も不利も受けない。

20.1.11 protected void finalize() throws Throwable

メソッド finalize (12.7) は，Java 仮想計算機が，まだ消滅していないスレッドがこのオブジェクトにアクセスできる方法がまったくないと判断した場合に呼び出される。ただし，終了できる状態にある他のオブジェクトやクラスを終了した結果，このオブジェクトにアクセスできる方法がなくなる場合は除く。メソッド finalize は，このオブジェクトを再び他のスレッドが利用できるようにするなど，あらゆる動作を実行できる。しかし，finalizeの通常の動作は，オブジェクトが完全に破棄される前にその後始末を行うことである。たとえば，入出力接続を表すオブジェクトに対して呼び出される メソッド finalizeは，オブジェクトが永久に破棄される前に，明示的に入出力トランザクションを実行して接続を切断する。

クラス Object の メソッド finalizeは，特別な動作は何も行わない。単に，正常終了する。Objectのサブクラスは，この定義を上書きすることができる。

Javaでは，あるオブジェクトに対してどのスレッドが メソッドfinalizeを呼び出すのか保証していない。ただし，finalizeが呼び出された際，それを呼び出したスレッドがユーザに見える同期化ロックを保持しないことは保証されている。捕捉されない例外がメソッド finalize によって投げられると，その例外は無視され，そのオブジェクトのファイナライズは終了する。

あるオブジェクトに対して メソッド finalizeが呼び出された後，Java仮想計算機がまだ消滅していないスレッドがこのオブジェクトにアクセスできる方法がないと再度判断するまでは，何も実行されない。終了できる状態にあり，オブジェクトを破棄できる状態にある他のオブジェクトやクラスが行う可能性のある動作も実行されない。

Java仮想計算機は，あるオブジェクトに対して メソッド finalize を 2回以上呼び出すことはできない。

20.2 インタフェースjava.lang.Cloneable

public interface Cloneable { 

}

20.3 クラス java.lang.Class

クラス Classには，public宣言されたコンストラクタはない。Java仮想計算機は，クラスがロードされると自動的にClassオブジェクトを生成する。このようなオブジェクトはユーザプログラムでは生成できない。

public final class Class {
    public String toString();
    public String getName();
    public boolean isInterface();
    public Class getSuperclass();
    public Class[] getInterfaces();
    public Object newInstance()
        throws InstantiationException, IllegalAccessException;
    public ClassLoader getClassLoader();
    public static Class forName(String className)
        throws ClassNotFoundException;
}

20.3.1 public String toString()

Classオブジェクト が表現するのは，宣言クラス又は配列クラス，class という内容の文字列，スペース，及びメソッド getName (20.3.2)の返すクラス名とする。このClassオブジェクトがインタフェースを表現する場合，interfaceという内容の文字列，スペース，及びメソッドgetName が返すインタフェースの名前とする。

つまり，このメソッドは次の式の値に等しい文字列を返す。

(isInterface() ? "interface " : "class ") + getName()

20.3.2 public String getName()

このClassオブジェクト によって表されるクラス又はインタフェースの完全限定名が String として返される。次の例は，"java.lang.Object" を返す。 例

new Object().getClass().getName()

このクラスのオブジェクトが配列のクラスを表現する場合，その名前は，配列の入れ子の深さを表現する 一つ以上の"["と，Javaシグネチャ形式で表わされた要素型の名前から構成される。例えば，次の例は "[Ljava.lang.Object;" を返す。

(new Object[3]).getClass().getName()

(new int[3][4][5][6][7][8][9]).getClass().getName()

B                byte
C                char
D                double
F                float
I                int
J                long
Lclassname;      class or interface
S                short
Z                boolean

20.3.3 public boolean isInterface()

このClassオブジェクト がインタフェースを表現する場合，true を返す。このClassオブジェクトがクラスを表す場合，false を返す。

20.3.4 public Class getSuperclass()

このClassオブジェクト が，クラス Object 以外のクラスを表現する場合，そのクラスが属するスーパクラスを表現する Class を返す。このClassオブジェクト が，クラス Objectを表現するものである場合，又は，インタフェースを表現する場合，nullを返す。このClassオブジェクト が配列クラスを表現する場合，クラス Object を表現する Class を返す。

20.3.5 public Class[] getInterfaces()

このメソッドは，インタフェースを表現するオブジェクトの配列を返す。

この配列は空である場合もある。このClassオブジェクトがクラスを表現する場合，この配列は，そのクラスによって直接実装されるすべてのインタフェースを表現するオブジェクトを含む。配列中のインタフェースオブジェクトの順序は，Classオブジェクト によって表現されるクラス宣言のimplements節でのインタフェースの名前の順序と対応する。例えば，次のクラス宣言を例に挙げる。

class Shimmer implements FloorWax, DessertTopping {
 ... }

s.getClass().getInterfaces()[0]

s.getClass().getInterfaces()[1]

このClassオブジェクトがインタフェースを表現する場合，配列は，そのインタフェースによって直接継承されるすべてのインタフェース---つまり，インタフェースの直接のスーパインタフェース---を表現するオブジェクトを含む。配列中のインタフェースオブジェクトの順序は，Classオブジェクト によって表現されるインタフェース宣言の extends 節でのインタフェース名の順序と対応する。

20.3.6 public Object newInstance()
throws InstantiationException, IllegalAccessException

このメソッドは，このClassオブジェクトによって表現されるクラスのインスタンスを新しく作成し，それを返す。これは，空の実引数リストである時のクラスインスタンス作成式 (15.8)と同じ動作をする。例えば，t をクラス Thread を表すClassオブジェクト とすると，t.newInstance()は，new Thread()と同じとする。このようなクラスインスタンス作成式の評価が突然終了すると，メソッド newInstance の呼び出しも同じ理由により突然終了する。InstantiationException の詳細は，11.5.1.2も参照のこと。

20.3.7 public ClassLoader getClassLoader()

このメソッドは，このクラスをロードしたクラスローダ (20.14)への参照を返す。このクラスにクラスローダがない場合は，null を返す。

20.3.8 public static Class forName(String className)
throws ClassNotFoundException

このメソッドは，クラスの完全限定名が文字列で指定されると，クラスの検索，ロード (12.2)，及びリンク (12.3)を試みる。成功すると，クラスのClassオブジェクト への参照を返す。失敗すると，ClassNotFoundException が投げられる。

20.4 クラス java.lang.Boolean

public final class Boolean {
    public static final Boolean TRUE = new Boolean(true);
    public static final Boolean FALSE = new Boolean(false);
    public Boolean(boolean value);
    public Boolean(String s);
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    public boolean booleanValue();
    public static Boolean valueOf(String s);
    public static boolean getBoolean(String name);
}

20.4.1 public static final Boolean TRUE = new Boolean(true);

このフィールドの定数値は，プリミティブ値 true に対応するBooleanオブジェクト とする。

20.4.2 public static final Boolean FALSE = new Boolean(false);

このフィールドの定数値は，プリミティブ値 false に対応するBooleanオブジェクト とする。

20.4.3 public Boolean(boolean value)

このコンストラクタは，実引数で指定されたプリミティブ値を表すBooleanオブジェクト を新しく作成する。

20.4.4 public Boolean(String s)

このコンストラクタは，Booleanオブジェクト を新しく作成し，実引数が null ではなく，大文字小文字の区別なしで "true" と一致する場合に，またその場合にだけ，それを true で初期化する。

次に例を挙げる。

Boolean("True") は，true を表すBooleanオブジェクト を新しく作成する。
Boolean ("yes")は，false を表すBooleanオブジェクト を新しく作成する。

20.4.5 public String toString()

このBooleanオブジェクト が true を表現する場合，"true" と等しい文字列を返す。このBooleanオブジェクトが false を表現する場合，"false" と等しい文字列を返す。

このメソッドは，Object (20.1.2)のメソッド toString を上書きする。

20.4.6 public boolean equals(Object obj)

実引数が null でなく，それがこのBooleanオブジェクトと等しい boolean 値を表すBooleanオブジェクトである場合に，またその場合にだけ true が結果として返される。

このメソッドは，Objectの メソッド equals (20.1.3)を上書きする。

20.4.7 public int hashCode()

このBooleanオブジェクト が true を表現する場合，整数 1231 を返す。このBooleanオブジェクト が false を表現する場合，整数 1237 を返す。

このメソッドは，Objectの メソッド hashCode(20.1.4)を上書きする。

20.4.8 public boolean booleanValue()

このBooleanオブジェクト によって表現されるプリミティブな boolean 値を返す。

20.4.9 public static boolean valueOf(String s)

実引数が空でなく，かつ大文字小文字の区別を無視して，文字列 "true" と等しい場合，またその場合にだけ結果が true になる。

例えば，Boolean.valueOf("True") は true を返す。

例えば，Boolean.valueOf("yes") は false を返す。

20.4.10 public static boolean getBoolean(String name)

実引数により名前が付けられたシステム属性 (20.18.9)の値が，大文字小文字の区別を無視して，文字列 "true"と等しい場合，またその場合にだけ結果が true になる。

20.5 クラス java.lang.Character

public final class Character {
    public static final char MIN_VALUE = '\u0000';
    public static final char MAX_VALUE = '\uffff';
    public static final int MIN_RADIX = 2;
    public static final int MAX_RADIX =　36;
    public Character(char value);
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    public char charValue();
    public static boolean isDefined(char ch);
    public static boolean isLowerCase(char ch);
    public static boolean isUpperCase(char ch);
    public static boolean isTitleCase(char ch);
    public static boolean isDigit(char ch);
    public static boolean isLetter(char ch);
    public static boolean isLetterOrDigit(char ch);
    public static boolean isJavaLetter(char ch);
    public static boolean isJavaLetterOrDigit(char ch);)
    public static boolean isSpace(char ch);
    public static char toLowerCase(char ch);
    public static char toUpperCase(char ch);
    public static char toTitleCase(char ch);
    public static int digit(char ch, int radix);
    public static char forDigit(int digit, int radix);
}

Unicode 1.1.5 属性テーブルは，次の URL で WWW から入手できる。

ftp://unicode.org/pub/MappingTables/UnicodeData-1.1.5.txt

• 次のエントリには，ここに示すタイトルケースとのマッピングが必要となる。

  03D0;GREEK BETA SYMBOL;Ll;0;L;;;;;N;GREEK SMALL LETTER CURLED BETA;;0392;;0392

  03D1;GREEK THETA SYMBOL;Ll;0;L;;;;;N;GREEK SMALL LETTER SCRIPT THETA;;0398;;0398

  03D5;GREEK PHI SYMBOL;Ll;0;L;;;;;N;GREEK SMALL LETTER SCRIPT PHI;;03A6;;03A6

  03D6;GREEK PI SYMBOL;Ll;0;L;;;;;N;GREEK SMALL LETTER OMEGA PI;;03A0;;03A0

  03F0;GREEK KAPPA SYMBOL;Ll;0;L;;;;;N;GREEK SMALL LETTER SCRIPT KAPPA;;039A;;039A

  03F1;GREEK RHO SYMBOL;Ll;0;L;;;;;N;GREEK SMALL LETTER TAILED RHO;;03A1;;03A1

• 次のエントリには，ここに示す数値が必要となる。

  FF10;FULLWIDTH DIGIT ZERO;Nd;0;EN;0030;0;0;0;N;;;;;

  FF11;FULLWIDTH DIGIT ONE;Nd;0;EN;0031;1;1;1;N;;;;;

  FF12;FULLWIDTH DIGIT TWO;Nd;0;EN;0032;2;2;2;N;;;;;

  FF13;FULLWIDTH DIGIT THREE;Nd;0;EN;0033;3;3;3;N;;;;;

  FF14;FULLWIDTH DIGIT FOUR;Nd;0;EN;0034;4;4;4;N;;;;;

  FF15;FULLWIDTH DIGIT FIVE;Nd;0;EN;0035;5;5;5;N;;;;;

  FF16;FULLWIDTH DIGIT SIX;Nd;0;EN;0036;6;6;6;N;;;;;

  FF17;FULLWIDTH DIGIT SEVEN;Nd;0;EN;0037;7;7;7;N;;;;;

  FF18;FULLWIDTH DIGIT EIGHT;Nd;0;EN;0038;8;8;8;N;;;;;

  FF19;FULLWIDTH DIGIT NINE;Nd;0;EN;0039;9;9;9;N;;;;;

• 次のエントリは，対応する小文字を持つことはできない。

  03DA;GREEK LETTER STIGMA;Lu;0;L;;;;;N;GREEK CAPITAL LETTER STIGMA;;;;

  03DC;GREEK LETTER DIGAMMA;Lu;0;L;;;;;N;GREEK CAPITAL LETTER DIGAMMA;;;;

  03DE;GREEK LETTER KOPPA;Lu;0;L;;;;;N;GREEK CAPITAL LETTER KOPPA;;;;

  03E0;GREEK LETTER SAMPI;Lu;0;L;;;;;N;GREEK CAPITAL LETTER SAMPI;;;;

• 次のエントリには，ここに示す対応する大文字と tiltecase が必要となる。

  03C2;GREEK SMALL LETTER FINAL SIGMA;Ll;0;L;;;;;N;;;03A3;;03A3

Java 1.1では，Unicode第1.1.5版に基づいてここで定義されるメソッド，又は，希望的観測では，新しいUnicode第2.0版を使用した新しいバージョンのメソッドが利用できるようになる予定である。Unicode第2.0版の文字属性テーブルは，現在WWWでファイルとして公開され，次のURLから入手可能である。

ftp://unicode.org/pub/MappingTables/UnicodeData-2.0.12.txt

Unicode第2版での，もっとも大きな変更点は，朝鮮語（チョソノ）のハングルを大きく配置しなおしたことである。また，その他，細かい修正も加えられている。

20.5.1 public static final char MIN_VALUE = '\u0000';

このフィールドの定数値は，型 char の最小値とする。

［このフィールドは，Java Version 1.1 で導入される予定］

20.5.2 public static final char MAX_VALUE = '\uffff';

このフィールドの定数値は，型 char の最大値とする。

［このフィールドは，Java Version 1.1 で導入される予定］

20.5.3 public static final int MIN_RADIX = 2;

このフィールドの定数値は，クラス Integer (20.7) のメソッド digit (20.5.23)，メソッド forDigit (20.5.24)，及びメソッドtoString など基数に関係するメソッドの実引数 radix として指定可能な最小値とする。

20.5.4 public static final int MAX_RADIX = 36;

このフィールドの定数値は，クラス Integer (20.7)のメソッド digit(20.5.23)，メソッド forDigit (20.5.24)，及びメソッド toString など基数に関係するメソッドの実引数 radix として指定可能な最大値とする。

20.5.5 public Character(char value)

このコンストラクタは，実引数で指定されたプリミティブ値を表すオブジェクト Character を作成する。

20.5.6 public String toString()

このメソッドは，長さが 1 で，このCharacterオブジェクト の表すプリミティブ値 char を唯一の要素とする String を返す。

Object のメソッド toString (20.1.2)を上書きする。

20.5.7 public boolean equals(Object obj)

実引数が空でなく，かつこのCharacterオブジェクト と同じ char 値を持つCharacterオブジェクトである場合，またその場合にだけ結果が true になる。

オブジェクトのメソッド equals を上書きする(20.1.3)。

20.5.8 public int hashCode()

このCharacterオブジェクト で表現される char プリミティブの値が型 int にキャストされたものを返す。

オブジェクトのメソッド hashCode(20.1.4)を上書きする。

20.5.9 public char charValue()

このCharacterオブジェクト で表現される char プリミティブの値を返す。

20.5.10 public static boolean isDefined(char ch)

文字実引数が定義済みUnicode文字である場合，またその場合にだけ，true が結果として返される。

文字は，次の条件のうち少なくとも一つが真である場合に，またその場合にだけ，定義済みUnicode文字とする。

• Unicode属性テーブルにその文字のエントリがある。
• その文字のコードが，\u3040 より小さくなく，\u9FA5 より大きくない。
• その文字のコードが，\uF900 より小さくなく，\uFA2D より大きくない。

0000-01F5, 01FA-0217, 0250-02A8, 02B0-02DE, 02E0-02E9, 0300-0345, 0360-0361, 0374-0375, 037A, 037E, 0384-038A, 038C, 038E-03A1, 03A3-03CE, 03D0-03D6, 03DA, 03DC, 03DE, 03E0, 03E2-03F3, 0401-040C, 040E-044F, 0451-045C, 045E-0486, 0490-04C4, 04C7-04C8, 04CB-04CC, 04D0-04EB, 04EE-04F5, 04F8-04F9, 0531-0556, 0559-055F, 0561-0587, 0589, 05B0-05B9, 05BB-05C3, 05D0-05EA, 05F0-05F4, 060C, 061B, 061F, 0621-063A, 0640-0652, 0660-066D, 0670-06B7, 06BA-06BE, 06C0-06CE, 06D0-06ED, 06F0-06F9, 0901-0903, 0905-0939, 093C-094D, 0950-0954, 0958-0970, 0981-0983, 0985-098C, 098F-0990, 0993-09A8, 09AA-09B0, 09B2, 09B6-09B9, 09BC, 09BE-09C4, 09C7-09C8, 09CB-09CD, 09D7, 09DC-09DD, 09DF-09E3, 09E6-09FA, 0A02, 0A05-0A0A, 0A0F-0A10, 0A13-0A28, 0A2A-0A30, 0A32-0A33, 0A35-0A36, 0A38-0A39, 0A3C, 0A3E-0A42, 0A47-0A48, 0A4B-0A4D, 0A59-0A5C, 0A5E, 0A66-0A74, 0A81-0A83, 0A85-0A8B, 0A8D, 0A8F-0A91, 0A93-0AA8, 0AAA-0AB0, 0AB2-0AB3, 0AB5-0AB9, 0ABC-0AC5, 0AC7-0AC9, 0ACB-0ACD, 0AD0, 0AE0, 0AE6-0AEF, 0B01-0B03, 0B05-0B0C, 0B0F-0B10, 0B13-0B28, 0B2A-0B30, 0B32-0B33, 0B36-0B39, 0B3C-0B43, 0B47-0B48, 0B4B-0B4D, 0B56-0B57, 0B5C-0B5D, 0B5F-0B61, 0B66-0B70, 0B82-0B83, 0B85-0B8A, 0B8E-0B90, 0B92-0B95, 0B99-0B9A, 0B9C, 0B9E-0B9F, 0BA3-0BA4, 0BA8-0BAA, 0BAE-0BB5, 0BB7-0BB9, 0BBE-0BC2, 0BC6-0BC8, 0BCA-0BCD, 0BD7, 0BE7-0BF2, 0C01-0C03, 0C05-0C0C, 0C0E-0C10, 0C12-0C28, 0C2A-0C33, 0C35-0C39, 0C3E-0C44, 0C46-0C48, 0C4A-0C4D, 0C55-0C56, 0C60-0C61, 0C66-0C6F, 0C82-0C83, 0C85-0C8C, 0C8E-0C90, 0C92-0CA8, 0CAA-0CB3, 0CB5-0CB9, 0CBE-0CC4, 0CC6-0CC8, 0CCA-0CCD, 0CD5-0CD6, 0CDE, 0CE0-0CE1, 0CE6-0CEF, 0D02-0D03, 0D05-0D0C, 0D0E-0D10, 0D12-0D28, 0D2A-0D39, 0D3E-0D43, 0D46-0D48, 0D4A-0D4D, 0D57, 0D60-0D61, 0D66-0D6F, 0E01-0E3A, 0E3F-0E5B, 0E81-0E82, 0E84, 0E87-0E88, 0E8A, 0E8D, 0E94-0E97, 0E99-0E9F, 0EA1-0EA3, 0EA5, 0EA7, 0EAA-0EAB, 0EAD-0EB9, 0EBB-0EBD, 0EC0-0EC4, 0EC6, 0EC8-0ECD, 0ED0-0ED9, 0EDC-0EDD, 10A0-10C5, 10D0-10F6, 10FB, 1100-1159, 115F-11A2, 11A8-11F9, 1E00-1E9A, 1EA0-1EF9, 1F00-1F15, 1F18-1F1D, 1F20-1F45, 1F48-1F4D, 1F50-1F57, 1F59, 1F5B, 1F5D, 1F5F-1F7D, 1F80-1FB4, 1FB6-1FC4, 1FC6-1FD3, 1FD6-1FDB, 1FDD-1FEF, 1FF2-1FF4, 1FF6-1FFE, 2000-202E, 2030-2046, 206A-2070, 2074-208E, 20A0-20AA, 20D0-20E1, 2100-2138, 2153-2182, 2190-21EA, 2200-22F1, 2300, 2302-237A, 2400-2424, 2440-244A, 2460-24EA, 2500-2595, 25A0-25EF, 2600-2613, 261A-266F, 2701-2704, 2706-2709, 270C-2727, 2729-274B, 274D, 274F-2752, 2756, 2758-275E, 2761-2767, 2776-2794, 2798-27AF, 27B1-27BE, 3000-3037, 303F, 3041-3094, 3099-309E, 30A1-30FE, 3105-312C, 3131-318E, 3190-319F, 3200-321C, 3220-3243, 3260-327B, 327F-32B0, 32C0-32CB, 32D0-32FE, 3300-3376, 337B-33DD, 33E0-33FE, 3400-9FA5, F900-FA2D, FB00-FB06, FB13-FB17, FB1E-FB36, FB38-FB3C, FB3E, FB40-FB41, FB43-FB44, FB46-FBB1, FBD3-FD3F, FD50-FD8F, FD92-FDC7, FDF0-FDFB, FE20-FE23, FE30-FE44, FE49-FE52, FE54-FE66, FE68-FE6B, FE70-FE72, FE74, FE76-FEFC, FEFF, FF01-FF5E, FF61-FFBE, FFC2-FFC7, FFCA-FFCF, FFD2-FFD7, FFDA-FFDC, FFE0-FFE6, FFE8-FFEE, FFFD

［このメソッドは，ここで定義されている通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入される予定である。 20.5を参照のこと。］

20.5.11 public static boolean isLowerCase(char ch)

文字実引数が小文字である場合に，またその場合にだけ，true が結果として返される。

文字は，次の条件のすべてを満たす場合に，またその場合にだけ，小文字であると見なされる。

• その文字 ch が，\u2000 から \u2FFF までの範囲にない。
• Unicode属性テーブルで，その文字に対応する小文字のマップ情報が定義されていない(この条件は，タイトルケース文字を除外するためのものである)。
• 少なくとも次の一つが真とする。
  • Unicode属性テーブルで，その文字に対応する大文字のマップ情報が定義されていない。
  • Unicode属性テーブルでのその文字の名前に，SMALL LETTER 又は SMALL LIGATURE という言葉が含まれている。

0061-007A, 00DF-00F6, 00F8-00FF, 0101-0137 (奇数だけ), 0138-0148 (偶数だけ), 0149-0177 (奇数だけ), 017A-017E (偶数だけ), 017F-0180, 0183, 0185, 0188, 018C-018D, 0192, 0195, 0199-019B, 019E, 01A1-01A5 (奇数だけ), 01A8, 01AB, 01AD, 01B0, 01B4, 01B6, 01B9-01BA, 01BD, 01C6, 01C9, 01CC-01DC (偶数だけ), 01DD-01EF (奇数だけ), 01F0, 01F3, 01F5, 01FB-0217 (奇数だけ), 0250-0261, 0263-0269, 026B-0273, 0275, 0277-027F, 0282-028E, 0290-0293, 029A, 029D-029E, 02A0, 02A3-02A8, 0390, 03AC-03CE, 03D0-03D1, 03D5-03D6, 03E3-03EF (奇数だけ), 03F0-03F1, 0430-044F, 0451-045C, 045E-045F, 0461-0481 (奇数だけ), 0491-04BF (奇数だけ), 04C2, 04C4, 04C8, 04CC, 04D1-04EB (奇数だけ), 04EF-04F5 (奇数だけ), 04F9, 0561-0587, 1E01-1E95 (奇数だけ), 1E96-1E9A, 1EA1-1EF9 (奇数だけ), 1F00-1F07, 1F10-1F15, 1F20-1F27, 1F30-1F37, 1F40-1F45, 1F50-1F57, 1F60-1F67, 1F70-1F7D, 1F80-1F87, 1F90-1F97, 1FA0-1FA7, 1FB0-1FB4, 1FB6-1FB7, 1FC2-1FC4, 1FC6-1FC7, 1FD0-1FD3, 1FD6-1FD7, 1FE0-1FE7, 1FF2-1FF4, 1FF6-1FF7, FB00-FB06, FB13-FB17, FF41-FF5A

Unicode文字の最初の128文字のうち，次の26文字だけが小文字であると見なされる。

abcdefghijklmnopqrstuvwxyz

20.5.12 public static boolean isUpperCase(char ch)

文字実引数が大文字である場合に，またその場合にだけ true が結果として返される。

文字は，次の条件のすべてを満たす場合に，またその場合にだけ，大文字であると見なされる。

• その文字 ch が，\u2000 から \u2FFF までの範囲にない。
• Unicode属性テーブルで，その文字に対応する大文字のマップ情報が定義されていない(この条件は，タイトルケース文字を除外するためのものである)。
• 少なくとも次の一つが真とする。
  • Unicode属性テーブルで，その文字に対応する小文字のマップ情報が定義されていない。
  • Unicode属性テーブルでのその文字の名前に，CAPITAL LETTER 又は CAPITAL LIGATURE という言葉が含まれている。

0041-005A, 00C0-00D6, 00D8-00DE, 0100-0136 (偶数だけ), 0139-0147 (奇数だけ), 014A-0178 (偶数だけ), 0179-017D (奇数だけ), 0181-0182, 0184, 0186, 0187, 0189-018B, 018E-0191, 0193-0194, 0196-0198, 019C-019D, 019F-01A0, 01A2, 01A4, 01A7, 01A9, 01AC, 01AE, 01AF, 01B1-01B3, 01B5, 01B7, 01B8, 01BC, 01C4, 01C7, 01CA, 01CD-01DB (奇数だけ), 01DE-01EE (偶数だけ), 01F1, 01F4, 01FA-0216 (偶数だけ), 0386, 0388-038A, 038C, 038E, 038F, 0391-03A1, 03A3-03AB, 03E2-03EE (偶数だけ), 0401-040C, 040E-042F, 0460-0480 (偶数だけ), 0490-04BE (偶数だけ), 04C1, 04C3, 04C7, 04CB, 04D0-04EA (偶数だけ), 04EE-04F4 (偶数だけ), 04F8, 0531-0556, 10A0-10C5, 1E00-1E94 (偶数だけ), 1EA0-1EF8 (偶数だけ), 1F08-1F0F, 1F18-1F1D, 1F28-1F2F, 1F38-1F3F, 1F48-1F4D, 1F59-1F5F (奇数だけ), 1F68-1F6F, 1F88-1F8F, 1F98-1F9F, 1FA8-1FAF, 1FB8-1FBC, 1FC8-1FCC, 1FD8-1FDB, 1FE8-1FEC, 1FF8-1FFC, FF21-FF3A

Unicode文字の最初の128文字のうち，次の26文字だけが大文字だと見なされる。

ABCDEFGHIJKLMNOPQRSTUVWXYZ

20.5.13 public static boolean isTitleCase(char ch)

文字実引数がタイトルケースである場合に，またその場合にだけ，true が結果として返される。

“タイトルケース”という概念がUnicodeに導入されたのは，ある特殊な状況に対処するためであった。Unicodeには，1文字として扱われながら見た目には二つの普通のラテン文字に見える文字がある。例えば，Unicodeには‘LJ’(\u01C7)という文字がある。これは，‘L’と‘J’という二つの文字が続いたように見えるが，1文字である。また，対応する小文字‘lj’(\u01C9)もある。これらの文字がUnicodeにあるのは，主に，セルビアなどで使われているキリルアルファベットから，例えばラテンアルファベットへの，一対一転記を可能にするためである。ここで，“LJUBINJE”という単語を考えてみるが(これは，おそらくキリル文字を転記したものであり，‘LJ’と‘NJ’がそれぞれ1文字であるので，8文字ではなく，6文字(six) である)，書名の一部に使う場合には，大文字と小文字で書くことになっている。初めの文字を大文字にし，それ以外の文字を小文字にするという方法では，“LJubinje”となってしまい，具合が悪い。この解決策として，タイトルケース と呼ばれる三つめの形を使うことになった。‘LJ’のタイトルケースは‘Lj’(\u01C8)であり，‘NJ’のタイトルケースは‘Nj’とする。書名に出てくる単語の場合，可能であれば初めの文字をタイトルケースに変換し，そうでなければ大文字に変換する。その他の文字は，小文字に変換される。

文字は，次の条件の両方が真である場合に，またその場合にだけ，タイトルケースであると見なされる。

• その文字 ch が，\u2000 から \u2FFF の範囲にない。
• Unicode属性テーブルで，この文字に大文字 及び)小文字のマップ情報が定義されている。

\u01C5     LATIN CAPITAL LETTER D WITH SMALL LETTER Z WITH CARON
\u01C8     LATIN CAPITAL LETTER L WITH SMALL LETTER J
\u01CB     LATIN CAPITAL LETTER N WITH SMALL LETTER J
\u01F2     LATIN CAPITAL LETTER D WITH SMALL LETTER Z

20.5.14 public static boolean isDigit(char ch)

文字実引数が数字である場合に，またその場合にだけ true が結果として返される。

文字は，次の条件の両方が真である場合に，またその場合にだけ，数字であると見なされる。

• その文字 ch が，\u2000 から \u2FFF までの範囲にない。
• Unicode属性テーブルで，その文字の名前に DIGIT という言葉が含まれている。

0030-0039    ISO-Latin-1 (及びASCII) 数字 ('0'-'9')
0660-0669    アラビアインド数字
06F0-06F9    東方アラビアインド数字
0966-096F    デーバナーガーリ数字
09E6-09EF    ベンガル数字
0A66-0A6F    グルムキ数字
0AE6-0AEF    グジャラート数字
0B66-0B6F    オーリヤ数字
0BE7-0BEF    タミル数字 (9文字だけ。0はない)
0C66-0C6F    テルグ数字
0CE6-0CEF    カンナダ数字
0D66-0D6F    マラヤラム数字
0E50-0E59    タイ数字
0ED0-0ED9    ラオ数字
FF10-FF19    全角数字

0123456789

20.5.15 public static boolean isLetter(char ch)

文字実引数が文字(letter)である場合に，またその場合にだけ，true が結果として返される。

文字が letter又は数字 (20.5.16) のいずれかであり，かつ数字 (20.5.14) ではない場合に，またその場合にだけ，文字は letter と見なされる。

［このメソッドは，ここで定義された通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入の予定である。20.5を参照のこと。］

20.5.16 public static boolean isLetterOrDigit(char ch)

文字実引数が文字か数字(letter-or-digit)の場合に，またその場合にだけ，true を結果として返す。

文字は，定義済みUnicode文字(20.5.10)であり，その文字コードが次の範囲に該当する場合に，またその場合にだけ，文字か数字(letter-or-digit)と見なされる。

0030-0039    ISO-Latin-1 (及びASCII) ('0'-'9')
0041-005A    ISO-Latin-1 (及びASCII) ラテン大文字 ('A'-'Z')
0061-007A    ISO-Latin-1 (及びASCII) ラテン小文字 ('a'-'z')
00C0-00D6    ISO-Latin-1 補助文字
00D8-00F6    ISO-Latin-1 補助文字
00F8-00FF    ISO-Latin-1 補助文字
0100-1FFF    拡張ラテンA,拡張ラテンB,IPA拡張,幅付き修飾記号,発音区分符,
             基本ギリシャ文字,ギリシャ文字記号及びコプト文字,アルメニア文字, 
             拡張ヘブライ文字A,基本ヘブライ文字,拡張ヘブライ文字B,基本アラビア文字, 
             拡張アラビア文字,デーバナーガリ文字,ベンガル文字,グルムキ文字,グジャラティ文字,
             オリヤ文字,タミル文字,テルグ文字,カナダ文字,マラヤラム文字,タイ文字, 
             ラオス文字,基本グルジア文字,拡張グルジア文字,ハングルジャモ, 
             拡張ラテン文字補助,拡張ギリシャ文字
3040-9FFF    平仮名,片仮名,ボポモフォ,ハングル互換ジャモ,その他のCJK漢字,
             かっこ付きCJK文字及び月,CJK互換,ハングル,ハングル補足A,ハングル補足B,
             CJK統合漢字
F900-FDFF    CJK互換漢字 ,アルファベット表現形 ,アラビア文字表現形A
FE70-FEFE    アラビア文字表現形B
FF10-FF19    全角数字
FF21-FF3A    全角ラテン大文字
FF41-FF5A    全角ラテン小文字
FF66-FFDC    半角片仮名及びハングル

0030-0039, 0041-005A, 0061-007A, 00C0-00D6, 00D8-00F6, 00F8-01F5, 01FA-0217, 0250-02A8, 02B0-02DE, 02E0-02E9, 0300-0345, 0360-0361, 0374-0375, 037A, 037E, 0384-038A, 038C, 038E, 038F-03A1, 03A3-03CE, 03D0-03D6, 03DA-03E2, 03DA, 03DC, 03DE, 03E0, 03E2-03F3, 0401-040C, 040E-044F, 0451-045C, 045E-0486, 0490-04C4, 04C7-04C8, 04CB-04CC, 04D0-04EB, 04EE-04F5, 04F8-04F9, 0531-0556, 0559-055F, 0561-0587, 0589, 05B0-05B9, 05BB-05C3, 05D0-05EA, 05F0-05F4, 060C, 061B, 061F, 0621, 0622-063A, 0640-0652, 0660-066D, 0670-06B7, 06BA-06BE, 06C0-06CE, 06D0-06ED, 06F0-06F9, 0901-0903, 0905-0939, 093C-094D, 0950-0954, 0958-0970, 0981-0983, 0985-098C, 098F-0990, 0993-09A8, 09AA-09B0, 09B2, 09B6-09B9, 09BC, 09BE, 09BF-09C4, 09C7-09C8, 09CB-09CD, 09D7, 09DC-09DD, 09DF-09E3, 09E6-09FA, 0A02, 0A05-0A0A, 0A0F-0A10, 0A13-0A28, 0A2A-0A30, 0A32-0A33, 0A35-0A36, 0A38-0A39, 0A3C, 0A3E, 0A3F-0A42, 0A47-0A48, 0A4B-0A4D , 0A59-0A5C, 0A5E, 0A66-0A74, 0A81-0A83, 0A85-0A8B, 0A8D, 0A8F, 0A90-0A91, 0A93-0AA8, 0AAA-0AB0, 0AB2-0AB3, 0AB5-0AB9, 0ABC-0AC5, 0AC7-0AC9, 0ACB-0ACD, 0AD0, 0AE0, 0AE6-0AEF, 0B01-0B03, 0B05-0B0C, 0B0F-0B10, 0B13-0B28, 0B2A-0B30, 0B32-0B33, 0B36-0B39, 0B3C-0B43, 0B47-0B48, 0B4B-0B4D, 0B56-0B57, 0B5C-0B5D, 0B5F-0B61, 0B66-0B70, 0B82-0B83, 0B85-0B8A, 0B8E-0B90, 0B92-0B95, 0B99-0B9A, 0B9C, 0B9E, 0B9F, 0BA3-0BA4, 0BA8-0BAA, 0BAE-0BB5, 0BB7-0BB9, 0BBE-0BC2, 0BC6-0BC8, 0BCA-0BCD, 0BD7, 0BE7-0BF2, 0C01-0C03, 0C05-0C0C, 0C0E-0C10, 0C12-0C28, 0C2A-0C33, 0C35-0C39, 0C3E-0C44, 0C46-0C48, 0C4A-0C4D, 0C55-0C56, 0C60-0C61, 0C66-0C6F, 0C82-0C83, 0C85-0C8C, 0C8E-0C90, 0C92-0CA8, 0CAA-0CB3, 0CB5-0CB9, 0CBE-0CC4, 0CC6-0CC8, 0CCA-0CCD, 0CD5-0CD6, 0CDE, 0CE0, 0CE1, 0CE6-0CEF, 0D02-0D03, 0D05-0D0C, 0D0E-0D10, 0D12-0D28, 0D2A-0D39, 0D3E-0D43, 0D46-0D48, 0D4A-0D4D, 0D57, 0D60-0D61, 0D66-0D6F, 0E01-0E3A, 0E3F-0E5B, 0E81-0E82, 0E84, 0E87-0E88, 0E8A, 0E8D, 0E94-0E97, 0E99-0E9F, 0EA1-0EA3, 0EA5, 0EA7, 0EAA-0EAB, 0EAD-0EB9, 0EBB-0EBD, 0EC0-0EC4, 0EC6, 0EC8, 0EC9-0ECD, 0ED0-0ED9, 0EDC-0EDD, 10A0-10C5, 10D0-10F6, 10FB, 1100-1159, 115F-11A2, 11A8-11F9, 1E00-1E9A, 1EA0-1EF9, 1F00-1F15, 1F18-1F1D, 1F20-1F45, 1F48-1F4D, 1F50-1F57, 1F59, 1F5B, 1F5D, 1F5F-1F7D, 1F80-1FB4, 1FB6-1FC4, 1FC6-1FD3, 1FD6-1FDB, 1FDD-1FEF, 1FF2-1FF4, 1FF6-1FFE, 3041-3094, 3099-309E, 30A1-30FE, 3105-312C, 3131-318E, 3190-319F, 3200-321C, 3220-3243, 3260-327B, 327F-32B0, 32C0-32CB, 32D0-32FE, 3300-3376, 337B-33DD, 33E0-33FE, 3400-9FA5, F900-FA2D, FB00-FB06, FB13-FB17, FB1E-FB36, FB38-FB3C, FB3E, FB40, FB41, FB43, FB44, FB46, FB47-FBB1, FBD3-FD3F, FD50-FD8F, FD92-FDC7, FDF0-FDFB, FE70-FE72, FE74, FE76, FE77-FEFC, FF10-FF19, FF21-FF3A, FF41-FF5A, FF66-FFBE, FFC2-FFC7, FFCA-FFCF, FFD2-FFD7, FFDA-FFDC

［このメソッドは，ここで定義された通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入の予定である。20.5を参照のこと。］

20.5.17 public static boolean isJavaLetter(char ch)

文字実引数がJava識別子の先頭に来ることのできる文字である場合に，またその場合にだけ，true を結果として返す。

実引数は，文字(20.5.15)又はドル記号 '$'(\u0024)又は下線 '_' (\u005F)である場合に，またその場合にだけ，Java文字と見なされる。

［このメソッドは，ここで定義された通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入の予定である。20.5を参照のこと。］

20.5.18 public static boolean isJavaLetterOrDigit(char ch)

文字実引数がJava識別子の2文字目以降に現われることのできる文字である場合に，またその場合にだけ，true を結果として返す。

文字は，文字又は数字(letter-or-digit) (20.5.16)又はドル記号 '$' (\u0024)又は下線 '_' (\u005F)である場合に，またその場合にだけ，Java文字・数字と見なされる。

［このメソッドは，ここで定義された通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入の予定である。20.5を参照のこと。］

20.5.19 public static boolean isSpace(char ch)

実引数 ch が次のいずれかの文字に該当する場合，true を結果として返す。

'\t'        \u0009            HT        水平タブ
'\n'        \u000A            LF        ラインフィード (改行)
'\f'        \u000C            FF        フォームフィード
'\r'        \u000D            CR        復帰
' '         \u0020            SP        空白

20.5.20 public static char toLowerCase(char ch)

文字 ch に対応する小文字がUnicode属性テーブルで定義されている場合，その対応する小文字を返す。それ以外は，実引数 ch を返す。

前述した修正を加えたUnicode1.1.5のUnicode属性テーブルで定義される小文字の対応表を次に挙げる。次の表では矢印の左側の文字に対応する小文字が矢印の右側に示されている。

0041-005A 0061-007A, 00C0-00D6 00E0-00F6, 00D8-00DE 00F8-00FE, 0100-012E 0101-012F (偶数から奇数), 0132-0136 0133-0137 (偶数から奇数), 0139-0147 013A-0148 (奇数から偶数), 014A-0176 014B-0177 (偶数から奇数), 0178 00FF, 0179-017D 017A-017E (奇数から偶数), 0181 0253, 0182 0183, 0184 0185, 0186 0254, 0187 0188, 018A 0257, 018B 018C, 018E 0258, 018F 0259, 0190 025B, 0191 0192, 0193 0260, 0194 0263, 0196 0269, 0197 0268, 0198 0199, 019C 026F, 019D0272, 01A0-01A4 01A1-01A5 (偶数から奇数), 01A7 01A8, 01A9 0283, 01AC 01AD, 01AE 0288, 01AF 01B0, 01B1 028A, 01B2 028B, 01B3 01B4, 01B5 01B6, 01B7 0292, 01B8 01B9, 01BC 01BD, 01C401C6, 01C5 01C6, 01C7 01C9, 01C8 01C9, 01CA 01CC, 01CB-01DB 01CC-01DC (奇数から偶数), 01DE-01EE 01DF-01EF (偶数から奇数), 01F1 01F3, 01F2 01F3, 01F4 01F5, 01FA-0216 01FB-0217 (偶数から奇数), 0386 03AC, 0388-038A 03AD-03AF, 038C03CC, 038E03CD, 038F03CE, 0391-03A1 03B1-03C1, 03A3-03AB 03C3-03CB, 03E2-03EE 03E3-03EF (偶数から奇数), 0401-040C 0451-045C, 040E045E, 040F045F, 0410-042F 0430-044F, 0460-0480 0461-0481 (偶数から奇数), 0490-04BE 0491-04BF (偶数から奇数), 04C1 04C2, 04C3 04C4, 04C7 04C8, 04CB 04CC, 04D0-04EA 04D1-04EB (偶数から奇数), 04EE-04F4 04EF-04F5 (偶数から奇数), 04F8 04F9, 0531-0556 0561-0586, 10A0-10C5 10D0-10F5, 1E00-1E94 1E01-1E95 (偶数から奇数), 1EA0-1EF8 1EA1-1EF9 (偶数から奇数), 1F08-1F0F 1F00-1F07, 1F18-1F1D 1F10-1F15, 1F28-1F2F 1F20-1F27, 1F38-1F3F 1F30-1F37, 1F48-1F4D 1F40-1F45, 1F591F51, 1F5B1F53, 1F5D1F55, 1F5F1F57, 1F68-1F6F 1F60-1F67, 1F88-1F8F 1F80-1F87, 1F98-1F9F 1F90-1F97, 1FA8-1FAF 1FA0-1FA7, 1FB81FB0, 1FB91FB1, 1FBA1F70, 1FBB1F71, 1FBC1FB3, 1FC8-1FCB 1F72-1F75, 1FCC1FC3, 1FD81FD0, 1FD91FD1, 1FDA1F76, 1FDB1F77, 1FE81FE0, 1FE91FE1, 1FEA1F7A, 1FEB1F7B, 1FEC1FE5, 1FF81F78, 1FF91F79, 1FFA1F7C, 1FFB1F7D, 1FFC1FF3, 2160-216F 2170-217F, 24B6-24CF 24D0-24E9, FF21-FF3A FF41-FF5A

メソッド isLowerCase(20.5.11)は，メソッド toLowerCase の戻り値を実引数とした場合，必ずしも true を返すとは限らない。

［メソッド toLowerCase についての仕様は，ここで定義された通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入の予定である。20.5を参照のこと。］

20.5.21 public static char toUpperCase(char ch)

文字 ch に対応する大文字がUnicode属性テーブルで定義されている場合，その対応する大文字を返す。それ以外は，実引数 ch を返す。

前述した修正を加えたUnicode1.1.5のUnicode属性テーブルで定義される大文字の対応表を次に挙げる。次の表では矢印の左側の文字に対応する大文字が矢印の右側に示されている。

0061-007A 0041-005A, 00E0-00F6 00C0-00D6, 00F8-00FE 00D8-00DE, 00FF0178, 0101-012F 0100-012E (奇数から偶数), 0133-0137 0132-0136 (奇数から偶数), 013A-0148 0139-0147 (偶数から奇数), 014B-0177 014A-0176 (奇数から偶数), 017A-017E 0179-017D (偶数から奇数), 017F 0053, 0183-0185 0182-0184 (奇数から偶数), 0188 0187, 018C 018B, 0192 0191, 0199 0198, 01A1-01A5 01A0-01A4 (奇数から偶数), 01A8 01A7, 01AD 01AC, 01B0 01AF, 01B4 01B3, 01B6 01B5, 01B9 01B8, 01BD 01BC, 01C5 01C4, 01C601C4, 01C801C7, 01C901C7, 01CB01CA, 01CC01CA, 01CE-01DC 01CD-01DB (偶数から奇数), 01DF-01EF 01DE-01EE (奇数から偶数), 01F2 01F1, 01F3 01F1, 01F5 01F4, 01FB-0217 01FA-0216 (奇数から偶数), 0253 0181, 0254 0186, 0257018A, 0258018E, 0259018F, 025B0190, 02600193, 02630194, 02680197, 02690196, 026F019C, 0272019D, 028301A9, 028801AE, 028A01B1, 028B01B2, 029201B7, 03AC0386, 03AD-03AF 0388-038A, 03B1-03C1 0391-03A1, 03C203A3, 03C3-03CB 03A3-03AB, 03CC038C, 03CD038E, 03CE038F, 03D00392, 03D10398, 03D503A6, 03D603A0, 03E3-03EF 03E2-03EE (奇数から偶数), 03F0 039A, 03F103A1, 0430-044F 0410-042F, 0451-045C 0401-040C, 045E040E, 045F040F, 0461-0481 0460-0480 (奇数から偶数), 0491-04BF 0490-04BE (奇数から偶数), 04C2 04C1, 04C4 04C3, 04C8 04C7, 04CC 04CB, 04D1-04EB 04D0-04EA (奇数から偶数), 04EF-04F5 04EE-04F4 (奇数から偶数), 04F9 04F8, 0561-0586 0531-0556, 1E01-1E95 1E00-1E94 (奇数から偶数), 1EA1-1EF9 1EA0-1EF8 (奇数から偶数), 1F00-1F07 1F08-1F0F, 1F10-1F15 1F18-1F1D, 1F20-1F27 1F28-1F2F, 1F30-1F37 1F38-1F3F, 1F40-1F45 1F48-1F4D, 1F511F59, 1F531F5B, 1F551F5D, 1F571F5F, 1F60-1F67 1F68-1F6F, 1F701FBA, 1F711FBB, 1F72-1F75 1FC8-1FCB, 1F761FDA, 1F771FDB, 1F781FF8, 1F791FF9, 1F7A1FEA, 1F7B 1FEB, 1F7C 1FFA, 1F7D 1FFB, 1F80-1F87 1F88-1F8F, 1F90-1F97 1F98-1F9F, 1FA0-1FA7 1FA8-1FAF, 1FB01FB8, 1FB11FB9, 1FB31FBC, 1FC31FCC, 1FD01FD8, 1FD11FD9, 1FE01FE8, 1FE11FE9, 1FE51FEC, 1FF31FFC, 2170-217F 2160-216F, 24D0-24E9 24B6-24CF, FF41-FF5A FF21-FF3A

メソッド isUpperCase(20.5.12)は，メソッド toUpperCase の戻り値を実引数とした場合，必ずしも true を返すとは限らない。

［メソッド toUpperCase についての仕様は，ここで定義された通りに，又はUnicode2.0に対応した形で，バージョン1.1のJavaから導入の予定である。20.5を参照のこと。］

20.5.22 public static char toTitleCase(char ch)

文字 ch に対応するタイトルケースがUnicode属性テーブルに定義されている場合，その対応するタイトルケース文字を返す。それ以外は，実引数 ch を返す。

メソッド isTitleCase (20.5.13)は，メソッド toTitleCase の戻り値を実引数とした場合，必ずしも trueを返すとは限らない。Unicode属性テーブルは，大文字を持つが独立したタイトルケースを持たない文字に対しても，常に大文字属性に対応するタイトルケース属性を持つ。

例： Character.toTitleCase('a') は 'A' を返す

例： Character.toTitleCase('Q') は 'Q' を返す

例： Character.toTitleCase('lj') は 'Lj' を返す。この時，'lj' はUnicode文字 \u01C9 であり，'Lj' に対応するtitlecase文字 \u01C8 とする。

［このメソッドは，バージョン1.1のJavaで導入予定である。］

20.5.23 public static int digit(char ch, int radix)

文字 ch を実引数 radixで指定された整数を基数とする数字と見なし，その数値を返す。radixの値が有効な基数ではない場合，又は文字 chが指定された基数で有効な数字ではない場合，-1 を返す

基数は，その値がCharacter.MIN_RADIX(20.5.3)より小さくなく，かつCharacter.MAX_RADIX(20.5.4)より大きくない場合に，またその場合にだけ，有効とする。

文字は，次のいずれかが成り立つ場合に，またその場合にだけ，有効な数字だと判定される。

• メソッド isDigit がその文字に対して trueを返し，Unicode属性テーブルで定義されているその文字の10進数値が指定された基数より小さい。この場合，その10進数字の値を返す。
• その文字が，ラテン大文字 'A' から 'Z' まで(\u0041-\u005A)のいずれかであり，そのコードが radix+'A'-10 より小さい。この場合，ch-'A'+10 を返す。
• その文字が，ラテン小文字 'a''z' まで(\u0061-\u007A)のいずれかであり，そのコードが radix+'a'-10 よりも小さい。この場合，ch-'a'+10 を返す。

20.5.24 public static char forDigit(int digit, int radix)

指定された基数で与えられた数字を表現する文字を返す。radix の値が有効な基数ではない場合，又は digit の値が指定された基数で有効な数字ではない場合，null文字 '\u0000' を返す。

基数は，その値がCharacter.MIN_RADIX (20.5.3) より小さくなく，及びCharacter.MAX_RADIX(20.5.4)より大きくない場合に，またその場合にだけ，有効とする。

数値は，負でなく，radixより小さい場合に，またその場合にだけ，有効とする。

数値が 10 より小さい場合，文字値 '0'+digitを返す。それ以外の場合は，'a'+digit-10を返す。従って，forDigitで生成される数字は，次の昇順のASCII文字になる。

0123456789abcdefghijklmnopqrstuvwxyz

Character.toUpperCase(Character.forDigit(digit, radix))

20.6 クラス java.lang.Number

public abstract class Number {
    public abstract int intValue();
    public abstract long longValue();
    public abstract float floatValue();
    public abstract double doubleValue();
}

20.6.1 public abstract int intValue()

メソッド intValue は，このNumberオブジェクトによって表現される数値を型 int に変換した後，その値を返す。

Integer (20.7.8)，Long (20.8.8)，Float (20.9.12)及び Double (20.10.11)によって上書きされる。

20.6.2 public abstract long longValue()

メソッド longValue は，このNumberオブジェクト によって表現される数値を型 long に変換した後，その値を返す。

Integer (20.7.9)，Long (20.8.9)，Float (20.9.13)及び Double (20.10.12)によって上書きされる。

20.6.3 public abstract float floatValue()

メソッド floatValue は，このNumberオブジェクト によって表現される数値を型 float に変換した後，その値を返す。

Integer (20.7.10)，Long (20.8.10)，Float (20.9.14)及び Double(20.10.13)によって上書きされる。

20.6.4 public abstract double doubleValue()

メソッド doubleValue は，このNumberオブジェクトによって表現される数値を型 double に変換した後，その値を返す。

Integer(20.7.10)，Long(20.8.10)，Float (20.9.14)及び Double (20.10.13)によって上書きされる。

20.7 クラス java.lang.Integer

public final class Integer extends Number {
    public static final int MIN_VALUE = 0x80000000;
    public static final int MAX_VALUE = 0x7fffffff;
    public Integer(int value);
    public Integer(String s)
        throws NumberFormatException;
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    public int intValue();
    public long longValue();
    public float floatValue();
    public double doubleValue();
    public static String toString(int i);
    public static String toString(int i, int radix);
    public static String toHexString(long i);
    public static String toOctalString(long i);
    public static String toBinaryString(long i);
    public static int parseInt(String s)
        throws NumberFormatException;
    public static int parseInt(String s, int radix)
        throws NumberFormatException;
    public static Integer valueOf(String s)
        throws NumberFormatException;
    public static Integer valueOf(String s, int radix)
        throws NumberFormatException;
    public static Integer getInteger(String nm);
    public static Integer getInteger(String nm, int val);
    public static Integer getInteger(String nm, Integer val);
}

20.7.1 public static final int MIN_VALUE = 0x80000000;

このフィールドの定数値は，型 int の最小値 -2147483648 とする。

20.7.2 public static final int MAX_VALUE = 0x7fffffff;

このフィールドの定数値は，型 int の最大値 2147483647 とする。

20.7.3 public Integer(int value)

このコンストラクタは， Integerオブジェクト を新しく作成し，実引数に指定されたプリミティブ値で初期化する。

20.7.4 public Integer(String s) throws NumberFormatException

このコンストラクタは， Integerオブジェクト を新しく作成し，それを10進表記の文字列によって表現された整数で初期化する。文字列は，メソッド parseInt(20.7.18) が基数10に対して行うのと同じ方法で int 値に変換される。

20.7.5 public String toString()

このIntegerオブジェクト によって表現される整数値を符号付き10進表現に変換し，その値を文字列として返す。これは，実引数を一つ取るメソッド toString(20.7.12)の実引数として，この整数値を渡すのと同じとする。

このメソッドは，Object のメソッド toString (20.1.2)を上書きする。

20.7.6 public boolean equals(Object obj)

実引数が null でなく，このIntegerオブジェクトと同じ int 値を表現するIntegerオブジェクトである場合に，またその場合にだけ，true を返す。

オブジェクトのメソッド equals (20.1.3)を上書きする。

20.7.7 public int hashCode()

このInteger オブジェクトによって表現されるプリミティブの int 値を返す。

Object のメソッド hashCode (20.1.4)を上書きする。

20.7.8 public int intValue()

このIntegerオブジェクト によって表現される int 値を返す。

Number のメソッド intValue (20.6.1)を上書きする。

20.7.9 public long longValue()

このIntegerオブジェクト によって表現される int 値が，型 long に変換(5.1.2)され，その変換結果を返す。

Number のメソッド longValue (20.6.2)を上書きする。

20.7.10 public float floatValue()

このIntegerオブジェクト によって表現される int 値が，型 float に変換(5.1.2)され，その変換結果を返す。

Number のメソッド floatValue (20.6.3)を上書きする。

20.7.11 public double doubleValue()

このIntegerオブジェクト によって表現される int 値が，型 double に変換 (5.1.2)され，その変換結果を返す。

Number のメソッド doubleValue (20.6.4)を上書きする。

20.7.12 public static String toString(int i)

実引数を符号付き10進数表現に変換し，文字列として返す。これは，実引数を二つ取るメソッド toString (20.7.13)の実引数として，この実引数と基数10 を渡すのと同じとする。

20.7.13 public static String toString(int i, int radix)

一つ目の実引数の整数値を2番目の実引数で指定された整数を基数とする数値の符号付き表現に変換し，その値を文字列として返す。

基数が Character.MIN_RADIX (20.5.3)より小さいか，Character.MAX_RADIX (20.5.4)より大きい場合，代わりに 10 が基数として使用される。

一つ目の実引数が負の場合，戻り値の最初の文字は '-'('\u002d')になる。一つ目の実引数が負でない場合，戻り値に符号は付かない。

戻り値から符号を取った残りの文字は，一つ目の実引数の絶対値を表現する。絶対値がゼロの場合，一つのゼロ文字 '0'('\u0030')で表現される。それ以外の場合，絶対値の先頭文字は，ゼロ文字にならない。数字として使用できるASCII文字は，次の通りとする。

0123456789abcdefghijklmnopqrstuvwxyz

Integer.toString(n, 16).toUpperCase()

20.7.14 public static String toHexString(int i)

実引数を符号なし16進数(基数16)に変換し，その値を文字列として返す。

戻り値は，実引数の符号なしの絶対値を表現する。実引数が負の場合，戻り値は実引数にを加えた値になる。それ以外の場合は，実引数と同じ値を返す。

符号なしの絶対値がゼロの場合，一つのゼロ文字 '0'('\u0030')で表現される。それ以外は，符号なしの絶対値の先頭文字は，ゼロ文字にならない。16進数字として使用できる文字は，次の通りとする。

0123456789abcdef

Long.toHexString(n).toUpperCase()

20.7.15 public static String toOctalString(int i)

実引数を符号なし8進数(基数8)に変換し，その値を文字列として返す。

戻り値は，実引数の符号なしの絶対値を表現する。実引数が負の場合，戻り値は実引数にを加えた値になる。それ以外の場合は，実引数と同じ値を返す。

符号なしの絶対値がゼロの場合，一つのゼロ文字 '0'('\u0030')で表現される。それ以外は，符号なしの絶対値の先頭文字は，ゼロ文字にならない。8進数字として使用できる文字は，次の通りとする。

01234567

20.7.16 public static String toBinaryString(int i)

実引数を符号なし2進数(基数2)に変換し，その値を文字列として返す。

戻り値は，実引数の符号なしの絶対値を表現する。実引数が負の場合，戻り値は実引数にを加えた値になる。それ以外の場合は，実引数と同じ値を返す。

符号なしの絶対値がゼロの場合，一つのゼロ文字 '0'('\u0030')で表現される。それ以外は，符号なしの絶対値の先頭文字は，ゼロ文字にならない。2進数字として使用できる文字は，'0'('\u0030')と '1'('\u0031')とする。

20.7.17 public static int parseInt(String s)
throws NumberFormatException

実引数は，符号付き10進整数を表現していると解釈される。文字列内の文字はすべて10進数字であることが必要である。ただし，先頭文字が負の値を示す '-'('\u002d')になる場合もある。この結果として取得された整数値を返す。これは，実引数を二つ取るメソッド parseInt(20.7.18)の実引数として，この実引数と基数 10 を渡すのと同じとする。

20.7.18 public static int parseInt(String s, int radix)
throws NumberFormatException

一つ目の実引数は，二つ目の実引数で指定された整数を基数とする符号付き整数として解釈される。文字列内の文字は，すべて指定された基数にとって有効な文字であることが必要である(有効な文字かどうかは，Character.digit(20.5.23)が負でない値を返すかどうかで判定できる)。ただし，先頭文字が負の値を示す '-'('\u002d')になる場合もある。この結果として取得された整数値を返す。

次のいずれかの場合，型 NumberFormatException の例外が投げられる。

• 一つ目の実引数が null 又は長さゼロの文字列とする。
• radix が Character.MIN_RADIX (20.5.3) より小さい，又はCharacter.MAX_RADIX (20.5.4) より大きい。
• 文字列内の文字が指定された radix にとって有効な文字ではない。ただし，文字列の長さが1より長い場合は，先頭文字のマイナス記号'-'('\u002d')を除く。
• 文字列の表す整数値が 型 int の値ではない。

parseInt("0", 10) は 0 を返す
parseInt("473", 10) は 473 を返す
parseInt("-0", 10) は 0 を返す
parseInt("-FF", 16) は -255 を返す
parseInt("1100110", 2) は 102 を返す
parseInt("2147483647", 10) は 2147483647 を返す
parseInt("-2147483648", 10) は -2147483648 を返す
parseInt("2147483648", 10) は a NumberFormatException を投げる
parseInt("99", 8) は a NumberFormatException を投げる
parseInt("Kona", 10) は a NumberFormatException を投げる
parseInt("Kona", 27) は 411787 を返す

20.7.19 public static Integer valueOf(String s)
throws NumberFormatException

実引数は，符号付き10進整数を表現していると解釈される。これは，実引数を一つ取るメソッドparseInt(20.7.17)に，この実引数を渡す場合と同じとする。文字列で指定された整数値を表すIntegerオブジェクトを返す。

言い換えれば，このメソッドは，次の式の値に等しいIntegerオブジェクト を返す。

new Integer(Integer.parseInt(s))

20.7.20 public static Integer valueOf(String s, int radix)
throws NumberFormatException

一つ目の実引数は，二つ目の実引数で指定された整数を基数とする符号付き整数として解釈される。これは，実引数を二つ取るメソッド parseInt(20.7.18)に，この実引数を渡す場合と同じとする。文字列で指定された整数値を表すIntegerオブジェクト を返す。

言い換えれば，このメソッドは，次の式の値に等しいIntegerオブジェクト を返す。

new Integer(Integer.parseInt(s, radix))

20.7.21 public static Integer getInteger(String nm)

実引数は，メソッド System.getProperty(20.18.9)で取得されるものと同じシステム属性の名前として扱われる。この属性の文字列値は，整数値として解釈され，この値を表現するIntegerオブジェクトを返す。指定した名前の属性がない場合，又は属性の値が数値として正しい書式でない場合，null を返す。

言い換えれば，このメソッドは，次の式の値に等しいIntegerオブジェクト を返す。

getInteger(nm, null)

20.7.22 public static Integer getInteger(String nm, int val)

一つ目の実引数は，メソッド System.getProperty(20.18.9)で取得されるものと同じシステム属性の名前として扱われる。この属性の文字列値は，整数値として解釈され，この値を表現するIntegerオブジェクト を返す。属性の値が数値として正しい書式でない場合，二つ目の実引数の値を表現するIntegerオブジェクト を返す。

言い換えれば，このメソッドは，次の式の値に等しいIntegerオブジェクト を返す。

getInteger(nm, new Integer(val))

Integer result = getInteger(nm, null);
return (result == null) ? new Integer(val) : result;

20.7.23 public static Integer getInteger(String nm, Integer val)

一つ目の実引数は，メソッド System.getProperty( 20.18.9)で取得されるものと同じシステム属性の名前として扱われる。この属性の文字列値は，整数値として解釈され，この値を表現するIntegerオブジェクト を返す。

• 属性値が二つのASCII文字 0x で始まる場合，又はASCII文字 #で始まり，その後ろにマイナス記号が続かない場合，残りの部分は，16を基数とするメソッド Integer.valueOf(20.7.20)と同じ方法で，16進整数として解析される。
• 属性値がASCII文字 0 で始まり，その後ろに他の文字が続く場合，8 を基数とするメソッド Integer.valueOf(20.7.20)と同じ方法で8進整数として解析される。
• それ以外の場合，属性値は 10 を基数とするメソッドInteger.valueOf(20.7.20)と同じ方法で10進整数として解析される。

20.8 クラス java.lang.Long

public final class Long extends Number {
    public static final long MIN_VALUE =0x8000000000000000L;
    public static final long MAX_VALUE =0x7fffffffffffffffL;
    public Long(long value);
    public Long(String s)
        throws NumberFormatException;
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    public int intValue();
    public long longValue();
    public float floatValue();
    public double doubleValue();
    public static String toString(long i);
    public static String toString(long i, int radix);
    public static String toHexString(long i);
    public static String toOctalString(long i);
    public static Strin toBinaryString(long i);
    public static long parseLong(String s)
        throws NumberFormatException;
    public static long parseLong(String s, int radix)
        throws NumberFormatException;
    public static Long valueOf(Strings)
        throws NumberFormatException;
    public static Long valueOf(String s, int radix)
        throws NumberFormatException;
    public static Long getLong(String nm);
    public static Long getLong(String nm, long val);
    public static Long getLong(String nm, Long val);
}

20.8.1 public static final long MIN_VALUE = 0x8000000000000000L;

このフィールドの定数値は，型 long の最小値とする。

20.8.2 public static final long MAX_VALUE = 0x7fffffffffffffffL;

このフィールドの定数値は，型 long の最大値とする。

20.8.3 public Long(long value)

このコンストラクタは，Longオブジェクトを新しく作成し，実引数に指定されたプリミティブ値で初期化する。

20.8.4 public Long(String s) throws NumberFormatException

このコンストラクタは，Longオブジェクト を新しく作成し，それを10進表記の文字列によって表現された整数で初期化する。文字列は，メソッド parseLong(20.8.17)が基数10に対して行うのと同じ方法で long 値に変換される。

20.8.5 public String toString()

このLongオブジェクト によって表現される型 long整数値を符号付き10進表現に変換し，その値を文字列として返す。これは，実引数を一つ取るメソッド toString(20.7.12)の実引数として，この整数値を渡すのと同じとする。

このメソッドは，Object のメソッド toString (20.1.2)を上書きする。

20.8.6 public boolean equals(Object obj)

実引数が null でなく，このLongオブジェクト と同じ long 値を表現するLongオブジェクト である場合に，またその場合にだけ，true を返す。

オブジェクトのメソッド equals (20.1.3)を上書きする。

20.8.7 public int hashCode()

このLongオブジェクト によって表現されるプリミティブな long 値の上位半分と下位半分の排他的論理和を返す。つまり，ハッシュコードは，次の式の値になる。

(int)(this.longValue()^(this.longValue()>>>32))

20.8.8 public int intValue()

このLongオブジェクト によって表現される long 値が型 int に変換 (5.1.3)され，その変換結果を返す。

Number のメソッド intValue (20.6.1)を上書きする。

20.8.9 public long longValue()

このLongオブジェクト によって表現される long 値を返す。

Number のメソッド longValue(20.6.2)を上書きする。

20.8.10 public float floatValue()

このLongオブジェクト によって表現される long 値が，型 float に変換 (5.1.2)され，その変換結果を返す。

Number のメソッド floatValue (20.6.3)を上書きする。

20.8.11 public double doubleValue()

このLongオブジェクト によって表現される long 値が，型 double に変換 (5.1.2)され，その変換結果を返す。

Number のメソッド doubleValue (20.6.4)を上書きする。

20.8.12 public static String toString(long i)

実引数を符号付き10進数表現に変換し，文字列として返す。これは，実引数を二つ取るメソッド toString(20.8.13)の実引数として，この実引数と基数 10 を渡すのと同じとする。

20.8.13 public static String toString(long i, int radix)

一つ目の実引数の整数値を2番目の実引数で指定された整数を基数とする数値の符号付き表現に変換し，その値を文字列として返す。

radix が Character.MIN_RADIX (20.5.3)より小さいか，Character.MAX_RADIX (20.5.4)より大きい場合，代わりに 10 が基数として使用される。

一つ目の実引数が負の場合，戻り値の最初の文字は '-' ('\u002d')になる。一つ目の実引数が負でない場合，戻り値に符号は付かない。

戻り値から符号を取った残りの文字は，一つ目の実引数の絶対値を表現する。絶対値がゼロの場合，一つのゼロ文字'0'('\u0030')で表現される。それ以外の場合，絶対値の先頭文字は，ゼロ文字にならない。数字として使用できるASCII文字は，次の通りとする。

0123456789abcdefghijklmnopqrstuvwxyz

Long.toString(n, 16).toUpperCase()

20.8.14 public static String toHexString(long i)

実引数を符号なし16進数(基数16)に変換し，その値を文字列として返す。

戻り値は，実引数の符号なしの絶対値を表現する。実引数が負の場合，戻り値は実引数にを加えた値になる。それ以外の場合は，実引数と同じ値を返す。

符号なしの絶対値がゼロの場合，一つのゼロ文字 '0'('\u0030')で表現される。それ以外は，符号なしの絶対値の先頭文字は，ゼロ文字にならない。16進数字として使用できる文字は，次の通りとする。

0123456789abcdef

Long.toHexString(n).toUpperCase()

20.8.15 public static String toOctalString(long i)

実引数を符号なし8進数(基数8)に変換し，その値を文字列として返す。

戻り値は，実引数の符号なしの絶対値を表現する。実引数が負の場合，戻り値は実引数にを加えた値になる。それ以外の場合は，実引数と同じ値を返す。

符号なしの絶対値がゼロの場合，一つのゼロ文字 '0'('\u0030')で表現される。それ以外は，符号なしの絶対値の先頭文字は，ゼロ文字にならない。8進数字として使用できる文字は，次の通りとする。

01234567

20.8.16 public static String toBinaryString(long i)

実引数を符号なし2進数(基数2)に変換し，その値を文字列として返す。

戻り値は，実引数の符号なしの絶対値を表現する。実引数が負の場合，戻り値は実引数に を加えた値になる。それ以外の場合は，実引数と同じ値を返す。

符号なしの絶対値がゼロの場合，一つのゼロ文字'0'('\u0030')で表現される。それ以外は，符号なしの絶対値の先頭文字は，ゼロ文字にならない。2進数字として使用できる文字は，'0'('\u0030')と '1'('\u0031')とする。

20.8.17 public static long parseLong(String s)
throws NumberFormatException

実引数は，符号付き10進整数を表現していると解釈される。文字列内の文字はすべて10進数字であることが必要である。ただし，先頭文字が負の値を示す '-'('\u002d')になる場合もある。この結果として取得された整数値を返す。これは，実引数を二つ取るメソッドparseInt(20.8.18)の実引数として，この実引数と基数 10 を渡すのと同じとする。

Javaのソースコード(3.10.1)の場合とは異なり，L又はlを文字列の最後に型指示子として使うことはできない。

20.8.18 public static long parseLong(String s, int radix)
throws NumberFormatException

一つ目の実引数は，二つ目の実引数で指定された整数を基数とする符号付き整数として解釈される。文字列内の文字は，すべて指定された基数にとって有効な文字であることが必要である(有効な文字かどうかは，Character.digit (20.5.23)が負でない値を返すかどうかで判定できる)。ただし，先頭文字が負の値を示す'-'('\u002d')になる場合もある。この結果として取得された long 値を返す。

Javaのソースコード(3.10.1)の場合とは異なり，L又はlを文字列の最後に型指示子として使うことはできない。ただし，基数が 22 以上の場合に数字として L 又は l が使われる場合を除く。

次のいずれかの場合，型 NumberFormatExceptionの例外が投げられる。

• 一つ目の実引数が null 又は長さゼロの文字列とする。
• radix が Character.MIN_RADIX (20.5.3)より小さいか，又は Character.MAX_RADIX(20.5.4)より大きい。
• 文字列内の文字が指定された radix にとって有効な文字ではなく，かつ先頭文字のマイナス記号 '-'('\u002d')でもない。
• 文字列内の先頭の文字が，マイナス記号であり，かつ文字列の長さが1とする。
• 2文字目以降の文字が指定された radix の数字ではない。
• 文字列の表す整数値が型 long の値として表せない。

parseLong("0", 10) は 0L を返す
parseLong("473", 10) は 473L を返す
parseLong("-0", 10) は 0L を返す
parseLong("-FF", 16) は -255L を返す
parseLong("1100110", 2) は 102L を返す
parseLong("99", 8) は a NumberFormatException を投げる
parseLong("Hazelnut", 10) は a NumberFormatExceptionを投げる
parseLong("Hazelnut", 36) は 1356099454469L を返す

20.8.19 public static Long valueOf(String s)
throws NumberFormatException

実引数は，符号付き10進整数を表現していると解釈される。これは，実引数を一つ取るメソッド parseLong (20.8.17)に，この実引数を渡す場合と同じとする。文字列で指定された整数値を表すLongオブジェクト を返す。

言い換えれば，このメソッドは，次の式の値に等しいLongオブジェクト を返す。

new Long(Long.parseLong(s))

20.8.20 public static Long valueOf(String s, int radix)
throws NumberFormatException

一つ目の実引数は，二つ目の実引数で指定された整数を基数とする符号付き整数として解釈される。これは，実引数を二つ取るメソッドparseLong (20.8.18)に，この実引数を渡す場合と同じとする。文字列で指定された整数値を表すLongオブジェクト を返す。

言い換えれば，このメソッドは，次の式の値に等しいLongオブジェクト を返す。

new Long(Long.parseLong(s, radix))

20.8.21 public static Long getLong(String nm)

実引数は，メソッド System.getProperty( 20.18.9)で取得されるものと同じシステム属性の名前として扱われる。この属性の文字列値は，整数値として解釈され，この値を表現するLongオブジェクトを返す。指定した名前の属性がない場合，又は属性の値が数値として正しい書式でない場合，nullを返す。

言い換えれば，このメソッドは，次の式の値に等しいLongオブジェクト を返す。

getLong(nm, null)

20.8.22 public static Long getLong(String nm, long val)

一つ目の実引数は，メソッド System.getProperty(20.18.9)で取得されるものと同じシステム属性の名前として扱われる。この属性の文字列値は，整数値として解釈され，この値を表現するオブジェクト Long を返す。属性の値が数値として正しい書式でない場合，二つ目の実引数の値を表現するLongオブジェクト を返す。

言い換えれば，このメソッドは，次の式の値に等しいオブジェクト Long を返す。

getLong(nm, new Long(val))

Long result = getLong(nm, null);
return (result == null) ? new Long(val) : result;

20.8.23 public static Long getLong(String nm, Long val)

一つ目の実引数は，メソッド System.getProperty(20.18.9)で取得されるものと同じシステム属性の名前として扱われる。この属性の文字列値は，整数値として解釈され，この値を表現するLongオブジェクト を返す。

• 属性値が二つのASCII文字 0x で始まる場合，又はASCII文字 #で始まり，その後ろにマイナス記号が続かない場合，残りの部分は，16を基数とするメソッド Long.valueOf(20.7.20)と同じ方法で，16進整数として解析される。
• 属性値がASCII文字 0 で始まり，その後ろに他の文字が続く場合，8 を基数とするメソッド Long.valueOf(20.7.20)と同じ方法で8進整数として解析される。
• それ以外の場合，属性値は 10 を基数とするメソッド Long.valueOf(20.7.20)と同じ方法で10進整数として解析される。

二つ目の実引数は，デフォルト値として使われる。指定された名前の属性が存在しない場合，又は属性の値が数値として正しい書式ではない場合，二つ目の実引数を返す。

20.9 クラス java.lang.Float

public final class Float extends Number {
    public static final float MIN_VALUE = 1.4e-45f;
    public static final float MAX_VALUE = 3.4028235e+38f;
    public static final float NEGATIVE_INFINITY = -1.0f/0.0f;
    public static final float POSITIVE_INFINITY = 1.0f/0.0f;
    public static final float NaN = 0.0f/0.0f;
    public Float(float value);
    public Float(double value);
    public Float(String s)
        throws NumberFormatException;
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    public int intValue();
    public long longValue();
    public float floatValue();
    public double doubleValue();
    public static String toString(float f);
    public static Float valueOf(String s)
        throws NullPointerException, NumberFormatException;
    public boolean isNaN();
    public static boolean isNaN(float v);
    public boolean isInfinite();
    public static boolean isInfinite(float v);
    public static int floatToIntBits(float value);
    public static float intBitsToFloat(int bits);
}

20.9.1 public static final float MIN_VALUE = 1.4e-45f;

このフィールドの定数値は，型 floatのゼロ以外の正の最小値とする。この値は，Float.intBitsToFloat(0x1)が返す値と等しい。

20.9.2 public static final float MAX_VALUE = 3.4028235e+38f;

このフィールドの定数値は，型 floatの正の有限な最大値とする。この値は，Float.intBitsToFloat(0x7f7fffff)が返す値と等しい。

20.9.3 public static final float NEGATIVE_INFINITY =
-1.0f/0.0f;

このフィールドの定数値は，型 floatの負の無限大とする。この値は，Float.intBitsToFloat(0xff800000)が返す値と等しい。

20.9.4 public static final float POSITIVE_INFINITY =
1.0f/0.0f;

このフィールドの定数値は，型 floatの正の無限大とする。この値は，Float.intBitsToFloat(0x7f800000)が返す値と等しい。

20.9.5 public static final float NaN = 0.0f/0.0f;

このフィールドの定数値は，型 floatのNaN値とする。この値は，Float.intBitsToFloat(0x7fc00000)が返す値と等しい。

20.9.6 public Float(float value)

このコンストラクタは，Floatオブジェクトを新しく作成し，実引数に指定されたプリミティブ値で初期化する。

20.9.7 public Float(double value)

このコンストラクタは，Floatオブジェクトを新しく作成し，実引数を型 double から型 floatに下位変換(5.1.3)した値でそれを初期化する。

20.9.8 public Float(String s) throws NumberFormatException

このコンストラクタは，Floatオブジェクトを新しく作成し，文字列で表現される型 float の浮動小数点値で初期化する。文字列は，メソッド valueOf(20.9.17)と同じ方法で float 値に変換される。

20.9.9 public String toString()

このFloatオブジェクト によって表現されるプリミティブなfloat 値は，実引数を一つ取るメソッド toString (20.9.16)と全く同じように，文字列に変換される。

オブジェクトのメソッド toString を上書きする(20.1.2)。

20.9.10 public boolean equals(Object obj)

実引数が null でなく，このFloatオブジェクト と同じfloat値を表現する場合に，またその場合にだけ，trueを返す。ここでは，二つの float 値をそれぞれメソッドfloatToIntBits(20.9.22)に渡し，同じ int 値が返された場合に限り，二つの float値が同じだと見なす。左右のオペランドがNaNの場合，== 演算子は false を返すが，このメソッド equalsは，このFloatオブジェクトと実引数の両方がNaNを表現している場合，true を返す。一方，片方のオペランドが正のゼロで，もう片方が負のゼロである場合，== 演算子は true を返すが，このFloatオブジェクト と実引数が，それぞれ符号の異なるゼロを表現している場合，このメソッド equals は falseを返す。この仕様により，ハッシュテーブルが正しく動作するようになる。

オブジェクトのメソッド equals(20.1.3)を上書きする。

20.9.11 public int hashCode()

このFloatオブジェクト によって表現される型 float のプリミティブ値の整数ビット表現を返す。この値は，メソッド floatToIntBits(20.9.22)と同じ方法で取得される。

Object のメソッド hashCode(20.1.4)を上書きする。

20.9.12 public int intValue()

このFloatオブジェクト によって表現される float 値が，型 int に変換(5.1.3)され，その変換結果を返す。

Number のメソッド intValue(20.6.1)を上書きする。

20.9.13 public long longValue()

このFloatオブジェクト によって表現される float値が，型 long に変換(5.1.3)され，その変換結果を返す。

Number のメソッド longValue(20.6.2)を上書きする。

20.9.14 public float floatValue()

このFloatオブジェクト によって表現される float値を返す

Number のメソッド floatValue(20.6.3)を上書きする。

20.9.15 public double doubleValue()

このFloatオブジェクト によって表現される float値が，型 double に変換(5.1.2)され，その変換結果を返す。

Number のメソッド doubleValue(20.6.4)を上書きする。

20.9.16 public static String toString(float f)

実引数は，以下に示す判読可能な文字列形式に変換される。すべての文字及び文字列は，ASCII文字とする。

• 実引数がNaNの場合，文字列 "NaN" に変換する。
• それ以外の場合，実引数の符号と絶対値を表す文字列に変換する。符号が負の場合，戻り値の先頭文字は，'-'('\u002d')とする。符号が正の場合，符号を示す文字はない。絶対値m について，
  • m が無限大である場合は，文字"Infinity"によって表現される。したがって，正の無限大は，"Infinity"を返し，負の無限大は "-Infinity" を返す。
  • m がゼロである場合は，文字 "0.0"によって表現される。したがって，負のゼロは "-0.0" を返し，正のゼロは "0.0" を返す。
  • m が以上かつ 未満の場合，m の整数部(先行するゼロのない10進形式)，小数点 '.' (\u002E)，及び m の小数部を表す一つ以上の10進数で m を表現する。 m が未満又は 以上の場合，いわゆる“コンピュータ用科学表記”で m を表現する。n を となる一意の整数とし， でm を割ったときの正しい商を a とすると， となる。このとき，絶対値は a の整数部(1桁の10進値)，小数点 '.' (\u002E)，a の小数部を表す10進数字，'E'(\u0045)，及び n の10進整数表現で表現される。この値は，実引数を一つ取る Integer.toString (20.7.12)と同じ方法で取得される。

［メソッド toString は，バージョン1.1のJavaで導入予定である。］

20.9.17 public static Float valueOf(String s)
throws NullPointerException, NumberFormatException

文字列 s は，浮動小数点値表現として解釈され，その値を表すオブジェクト Float が作成され，それを返す。

s が null である場合，NullPointerException が投げられる。

s の前後の空白類(20.5.19)は，無視される。s の残りの部分は，字句文法規則に記述された FloatValue を構成する必要がある。

    FloatValue:
        Signopt Digits . Digitsopt ExponentPartopt
        Signopt . Digits ExponentPartopt

Javaのソースコード(3.10.1)の場合と異なり， F又はfを型指示子を文字列 s 中に使うことはできない。

20.9.18 public boolean isNaN()

このFloatオブジェクト によって表現される値がNaNである場合に，またその場合にだけ，true を返す。

20.9.19 public static boolean isNaN(float v)

実引数の値がNaNである場合に，またその場合にだけ，true を返す。

20.9.20 public boolean isInfinite()

このFloatオブジェクトによって表現される値が正又は負の無限大である場合に，またその場合にだけ，trueを返す。

20.9.21 public static boolean isInfinite(float v)

実引数の値が正又は負の無限大である場合に，またその場合にだけ，true を返す。

20.9.22 public static int floatToIntBits(float value)

浮動小数点の実引数を，IEEE 754の“単精度”ビットレイアウト表現に変換したものを返す。

• 第31ビット(マスク 0x80000000 で選択されるビット)は，浮動小数点数の符号を表現する。
• 第30ビットから23ビット(マスク 0x7f800000 で選択されるビット)は，指数を表現する。
• 第22ビットから0ビット(マスク 0x007fffff で選択されるビット)は，浮動小数点数の有効数(仮数とも言う)を表現する。
• 実引数が正の無限大の場合，0x7f800000 を返す。
• 実引数が負の無限大の場合，0xff800000 を返す。
• 実引数がNaNの場合，0x7fc00000 を返す。

20.9.23 public static float intBitsToFloat(int bits)

実引数は，IEEE 754の“単精度”ビットレイアウト表現に変換したものであると見なされ，この値を返す。

• 実引数が 0x7f800000 の場合，正の無限大を返す。
• 実引数が 0xff800000 の場合，負の無限大を返す。
• 実引数が 0x7f800001 から 0x7fffffff まで，又はcode>0xff800001 から 0xffffffff までの範囲にある場合，NaNを返す(Java言語では，事実上すべてのIEEE 754NaN値が単一のNaNと呼ばれる)。
• これ以外のすべての場合，s，e，及び m を次のように実引数から求められる値とする。

int s = ((bits >> 31) == 0) ? 1 : -1;
int e = ((bits >> 23) & 0xff);
int m = (e == 0) ?
        (bits & 0x7fffff) << 1 :
        (bits & 0x7fffff) | 0x800000;

20.10 クラス java.lang.Double

public final class Double extends Number {
    public static final double MIN_VALUE =
        5e-324;
    public static final double MAX_VALUE =
         1.7976931348623157e+308;
    public static final double NEGATIVE_INFINITY = -1.0/0.0;
    public static final double POSITIVE_INFINITY = 1.0/0.0;
    public static final double NaN = 0.0/0.0;
    public Double(double value);
    public Double(String s)
        throws NumberFormatException;
    public String toString();
    public boolean equals(Object obj);
    public int hashCode();
    public int intValue();
    public long longValue();
    public float floatValue();
    public double doubleValue();
    public static String toString(double d);
    public static Double valueOf(String s)
        throws NullPointerException, NumberFormatException;
    public boolean isNaN();
    public static boolean isNaN(double v);
    public boolean isInfinite();
    public static boolean isInfinite(double v);
    public static long doubleToLongBits(double value);
    public static double longBitsToDouble(long bits);
}

20.10.1 public static final double MIN_VALUE = 5e-324;

このフィールドの定数値は，型 double の正のゼロ以外の最小値とする。 この値は，Double.Double.longBitsToDouble(0x1L) が返す値と等しい。

20.10.2 public static final double MAX_VALUE = 1.7976931348623157e+308;

このフィールドの定数値は，型 double の正のゼロ以外の有限な最大値とする。この値は，次の式が返す値と等しい。

Double.longBitsToDouble(0x7fefffffffffffffL)

20.10.3 public static final double NEGATIVE_INFINITY = -1.0/0.0;

このフィールドの定数値は，型 double の負の無限大とする。この値は， Double.longBitsToDouble(0xfff0000000000000L) が返す値と等しい。

20.10.4 public static final double POSITIVE_INFINITY = 1.0/0.0;

このフィールドの定数値は，型 double の正の無限大とする。この値は，Double.longBitsToDouble(0x7ff0000000000000L) が返す値と等しい。

20.10.5 public static final double NaN = 0.0/0.0;

このフィールドの定数値は，型 double のNaN値とする。この値は，Double.longBitsToDouble(0x7ff8000000000000L) が返す値と等しい。

20.10.6 public Double(double value)

このコンストラクタは，Doubleオブジェクト を新しく作成し，実引数に指定されたプリミティブ値で初期化する。

20.10.7 public Double(String s)
throws NumberFormatException

このコンストラクタは，Doubleオブジェクト を新しく作成し，実引数に与えられた文字列によって表現される型 double の浮動小数点値で初期化する。文字列は，メソッド valueOf(20.9.17)と同じ方法で double 値に変換される。

20.10.8 public String toString()

このDoubleオブジェクト によって表現されるプリミティブな double 値は，実引数を一つ取るメソッド toString(20.10.15)と同じ方法で文字列に変換される。

オブジェクトのメソッド toString を上書きする(20.1.2)。

20.10.9 public boolean equals(Object obj)

実引数が null でなく，このDoubleオブジェクト と同じ double 値を表現する場合に，またその場合にだけ，true を返す。ここでは，二つの double 値をそれぞれメソッド doubleToLongBits(20.10.21)に渡し，同じ long 値が返された場合に限り，二つの double 値が同じだと見なす。左右のオペランドがNaNの場合，== 演算子は false を返すが，このメソッド equals は，このDoubleオブジェクト と実引数の両方がNaNを表現している場合，true を返す。一方，片方のオペランドが正のゼロで，もう片方が負のゼロである場合，== 演算子は true を返すが，このDoubleオブジェクト と実引数が，それぞれ符号の異なるゼロを表現している場合，このメソッド equals は false を返す。一方，片方のオペランドが正のゼロで，もう片方が負のゼロである場合，== 演算子は true を返すが，このDoubleオブジェクト と実引数が，それぞれ符号の異なるゼロを表現している場合，このメソッド equals は false を返す。この仕様により，ハッシュテーブルを正しく操作できる。

オブジェクトのメソッド equals(20.1.3)を上書きする。

20.10.10 public int hashCode()

このDoubleオブジェクト によって表現されるプリミティブな double 値のlong整数ビット表現の上位ビットと下位ビットについて，メソッド doubleToLongBits(20.10.21)と同じ方法によって得られる排他的論理和を返す。つまり，ハッシュコード値は，次の式の値になる。

(int)(v^(v>>>32))

long v = Double.doubleToLongBits(this.longValue());

20.10.11 public int intValue()

このDoubleオブジェクト によって表現される double 値が，型 int に変換(5.1.3)され，その変換結果を返す。

Number のメソッド intValue(20.6.1)を上書きする。

20.10.12 public long longValue()

このDoubleオブジェクト によって表現される double 値が，型 long に変換(5.1.3)され，その変換結果を返す。

Number のメソッド longValue(20.6.2)を上書きする。

20.10.13 public float floatValue()

このDoubleオブジェクト によって表現される double 値が，型 float に変換(5.1.3)され，その変換結果を返す。

Number のメソッド floatValue(20.6.3)を上書きする。

20.10.14 public double doubleValue()

このDoubleオブジェクト によって表現される double 値を返す。

Number のメソッド doubleValue(20.6.4)を上書きする。

20.10.15 public static String toString(double d)

実引数は，以下に示す判読可能な文字列形式に変換される。すべての文字及び文字列は，ASCII文字とする。

• 実引数がNaNの場合，文字列 "NaN" に変換する。
• それ以外の場合，実引数の符号と絶対値を表す文字列に変換する。符号が負の場合，戻り値の先頭文字は，'-' ('\u002d')とする。符号が正の場合，符号を示す文字はない。絶対値 m について，
  • m が無限大である場合は，文字 "Infinity" によって表現される。したがって，正の無限大は，"Infinity" を返し，負の無限大は "-Infinity" を返す。
  • m がゼロである場合は，文字 "0.0" によって表現される。したがって，負のゼロは "-0.0" を返し，正のゼロは "0.0" を返す。
  • m が以上かつ未満の場合，m の整数部(先行するゼロのない10進形式)，小数点 '.' (\u002E)，及び m の小数部を表す一つ以上の10進数でmを表現する。
  • m が未満又は 以上の場合，いわゆる“コンピュータ用科学表記”で m を表現する。n をとなる一意の整数とし，で m を割ったときの正しい商を a とすると，となる。このとき，絶対値はaの整数部(1桁の10進値)，小数点 '.'(\u002E)，a の小数部を表す10進数字，'E'(\u0045)，及び n の10進整数表現で表現される。この値は，実引数を一つ取る Integer.toString (20.7.12)と同じ方法で取得される。

［メソッド toStringは，バージョン1.1のJavaで導入予定である。］

20.10.16 public static Double valueOf(String s)
throws NullPointerException, NumberFormatException

文字列 s は，浮動小数点値表現として解釈され，その値を表すDoubleオブジェクト が作成され，それを返す。

s が nullである場合，NullPointerException が投げられる。

s の前後の空白類(20.5.19)は，無視される。s の残りの部分は，字句文法規則に記述された FloatValue を構成する必要がある。

    FloatValue:
        Signopt Digits . Digitsopt ExponentPartopt
        Signopt . Digits ExponentPartopt

Javaのソースコード(3.10.1)の場合と異なり，D 又は d を型指示子を文字列 s 中に使うことはできない。

20.10.17 public boolean isNaN()

このDoubleオブジェクト によって表現される値がNaNである場合に，またその場合にだけ，true を返す。

20.10.18 public static boolean isNaN(double v)

実引数の値がNaNである場合に，またその場合にだけ，true を返す。

20.10.19 public boolean isInfinite()

このDoubleオブジェクト で表現される値が，正又は負の無限大である場合に，またその場合にだけ，true を返す。

20.10.20 public static boolean isInfinite(double v)

実引数の値が正又は負の無限大である場合に，またその場合にだけ，true を返す。

20.10.21 public static long doubleToLongBits(double value)

浮動小数点の実引数を，IEEE 754の“倍精度”ビットレイアウト表現に変換したものを返す。

• 第63ビット(マスク 0x8000000000000000L で選択されるビット)は，浮動小数点数の符号を表現する。
• 第62ビットから52ビット(マスク 0x7ff0000000000000L で選択されるビット)は，指数を表現する。
• 第51ビットから0ビット(マスク 0x000fffffffffffffL で選択されるビット)は，浮動小数点数の有効数(仮数とも言う)を表現する。
• 実引数が正の無限大の場合，0x7ff0000000000000L を返す。
• 実引数が負の無限大の場合，0xfff0000000000000L を返す。
• 実引数がNaNの場合，0x7ff8000000000000L を返す。

20.10.22 public static double longBitsToDouble(long bits)

実引数が，IEEE 754の“倍精度”ビットレイアウト表現に従って，浮動小数点表現であるとみなされ，その浮動小数点値が返されれる。

• 実引数が 0x7f80000000000000L の場合，正の無限大を返す。
• 実引数が 0xff80000000000000L の場合，負の無限大を返す。
• 実引数が 0x7ff0000000000001L から 0x7fffffffffffffffL まで，又は0xfff0000000000001Lから 0xffffffffffffffffL までの範囲にある場合，NaNを返す(Java言語では，事実上すべてのIEEE 754 NaN値が単一のNaNと呼ばれる)。
• これ以外のすべての場合，s，e，及び m を次のように実引数から求められる値とする。

int s = ((bits >> 63) == 0) ? 1 : -1;
int e = (int)((bits >> 52) & 0x7ffL);
long m = (e == 0) ?
    (bits & 0xfffffffffffffL) << 1 :
    (bits & 0xfffffffffffffL) | 0x10000000000000L;

20.11 クラス java.lang.Math

public final class Math {
    public static final double E = 2.7182818284590452354;
    public static final double PI = 3.14159265358979323846;
    public static double sin(double a);
    public static double cos(double a);
    public static double tan(double a);
    public static double asin(double a);
    public static double acos(double a);
    public static double atan(double a);
    public static double atan2(double a, double b);
    public static double exp(double a);
    public static double log(double a);
    public static double sqrt(double a);
    public static double pow(double a, double b);
    public static double IEEEremainder(double f1, double f2);
    public static double ceil(double a);
    public static double floor(double a);
    public static double rint(double a);
    public static int round(float a);
    public static long round(double a);
    public static double random();
    public static int abs(int a);
    public static long abs(long a);
    public static float abs(float a);
    public static double abs(double a);
    public static int min(int a, int b);
    public static long min(long a, long b);
    public static float min(float a, float b);
    public static double min(double a, double b);
    public static int max(int a, int b);
    public static long max(long a, long b);
    public static float max(float a, float b);
    public static double max(double a, double b);
}

Java数学ライブラリは，1995年1月4日版の fdlibm に基づいて定義されている。ある関数について fdlibm で複数の定義をしている場合（acosなど），“IEEE754コア関数”版が使用されている（これは，文字 e で始まるファイルに入っている）。

これらの関数で使用するアルゴリズムの完全な記述は，この仕様書の今後のバージョンで行なう。

20.11.1 public static final double E = 2.7182818284590452354;

このフィールドの定数値は，自然対数の底 e に最も近い double 値である。

20.11.2 public static final double PI = 3.14159265358979323846;

このフィールドの定数値は，円周率に最も近い double 値である。

20.11.3 public static double sin(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている sin アルゴリズムを使用して，実引数のサインの近似値を計算する。

次は，特別な場合である。

• 実引数がNaNか無限大である場合，NaNを返す。
• 実引数が正のゼロの場合，正のゼロを返す。実引数が負のゼロの場合，負のゼロを返す。

20.11.4 public static double cos(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている cos アルゴリズムを使用して，実引数のコサインの近似値を計算する。

次は，特別な場合である。

• 実引数がNaNか無限大である場合，NaNを返す。

20.11.5 public static double tan(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている tan アルゴリズムを使用して，実引数のタンジェントの近似値を計算する。

次は，特別な場合である。

• 実引数がNaNか無限大である場合，NaNを返す。
• 実引数が正のゼロの場合，正のゼロを返す。実引数が負のゼロの場合，負のゼロを返す。

20.11.6 public static double asin(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている asin アルゴリズムを使用して，実引数のアークサインの近似値を計算する。

次は，特別な場合である。

• 実引数がNaNの場合，又は実引数の絶対値が1より大きい場合，NaNを返す。
• 実引数が正のゼロの場合，正のゼロを返す。実引数が負のゼロの場合，負のゼロを返す。

20.11.7 public static double acos(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている acos アルゴリズムを使用して，実引数のアークコサインの近似値を計算する。

次は，特別な場合である。

• 実引数がNaNの場合，又は実引数の絶対値が1より大きい場合，NaNを返す。

20.11.8 public static double atan(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている atan アルゴリズムを使用して，実引数のアークタンジェントの近似値を計算する。

次は，特別な場合である。

• 実引数がNaNである場合，NaNを返す。
• 実引数が正のゼロの場合，正のゼロを返す。実引数が負のゼロの場合，負のゼロを返す。

20.11.9 public static double atan2(double y, double x)

このメソッドは，fdlibm に公開されているtan2アルゴリズムを使用して，二つの実引数の商のアークタンジェントの近似値を計算する。

次は，特別な場合である。

• 実引数のどちらかがNaNである場合，NaNを返す。
• 一つ目の実引数が正のゼロであり，かつ二つ目の実引数が正である場合，又は一つ目の実引数が正の有限値であり，かつ二つ目の実引数が正の無限大である場合，正のゼロを返す。
• 一つ目の実引数が負のゼロであり，かつ二つ目の実引数が正である場合，又は一つ目の実引数が負の有限値であり，かつ二つ目の実引数が正の無限大である場合，負のゼロを返す。
• 一つ目の実引数が正のゼロであり，かつ二つ目の実引数が負である場合，又は一つ目の実引数が正の有限値であり，かつ二つ目の実引数が負の無限大である場合， に最も近い double 値を返す。
• 一つ目の実引数が負のゼロであり，かつ二つ目の実引数が負である場合，又は一つ目の実引数が負の有限値であり，かつ二つ目の実引数が負の無限大である場合，に最も近い double 値を返す。
• 一つ目の実引数が正であり，かつ二つ目の実引数が正又は負のゼロである場合，又は一つ目の実引数が正の無限大であり，かつ二つ目の実引数が有限値である場合， に最も近い double 値を返す。
• 一つ目の実引数が負であり，かつ二つ目の実引数が正又は負のゼロである場合，又は一つ目の実引数が負の無限大であり，かつ二つ目の実引数が有限値である場合， に最も近い double 値を返す。
• 両方の実引数が正の無限大である場合， に最も近い double 値を返す。
• 一つ目の実引数が正の無限大であり，二つ目の実引数が負の無限大である場合， に最も近い double 値を返す。
• 一つ目の実引数が負の無限大であり，かつ二つ目の実引数が正の無限大である場合， に最も近い double 値を返す。
• 両方の実引数が負の無限大である場合， に最も近い double 値を返す。

20.11.10 public static double exp(double a)

このメソッドは，fdlibm(本節序文参照)に公開されているexpアルゴリズムを使用して，実引数の指数関数の近似値(自然対数の底 e(20.11.1)を実引数で累乗)を計算する。

次は，特別な場合である。

• 実引数がNaNである場合，NaNを返す。
• 実引数が正の無限大である場合，正の無限大を返す。
• 実引数が負の無限大である場合，正のゼロを返す。

20.11.11 public static double log(double a)

このメソッドは，fdlibm(本節序文参照)に公開されている log アルゴリズムを使用して，実引数の自然対数の近似値を計算する。

次は，特別な場合である。

• 実引数がNaN又はゼロより小さい場合，NaNを返す。
• 実引数が正の無限大である場合，正の無限大を返す。
• 実引数が正又は負のゼロである場合，負の無限大を返す。

20.11.12 public static double sqrt(double a)

このメソッドは，実引数の平方根の近似値を計算する。

次は，特別な場合である。

• 実引数がNaN又はゼロより小さい場合，NaNを返す。
• 実引数が正の無限大である場合，正の無限大を返す。
• 実引数が正又は負のゼロである場合，実引数と同じ値を返す。

20.11.13 public static double pow(double a, double b)

このメソッドは，fdlibm(本節序文参照)に公開されている pow アルゴリズムを使用して，最初の実引数を 2 番目の実引数で累乗した値の近似値を計算する。

次は，特別な場合である。

• 二つ目の実引数が正又は負のゼロである場合，1.0 を返す。
• 二つ目の実引数が 1.0 である場合，一つ目の実引数と同じ値を返す。
• 二つ目の実引数がNaNである場合，NaNを返す。
• 一つ目の実引数がNaNであり，かつ二つ目の実引数がゼロ以外である場合，NaNを返す。
• 一つ目の実引数の絶対値が1より大きく，かつ二つ目の実引数が正の無限大である場合，又は一つ目の実引数の絶対値が1より小さく，かつ二つ目の実引数が負の無限大である場合，正の無限大を返す。
• 一つ目の実引数の絶対値が1より大きく，かつ二つ目の実引数が負の無限大である場合，又は一つ目の実引数の絶対値が1より小さく，かつ二つ目の実引数が正の無限大である場合，正のゼロを返す。
• 一つ目の実引数の絶対値が1と等しく，かつ二つ目の実引数が無限大である場合，NaNを返す。
• 一つ目の実引数が正のゼロであり，かつ二つ目の実引数がゼロより大きい場合，又は一つ目の実引数が正の無限大であり，かつ二つ目の実引数がゼロより小さい場合，正のゼロを返す。
• 一つ目の実引数が正のゼロであり，かつ二つ目の実引数がゼロより小さい場合，又は一つ目の実引数が正の無限大であり，かつ二つ目の実引数がゼロより大きい場合，正の無限大を返す。
• 一つ目の実引数が負のゼロであり，かつ二つ目の実引数がゼロより大きく，有限の奇数の整数でない場合，又は一つ目の実引数が負の無限大であり，かつ二つ目の実引数がゼロより小さく，有限の奇数の整数でない場合，正のゼロを返す。
• 一つ目の実引数が負のゼロであり，かつ二つ目の実引数が正の有限の奇数の整数である場合，又は一つ目の実引数が負の無限大であり，かつ二つ目の実引数が負の有限の奇数の整数である場合，負のゼロを返す。
• 一つ目の実引数が負のゼロであり，かつ二つ目の実引数がゼロより小さく，有限の奇数の整数である場合，又は一つ目の実引数が負の無限大であり，かつ二つ目の実引数がゼロより大きく，有限の奇数の整数でない場合，正の無限大を返す。
• 一つ目の実引数が負のゼロであり，かつ二つ目の実引数が負の有限の奇数の整数である場合，又は一つ目の実引数が負の無限大であり，かつ二つ目の実引数が正の有限の奇数の整数である場合，負の無限大を返す。
• 一つ目の実引数がゼロより小さく，二つ目の実引数が有限の偶数の整数である場合，最初の実引数の絶対値を二つ目の実引数で累乗した値を返す。
• 一つ目の実引数がゼロより小さく，二つ目の実引数が有限の奇数の整数である場合，最初の実引数の絶対値を二つ目の実引数で累乗した値を返す。
• 一つ目の実引数が有限でゼロより小さく，かつ二つ目の実引数が有限で，整数でない場合，の奇数の整数である場合，NaNを返す。
• 両方の実引数が整数の場合，戻り値を正確に double 値として表すことができるときは，一つ目の実引数を二つ目の実引数で累乗した値を返す。

20.11.14 public static double IEEEremainder(double x, double y)

このメソッドは，IEEE 754規格に従って，二つの実引数の剰余を計算する。剰余の値は， と等しくなる。ここで， は正確な商 に最も近い整数でとする。二つの整数が同等に ;に近い場合，偶数の方が n になる。剰余がゼロの場合の符号は，最初の実引数の符号と同じになる。

次は，特別な場合である。

• いずれかの実引数がNaNの場合，又は一つ目の実引数が無限大で，二つ目の実引数が正又は負のゼロの場合，NaNを返す。
• 一つ目の実引数が有限値で，かつ二つ目の実引数が無限大の場合，一つ目の実引数と同じ値を返す。

20.11.15 public static double ceil(double a)

このメソッドは，実引数以上の値を持つ最小の(負の無限大に最も近い)整数を double 値で返す。

次は，特別な場合である。

• 実引数の値が既に整数である場合，実引数と同じ値を返す。
• 実引数がNaN又は無限大又は正又は負のゼロである場合，実引数と同じ値を返す。
• 実引数の値がゼロより小さく，-1.0 より大きい場合，負のゼロを返す。

20.11.16 public static double floor(double a)

このメソッドは，実引数以下の値を持つ最大の(正の無限大に最も近い)整数を double 値で返す。

次は，特別な場合である。

• 実引数の値が既に整数である場合，実引数と同じ値を返す。
• 実引数がNaN又は無限大又は正又は負のゼロである場合，実引数と同じ値を返す。

20.11.17 public static double rint(double a)

このメソッドは，実引数に最も近い整数を double 値で返す。整数である二つの double 値が同等に実引数の値に近い場合，偶数の方の整数を返す。

次は，特別な場合である。

• 実引数の値が既に整数である場合，実引数と同じ値を返す。
• 実引数がNaN又は無限大又は正又は負のゼロである場合，実引数と同じ値を返す。

20.11.18 public static int round(float a)

実引数にを加え，その小数点以下を取り，型 int にキャストした整数を返す。

言い換えれば，次の式の値と等しい結果が得られる。

(int)Math.floor(a + 0.5f)

• 実引数がNaNである場合，0 を返す。
• 実引数が負の無限大，又は Integer.MIN_VALUE (20.7.1) の値以下である場合，Integer.MIN_VALUEの値を返す。
• 実引数が正の無限大，又は Integer.MAX_VALUE (20.7.2) の値以上である場合，Integer.MAX_VALUE の値を返す。

20.11.19 public static long round(double a)

このメソッドは，実引数にを加え，その小数点以下を取り，型 long にキャストした整数を返す。

言い換えれば，次の式の値と等しい結果が得られる。

(long)Math.floor(a + 0.5d)

• 実引数がNaNである場合，0 を返す。
• 実引数が負の無限大，又は Long.MIN_VALUE (20.7.1) の値以下である場合，Long.MIN_VALUEの値を返す。
• 実引数が正の無限大，又は Long.MAX_VALUE (20.7.2) の値以上である場合，Long.MAX_VALUE の値を返す。

20.11.20 public static double random()

ゼロ以上でcode>1.0 より小さく，この範囲から(ほぼ)一律に選択された擬似乱数を正の符号を持つ double 値で返す。

このメソッドが初めて呼び出されるときに，次の式と同じ方法で一つの擬似乱数ジェネレータが新しく作成される。

new java.util.Random()

このメソッドは，複数のスレッドで正しく使用することができるように正しく同期化されている。ただし，多数のスレッドが高速で擬似乱数を発生する必要がある場合，各スレッドで独自の擬似乱数ジェネレータを所有すれば，競合を減らせる。

20.11.21 public static int abs(int a)

可能な場合，実引数の絶対値を返す。

実引数が負ではない場合，実引数を返す。

実引数が負の場合，実引数の符号を反転させた値を返す。実引数が Integer.MIN_VALUE (20.7.1)の値，つまり int で表現可能な最も小さい負の数値と等しい場合，実引数の値が負のまま返される。

20.11.22 public static long abs(long a)

可能な場合，実引数の絶対値を返す。

実引数が負ではない場合，実引数を返す。

実引数が負の場合，実引数の符号を反転させた値を返す。実引数が Long.MIN_VALUE (20.8.1)の値，つまり long で表現可能な最も小さい負の数値と等しい場合，実引数の値が負のまま返される。

20.11.23 public static float abs(float a)

実引数の符号を正にした値を返す。

次は，特別な場合である。

• 実引数が正又は負のゼロの場合，正のゼロを返す。
• 実引数が無限大の場合，正の無限大を返す。
• 実引数がNaNの場合，NaNを返す。

Float.intBitsToFloat(0x7fffffff & Float.floatToIntBits(a))

20.11.24 public static double abs(double a)

実引数の符号を正にした値を返す。

次は，特別な場合である。

• 実引数が正又は負のゼロの場合，正のゼロを返す。
• 実引数が無限大の場合，正の無限大を返す。
• 実引数がNaNの場合，NaNを返す。

Double.longBitsToDouble((Double.doubleToLongBits(a)<<1)>>>1)

20.11.25 public static int min(int a, int b)

二つの実引数のうちの小さい方が---つまり，Integer.MIN_VALUE (20.7.1)の値に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

20.11.26 public static long min(long a, long b)

二つの実引数のうちの小さい方が---つまり，Long.MIN_VALUE (20.8.1)の値に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

20.11.27 public static float min(float a, float b)

二つの実引数のうちの小さいほうが---つまり，負の無限大に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

次は，特別な場合である。

• 一つの実引数が正のゼロで，もう一つが負のゼロである場合，負のゼロを返す。
• どちらかの実引数がNaNである場合，NaNを返す。

20.11.28 public static double min(double a, double b)

二つの実引数のうち小さい方が---つまり，負の無限大に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

次は，特別な場合である。

• 一つの実引数が正のゼロで，もう一つが負のゼロである場合，負のゼロを返す。
• どちらかの実引数がNaNである場合，NaNを返す。

20.11.29 public static int max(int a, int b)

二つの実引数のうち大きい方が---つまり，Integer.MAX_VALUE (20.7.2)に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

20.11.30 public static long max(long a, long b)

二つの実引数のうち大きい方が---つまり，Long.MAX_VALUE (20.8.2)に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

20.11.31 public static float max(float a, float b)

二つの実引数のうち大きい方が---つまり，正の無限大に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

次は，特別な場合である。

• 一つの実引数が正のゼロで，もう一つが負のゼロである場合，正のゼロを返す。
• どちらかの実引数がNaNである場合，NaNを返す。

20.11.32 public static double max(double a, double b)

二つの実引数のうち大きい方が---つまり，正の無限大に近いほうを返す。二つの実引数が同じ値である場合，その同じ値を返す。

次は，特別な場合である。

• 一つの実引数が正のゼロで，もう一つが負のゼロである場合，正のゼロを返す。
• どちらかの実引数がNaNである場合，NaNを返す。

20.12 クラス java.lang.String

クラス String には，文字列内の個々の文字の検査，文字列の比較，文字列の検索，部分文字列の抽出，文字列内のすべての文字の大文字又は小文字への変換などを行うメソッドがある。

public final class String {
    public String();
    public String(String value)
        throws NullPointerException;
    public String(StringBuffer buffer)
        throws NullPointerException;
    public String(char[] value)
        throws NullPointerException;
    public String(char[] value, int offset, int count)
        throws NullPointerException, IndexOutOfBoundsException;
    public String(byte[] ascii, int hibyte)
        throws NullPointerException;
    public String(byte[] ascii, int hibyte, int offset, int count)
        throws NullPointerException, IndexOutOfBoundsException;
    public String toString();
    public boolean equals(Object anObject);
    public int hashCode();
    public int length();
    public char charAt(int index);
    public void getChars(int srcBegin, int srcEnd, 
                          char dst[], int dstBegin)
        throws NullPointerException, IndexOutOfBoundsException;
    public void getBytes(int srcBegin, int srcEnd, 
                          byte dst[], int dstBegin)
        throws NullPointerException, IndexOutOfBoundsException;
    public char[] toCharArray();
    public boolean equalsIgnoreCase(String anotherString);
    public int compareTo(String anotherString)
        throws NullPointerException;
    public boolean regionMatches(int toffset, String other, 
                                   int ooffset, int len)
        throws NullPointerException;
    public boolean regionMatches(boolean ignoreCase, int toffset, 
                                   String other, int ooffset, int len)
        throws NullPointerException;
    public boolean startsWith(String prefix)
        throws NullPointerException;
    public boolean startsWith(String prefix, int toffset)
        throws NullPointerException;
    public boolean endsWith(String suffix)
        throws NullPointerException;
    public int indexOf(int ch);
    public int indexOf(int ch, int fromIndex);
    public int indexOf(String str)
        throws NullPointerException;
    public int indexOf(String str, int fromIndex)
        throws NullPointerException;
    public int lastIndexOf(int ch);
    public int lastIndexOf(int ch, int fromIndex);
    public int lastIndexOf(String str)
        throws NullPointerException;
    public int lastIndexOf(String str, int fromIndex)
        throws NullPointerException;
    public String substring(int beginIndex);
    public String substring(int beginIndex, int endIndex);
    public String concat(String str)
        throws NullPointerException;
    public String replace(char oldChar, char newChar);
    public String toLowerCase();
    public String toUpperCase();
    public String trim();
    public static String valueOf(Object obj);
    public static String valueOf(char[] data)
        throws NullPointerException;
    public static String valueOf(char[] data, int offset, int count)
        throws NullPointerException, IndexOutOfBoundsException;
    public static String valueOf(boolean b);
    public static String valueOf(char c);
    public static String valueOf(int i);
    public static String valueOf(long l);
    public static String valueOf(float f);
    public static String valueOf(double d);
    public String intern();
}

20.12.1 public String()

このコンストラクタはStringオブジェクト を新しく作成し，空の文字列で初期化する。

20.12.2 public String(String value)

このコンストラクタはStringオブジェクト を新しく作成し，実引数に指定された文字列で初期化する。言い換えれば，このコンストラクタで新しく作成された文字列は，実引数の文字列の複写とする。

20.12.3 public String(StringBuffer buffer)
throws NullPointerException

このコンストラクタはStringオブジェクト を新しく作成し，実引数 StringBuffer (20.13)に現在含まれている文字列で初期化する。文字列バッファの内容が複写される。これ以降，文字列バッファを変更しても，新しく作成した文字列には影響しない。

buffer が null である場合，NullPointerException が投げられる。

20.12.4 public String(char[] data)
throws NullPointerException

このコンストラクタはStringオブジェクトを新しく作成し，実引数の文字配列に現在含まれている文字列で初期化する。文字配列の内容が複写される。これ以降，文字配列を変更しても，新しく作成した文字列には影響しない。

data が nullの場合，NullPointerException が投げられる。

20.12.5 public String(char[] data, int offset, int count)
throws NullPointerException, IndexOutOfBoundsException

このコンストラクタはStringオブジェクトを新しく作成し，実引数の文字配列の部分配列に現在含まれている文字列で初期化する。文字配列の内容が複写される。これ以降，文字配列を変更しても，新しく作成した文字列には影響しない。実引数 offset には，部分配列の先頭文字のインデクスを指定する。実引数 countには，部分配列の長さを指定する。部分配列の内容が複写される。これ以降，文字配列を変更しても，新しく作成された文字列には影響しない。

data が null の場合，NullPointerException が投げられる。

offset が負である場合，又は count が負である場合，又は offset と count の和が data.length より大きい場合，IndexOutOfBoundsException が投げられる。

20.12.6 public String(byte[] ascii, int hibyte)
throws NullPointerException

このコンストラクタはStringオブジェクトを新しく作成し，8ビット整数値の配列から構成される文字列で初期化する。戻り値の文字列の各文字 c は，バイト配列の対応する要素 b から次のように構成される。

c == ((hibyte & 0xff) << 8) | (b & 0xff)

20.12.7 public String(byte[] ascii, int hibyte,
int offset, int count)
throws NullPointerException,
IndexOutOfBoundsException

このコンストラクタはStringオブジェクトを新しく作成し，8ビット整数値の配列の部分配列から構成される文字列で初期化する。実引数offset には，部分配列の先頭文字のインデクスを指定する。実引数countには，部分配列の長さを指定する。部分配列の内容が複写される。これ以降，文字配列を変更しても，新しく作成された文字列には影響しない。戻り値の文字列の各文字c は，バイト配列の対応する要素 bから次のように構成される。

c == ((hibyte & 0xff) << 8) | (b & 0xff)

offset が負である場合，又は count が負である場合，又は offset と count の和が data.length より大きい場合，IndexOutOfBoundsException が投げられる。

20.12.8 public String toString()

このオブジェクト(既に String になっている)への参照を返す。

このメソッドは，Object のメソッド toString(20.1.2)を上書きする。

20.12.9 public boolean equals(Object anObject)

実引数が null でなく，このStringオブジェクトと同じ文字列を表現するStringオブジェクトである場合に，またその場合にだけ，true を返す。

オブジェクトのメソッド equals(20.1.3)を上書きする。

メソッド equalsIgnoreCase(20.12.16)及びメソッド compareTo (20.12.17)もともに参照のこと。

20.12.10 public int hashCode()

オブジェクトの長さに応じて，このStringオブジェクト のハッシュコードを次のいずれかの方法で計算し，その値を返す。ここで，n を文字の並びの長さ(20.12.11) とし，をインデクス i の文字とする。

• の場合，ハッシュコードは，int 演算を使用してで求められる。
• の場合，ハッシュコードは，int 演算を使用してで求められる。ここで， ，また であり，文字列から 8 文字又は 9 文字だけをサンプリングする。

20.12.11 public int length()

このStringオブジェクト によって表現される文字列の長さを返す。

20.12.12 public char charAt(int index)
throws IndexOutOfBoundsException

このメソッドは，このStringオブジェクト によって表現される文字列から，実引数 index によって示される文字を返す。配列のインデクスと同じように，文字列の先頭の文字はインデクスは 0 で，次の文字はインデクス 1 で示される。実引数 index が負である場合，又はこの文字列の長さ (20.12.11) 以上である場合，IndexOutOfBoundsException が投げられる。

20.12.13 public void getChars(int srcBegin, int srcEnd,
char dst[], int dstBegin)
throws NullPointerException,
IndexOutOfBoundsException

このStringオブジェクト の文字を文字配列 dstに複写する。複写される先頭の文字はインデクス srcBegin で示される。複写される末尾の文字はインデクス srcEnd-1 で示される(したがって，複写される文字の総数はsrcEnd - srcBeginである)。文字は，インデクス dstBegin からインデクス dstBegin + (srcEnd - srcBegin) - 1 までの dst の部分配列に複写される。

dst が null である場合，NullPointerException が投げられる。

次のいずれかの条件が成り立つ場合，IndexOutOfBoundsException が投げられる。

• srcBegin が負である
• srcBegin が srcEnd よりも大きい
• srcEnd がこのStringの長さよりも大きい
• dstBegin が負である
• dstBegin+(srcEnd-srcBegin) が dst.length よりも大きい

20.12.14 public void getBytes(int srcBegin, int srcEnd,
byte dst[], int dstBegin)
throws NullPointerException,
IndexOutOfBoundsException

このStringオブジェクト の文字をバイト配列 dst に複写する。各バイトには，対応する文字の下位 8 ビットだけが入る。各文字の上位8ビットは複写されず，転送には関与しません。複写される先頭の文字はインデクス srcBegin で示される。複写される末尾の文字はインデクス srcEnd-1 で示される(したがって，複写される文字の総数は srcEnd-srcBegin である)。文字は，インデクス dstBegin からインデクス dstBegin+(srcEnd-srcBegin)-1 までのdstの部分配列に複写される。

dst が null である場合，NullPointerException が投げられる。

次のいずれかの条件が成り立つ場合，IndexOutOfBoundsException が投げられる。

• srcBegin が負である
• srcBegin が srcEnd よりも大きい
• srcEnd がこの String の長さよりも大きい
• dstBegin が負である
• dstBegin+(srcEnd-srcBegin) が dst.length よりも大きい

20.12.15 public char[] toCharArray()

文字配列を新しく作成し，それを返す。配列の長さは，このオブジェクト String の長さ(20.12.11)と等しい。配列は初期化され，このオブジェクト String によって表現される文字列を含む。

20.12.16 public boolean equalsIgnoreCase(String anotherString)

実引数が nullでなく，かつ大文字小文字を区別せずに，このStringオブジェクトと同じ文字列を表現するStringオブジェクト である場合に，またその場合にだけ，true を返す。

少なくとも次のうち一つが成り立つ場合，二つの文字は，大文字小文字を区別せずに同じであると見なされる。

• その2文字が同一である(== 演算子で比較される場合と同じ)。
• メソッド Character.toUppercase (20.5.21)の結果が同じとする。
• メソッド Character.toLowercase (20.5.20)の結果が同じとする。

メソッド equals (20.12.9)もともに参照のこと。

20.12.17 public int compareTo(String anotherString)
throws NullPointerException

このStringオブジェクト によって表現される文字列を，辞書順で，実引数によって表現される文字列と比較する。このStringオブジェクトが，辞書順で実引数の文字列に先行する場合，負の整数を返す。このStringオブジェクトが，辞書順で実引数の文字列に後続する場合，正の整数を返す。文字列が等しい場合，ゼロを返す。compareToはメソッドequals(20.12.9)が0 を返す場合には，ゼロを返す。

anotherString が nullである場合，NullPointerException が投げられる。

辞書順とは，次の定義による。二つの文字列が異なる場合，両方の文字列に対して有効なインデクス位置にある文字が異なるか，文字列の長さが異なるか，又はその両方とする。二つの文字列が，複数のインデクス位置で異なる場合，k をそのうちの最小のインデクスとする。位置 k にある文字の値を<演算子で比較し，小さいと判定された方の文字を含む文字列が辞書順でもう一方の文字列に先行する。この場合，compareToは位置 kにある二つの文字列の文字の値の差を返す---つまり，次の式の値を返す。

this.charAt(k)-anotherString.charAt(k)

this.length()-anotherString.length()

20.12.18 public boolean regionMatches(int toffset,
String other, int ooffset, int len)
throws NullPointerException

このStringオブジェクト の部分文字列が，実引数 other の部分文字列と比較される。これらの部分文字列が同一の文字列を表現している場合，trueを返す。比較の対象になるこのStringオブジェクト の部分文字列は，インデクス toffset で始まり，長さがlen とする。比較の対象になる otherの部分文字列は，インデクス ooffset で始まり，長さがlenとする。次の条件の少なくとも一つが成り立つ場合，又はその場合にだけ，falseを返す。

• toffset が負とする。
• ooffset が負とする。
• toffset+len がこのStringオブジェクトの長さよりも大きい。
• ooffset+len が実引数 other の長さよりも大きい。
• 次のような len より小さく，負ではない整数 k がある。 this.charAt(toffset+k) != other.charAt(ooffset+k)

20.12.19 public boolean regionMatches(boolean ignoreCase,
int toffset, String other, int ooffset, int len)
throws NullPointerException

このStringオブジェクト の部分文字列が，実引数 other の部分文字列と比較される。これらの部分文字列が，ignoreCase が true である場合に，またその場合にだけ，大文字小文字を区別せずに同じ文字列を表現している場合，true を返す。比較の対象になるこのStringオブジェクト の部分文字列は，インデクス toffset で始まり，長さが len とする。比較の対象になる other の部分文字列は，インデクス ooffset で始まり，長さがlen とする。次の条件の少なくとも一つが成り立つ場合，又はその場合にだけ，false

• toffset が負とする。
• ooffset が負とする。
• toffset+len がこのStringオブジェクト の長さより大きい。
• ooffset+len が実引数 other の長さよりも大きい。
• 次のような len より小さい負ではない整数 k がある。 this.charAt(toffset+k) != other.charAt(ooffset+k)
• ignoreCase が true であり，次のような len より小さく，負ではない整数 k がある。

Character.toLowerCase(this.charAt(toffset+k)) !=
    Character.toLowerCase(other.charAt(ooffset+k))

及び

Character.toUpperCase(this.charAt(toffset+k)) !=
    Character.toUpperCase(other.charAt(ooffset+k))

20.12.20 public boolean startsWith(String prefix)
throws NullPointerException

実引数によって表現される文字列がこのStringオブジェクトで表現される文字列の先頭部分である場合，またその場合にだけ，true を返す。

prefix が null である場合，NullPointerException が投げられる。

実引数が空文字列である場合，又はメソッド equals(20.12.9)で等しいと判定された場合，true を返す。

20.12.21 public boolean startsWith(String prefix, int toffset)
throws NullPointerException

実引数によって表現される文字列がこのStringオブジェクト で表現される文字列のインデクス toffset で始まる部分文字列の先頭部分である場合，またその場合にだけ，true を返す。

prefixnull である場合，NullPointerException が投げられる。

toffset が負である場合，又はこのオブジェクト String の長さよりも大きい場合，false を返す。それ以外の場合は，次の式の値を返す。

this.subString(toffset).startsWith(prefix)

20.12.22 public boolean endsWith(String suffix)
throws NullPointerException

実引数によって表現される文字列がこのStringオブジェクト で表現される文字列の末尾部分である場合，またその場合にだけ，true を返す。

suffix が null である場合，NullPointerException が投げられる。

実引数が空文字列である場合，又はメソッド equals(20.12.9)で等しいと判定された場合，true を返す。

20.12.23 public int indexOf(int ch)

code>ch を値に持つ文字が，このStringオブジェクト で表現される文字列中にある場合，最初に現われるその文字のインデクスを返す---つまり，次の式が成り立つ最小の k を返す。

this.charAt(k) == ch

20.12.24 public int indexOf(int ch, int fromIndex)

ch を値に持つ文字が，このStringオブジェクト で表現される文字列中のインデクス fromIndex 以降にある場合，最初に現われるその文字のインデクスを返す---つまり，次の式が成り立つ最小のk を返す。

(this.charAt(k) == ch) && (k >= fromIndex)

fromIndex の値に制限はない。fromIndex が負である場合，ゼロと同じ効果をもち，文字列全体が検索される。 fromIndex が文字列の長さより大きい場合，この文字列の長さと等しい値として扱われ， 1を返す。

20.12.25 public int indexOf(String str)
throws NullPointerException

文字列 str がこのStringオブジェクトの部分文字列として現われる場合，該当する最初の部分文字列の先頭の文字のインデクスを返す---つまり，次の値がtrueである最小値kを返す。

this.startsWith(str, k)

str が nullである場合，NullPointerException が投げられる。

20.12.26 public int indexOf(String str, int fromIndex)
throws NullPointerException

文字列 str が，このStringオブジェクト の部分文字列としてインデクス fromIndex 以降に現われる場合，該当する最初の部分文字列の先頭の文字のインデクスを返す---つまり，次の式が成り立つ最小値 k を返す。

this.startsWith(str, k)　&& (k >= fromIndex)

fromIndex の値に制限はない。fromIndex が負である場合，ゼロと同じ効果をもち，文字列全体が検索される。fromIndexが文字列の長さより大きい場合，この文字列の長さと等しい値として扱われ，-1を返す。

strnull である場合，NullPointerException が投げられる。

20.12.27 public int lastIndexOf(int ch)

ch を値に持つ文字が，このStringオブジェクトで表現される文字列中にある場合，最後に現われるその文字のインデクスを返す---つまり，次の式が成り立つ最大の k を返す。

this.charAt(k) == ch

20.12.28 public int lastIndexOf(int ch, int fromIndex)

code>ch を値に持つ文字が，このStringオブジェクトで表現される文字列中のインデクスfromIndex以前にある場合，最後に現われるその文字のインデクスを返す---つまり，次の式が成り立つ最大の k を返す。

(this.charAt(k) == ch) && (k <= fromIndex)

fromIndex の値に制限はない。fromIndex がこの文字列の長さ以上である場合は，この文字列の長さより1少ない値として扱われ，文字列全体が検索される。fromIndex が負である場合，-1 として扱われ，-1 を返す。

20.12.29 public int lastIndexOf(String str)
throws NullPointerException

文字列 str が，このStringオブジェクト の部分文字列として現われる場合，該当する最後の部分文字列の先頭の文字のインデクスを返す---つまり，次の値が true である最大の k を返す。

this.startsWith(str, k)

str が null である場合，NullPointerException が投げられる。

20.12.30 public int lastIndexOf(String str, int fromIndex)
throws NullPointerException

文字列 str が，このStringオブジェクト の部分文字列としてインデクス fromIndex 以前に現われる場合，該当する最後の部分文字列の先頭の文字のインデクスを返す---つまり，次の式が成り立つ最大の k を返す。

this.startsWith(str, k) && (k <= fromIndex)