Java-lang-character-tochars-index
提供:Dev Guides
Java.lang.Character.toChars()メソッド
説明
- java.lang.Character.toChars(int codePoint、char [] dst、int dstIndex)*は、指定された文字(Unicodeコードポイント)をUTF-16表現に変換します。
指定したコードポイントがBMP(Basic Multilingual PlaneまたはPlane 0)値の場合、同じ値がdst [dstIndex]に格納され、1が返されます。
指定されたコードポイントが補助文字の場合、そのサロゲート値はdst [dstIndex](高サロゲート)およびdst [dstIndex + 1](低サロゲート)に格納され、2が返されます。
宣言
以下は* java.lang.Character.toChars()*メソッドの宣言です
パラメーター
- codePoint -Unicodeコードポイント
- dst -codePointのUTF-16値が格納されているcharの配列
- dstIndex -変換された値が保存されるdst配列の開始インデックス
戻り値
このメソッドは、コードポイントがBMPコードポイントの場合は1、コードポイントが補助コードポイントの場合は2を返します。
例外
- IllegalArgumentException -指定されたcodePointが有効なUnicodeコードポイントではない場合
- NullPointerException -指定されたdstがnullの場合
- IllegalArgumentException -dstIndexが負であるかdst.length以上の場合、またはdstIndexのdstに結果のchar値を格納するのに十分な配列要素がない場合 (dstIndexがdst.length-1に等しく、指定されたcodePointが補助文字である場合、上位サロゲート値はdst [dstIndex]に格納されません。)
例
次の例は、lang.Character.toChars()メソッドの使用法を示しています。
上記のプログラムをコンパイルして実行すると、次の結果が生成されます-