Character.offsetByCodePoints() Method in java

The Character.offsetByCodePoints(CharSequence seq, int index, int codePointOffset) is an inbuilt method in java that returns the index within the given char sequence that is offset from the given index by codePointOffset code points. Unpaired surrogates within the text range given by index and codePointOffset count as one code point each.

Syntax:

public static int offsetByCodePoints(CharSequence seq, int index, int codePointOffset)

Parameters:



  • seq – the char sequence
  • index – the index to be offset
  • codePointOffset – the offset in code points

Return value: This method of Character class returns the index within the char sequence.

Exceptions:

  • NullPointerException – if seq is null.
  • IndexOutOfBoundsException – if index is negative or larger then the length of the char sequence, or if codePointOffset is positive and the subsequence starting with index has fewer than codePointOffset code points, or if codePointOffset is negative and the subsequence before index has fewer than the absolute value of codePointOffset code points.

Below are the programs to illustrate the above mentioned method:
Program 1:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Code to illustrate the offsetByCodePoints() method
import java.lang.*;
  
public class gfg {
  
    public static void main(String[] args)
    {
  
        // Create a CharSequence s and assign value
        CharSequence s = "Hello World";
  
        // Result of offsetByCodePoints on s
        String str = "The index within the char sequence s is "
        Character.offsetByCodePoints(s, 2, 6);
  
        // Print str value
        System.out.println(str);
    }
}

chevron_right


Output:

The index within the char sequence s is 8

Program 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

// Code to illustrate the offsetByCodePoints() method
  
import java.lang.*;
  
public class gfg {
  
    public static void main(String[] args)
    {
  
        // Create a CharSequence s and assign value
        CharSequence s = "geeks for geeks";
  
        // Result of offsetByCodePoints on s
        String str = "The index within the char sequence s is "
        Character.offsetByCodePoints(s, 3, 8);
  
        // Print str value
        System.out.println(str);
    }
}

chevron_right


Output:

The index within the char sequence s is 11


My Personal Notes arrow_drop_up

Contented with little yet wishing for more

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.