Java-lang-character-offsetbycodepoints

提供:Dev Guides
移動先:案内検索

Java.lang.Character.offsetByCodePoints()メソッド

説明

  • java.lang.Character.offsetByCodePoints(char [] a、int start、int count、int index、int codePointOffset)*は、指定されたインデックスからcodePointOffsetコードポイントだけオフセットされた、指定されたcharサブ配列内のインデックスを返します。

start引数とcount引数は、char配列のサブ配列を指定します。 indexとcodePointOffsetで指定されたテキスト範囲内のペアになっていないサロゲートは、それぞれ1つのコードポイントとしてカウントされます。

宣言

以下は* java.lang.Character.offsetByCodePoints()*メソッドの宣言です

public static int offsetByCodePoints(char[] a, int start, int count, int index, int codePointOffset)

パラメーター

  • a -文字配列
  • start -部分配列の最初の文字のインデックス
  • count -文字の部分配列の長さ
  • index -オフセットされるインデックス
  • codePointOffset -コードポイントのオフセット

戻り値

このメソッドは、サブ配列内のインデックスを返します

例外

  • NullPointerException -aがnullの場合
  • IndexOutOfBoundsException -startまたはcountが負の場合、start + countが指定された配列の長さより大きい場合、indexがstartより小さいかstartより大きい場合、またはcodePointOffsetが正でテキスト範囲が開始する場合インデックス付きで始まり、start + countで終わる-1はcodePointOffsetコードポイントより少ないか、またはcodePointOffsetが負で、startで始まりインデックスで終わるテキスト範囲が1-codePointOffsetコードポイントの絶対値より小さい場合。

次の例は、lang.Character.offsetByCodePoints()メソッドの使用方法を示しています。

package com.finddevguides;

import java.lang.*;

public class CharacterDemo {

   public static void main(String[] args) {

     //create a char array c and assign values
      char[] c = new char[] { 'a', 'b', 'c', 'd', 'e', 'f' };

     //craete 2 int primitives start, count and assign values
      int start = 1;
      int count = 5;

     //create an int primitive res
      int res;

     //assign result of offsetByCodePoints on subarray of c to res
      res = Character.offsetByCodePoints(c, start, count, 2, 4);

      String str = "The index within the subarray of c is " + res;

     //print res value
      System.out.println( str );
   }
}

上記のプログラムをコンパイルして実行すると、次の結果が生成されます-

The index within the subarray of c is 6