Java StringBuilder.appendCodePoint()

Java StringBuilder.appendCodePoint() – Examples

In this tutorial, we will learn about the Java StringBuilder.appendCodePoint() function, and learn how to use this function to append a Unicode code point to the StringBuilder, with the help of examples.

appendCodePoint(int codePoint)

StringBuilder.appendCodePoint() appends the string representation of the codePoint argument to the sequence in StringBuilder object.

Syntax

The syntax of appendCodePoint() function is

</>

Copy

appendCodePoint(int codePoint)

where

Parameter	Description
codePoint	a Unicode code point

Returns

The function returns a reference to this StringBuilder object.

Example 1 – appendCodePoint(int codePoint)

In this example, we will create a StringBuilder with some initial string literal, and an integer variable holding a Unicode code point. We will then use appendCodePoint() method to append the Unicode code point to the StringBuilder.

Java Program

</>

Copy

public class Example { 
    public static void main(String[] args) { 
        StringBuilder stringBuilder = new  StringBuilder("abc"); 
        System.out.println("Original value   : " + stringBuilder); 
  
        // append CodePoint
        int codePoint = 65; 
        stringBuilder.appendCodePoint(codePoint); 
        System.out.println("After appending  : " + stringBuilder); 
    } 
}

Output

Original value   : abc
After appending  : abcA

Example 2 – appendCodePoint(int codePoint)

In this example, we will use appendCodePoint() method to append all the Unicode code points, present in an array, to the StringBuilder.

Java Program

</>

Copy

public class Example { 
    public static void main(String[] args) { 
        StringBuilder stringBuilder = new  StringBuilder("abc"); 
        System.out.println("Original value   : " + stringBuilder); 
  
        // CodePoint array
        int[] codePoints = {65, 66, 67, 68};
        
        for(int codePoint: codePoints) {
        	stringBuilder.appendCodePoint(codePoint);
        }
        System.out.println("After appending  : " + stringBuilder); 
    } 
}

Output

Original value   : abc
After appending  : abcABCD

Example 3 – appendCodePoint(int codePoint)

In this example, we will try appending an invalid Unicode code point value to the StringBuilder. appendCodePoint() method thrwos IllegalArgumentException.

Java Program

</>

Copy

public class Example { 
    public static void main(String[] args) { 
        StringBuilder stringBuilder = new  StringBuilder("abc"); 
        System.out.println("Original value   : " + stringBuilder); 
  
        // append CodePoint
        int codePoint = 65996665; 
        stringBuilder.appendCodePoint(codePoint); 
        System.out.println("After appending  : " + stringBuilder); 
    } 
}

Output

Original value   : abc
Exception in thread "main" java.lang.IllegalArgumentException
	at java.base/java.lang.Character.toChars(Unknown Source)
	at java.base/java.lang.AbstractStringBuilder.appendCodePoint(Unknown Source)
	at java.base/java.lang.StringBuilder.appendCodePoint(Unknown Source)
	at Example.main(Example.java:8)

Conclusion

In this Java Tutorial, we have learnt the syntax of Java StringBuilder.appendCodePoint() function, and also learnt how to use this function with the help of examples.

TutorialKart

Java StringBuilder.appendCodePoint() – Syntax & Examples