Java.lang.Character.codePointAt() Method

Description

The java.lang.Character.codePointAt(char[ ] a, int index) returns the code point at the given index of the char array.

If the char value at the given index in the char array is in the high-surrogate range, the following index is less than the length of the char array, and the char value at the following index is in the low-surrogate range, then the supplementary code point corresponding to this surrogate pair is returned. Otherwise, the char value at the given index is returned.

Declaration

Following is the declaration for java.lang.Character.codePointAt() method

public static int codePointAt(char[] a, int index)

Parameters

• a - the char array

• index - the index to the char values (Unicode code units) in the char array to be converted

Return Value

This method returns the Unicode code point at the given index.

Exception

• NullPointerException - if a is null.

• IndexOutOfBoundsException - if the value index is negative or not less than the length of the char array.

Example

The following example shows the usage of lang.Character.codePointAt() method.

package com.tutorialspoint;

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' };

      // craete 2 int's res, index and assign value to index
      int res, index  = 0;

      // assign result of codePointAt on array c at index to res
      res = Character.codePointAt(c, index);

      String str = "Unicode code point is " + res;

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

Let us compile and run the above program, this will produce the following result:

Unicode code point is 97