Java Character.offsetByCodePoints()用法及代碼示例

Character.offsetByCodePoints(char [] a，int start，int count，int index，int codePointOffset)是Java中的一種內置方法，它返回給定char子數組內的索引，該子數組與codeIndexOffset代碼點相對於給定索引的偏移量。 start和count參數指定char數組的子數組。在index和codePointOffset所給定的文本範圍內的未配對替代項均計為一個代碼點。
字符類的offsetByCodePoints(char [] a，int起始，int計數，int索引，int codePointOffset)方法是靜態的，因此應進行靜態訪問。
通常通過聲明method_name(argument)來調用非靜態方法。但是在這種情況下，由於它是一個靜態方法，因此在調用期間將類名作為後綴附加。如果嘗試以非靜態方式調用java 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 + count，或者codePointOffset為正且文本範圍以index開頭且以start + count結尾– 1的數量少於codePointOffset代碼點，或者如果codePointOffset為負，並且以index – 1開頭和結尾的文本範圍小於codePointOffset代碼點的絕對值。

以下示例程序旨在說明Character.offsetByCodePoints()方法：

//Java program for offsetByCodePoints() method 
import java.lang.*; 
public class gfg { 
   public static void main(String[] args) { 
      // Creating a char array c_arr and assigning values 
      char[] c_arr = new char[] {'g','e','e','k','s'}; 
  
      // Integer primitives  
      int s = 1; 
      int c= 4; 
  
      // Creating and assigning result of offsetByCodePoints 
      // On subarray of c_arr to r 
     int r = Character.offsetByCodePoints(c_arr, s, c, 1, 2); 
  
      String st = "The index within the subarray is " + r; 
  
      System.out.println(st); 
   } 
}

The index within the subarray is 3

參考：https://docs.oracle.com/javase/7/docs/api/java/lang/Character.html#offsetByCodePoints(char[],%20int,%20int,%20int,%20int)