How to Insert an Emoji in a Java String | Baeldung

1. Introduction

In modern applications, incorporating emojis into text enhances the user experience significantly. Moreover, working with emojis requires understanding Unicode and how Java handles text encoding.

In this tutorial, we’ll insert an emoji into a Java string, covering various approaches, considerations, and ranges of emojis in Unicode.

2. Understanding Unicode and Emojis

Emojis are represented using Unicode, a standardized system for encoding characters. Each emoji has a unique Unicode code point. For example, the smiley face emoji 😀 is represented by the code point U+1F600.

Strings are sequences of UTF-16 code units, and surrogate pairs represent some emojis because their code points are beyond the Basic Multilingual Plane (BMP).

Emojis fall within specific ranges of Unicode code points:

• Basic Latin and Latin-1 Supplement: U+0000 to U+00FF
• Miscellaneous Symbols: U+2600 to U+26FF
• Dingbats: U+2700 to U+27BF
• Emoticons: U+1F600 to U+1F64F
• Transport and Map Symbols: U+1F680 to U+1F6FF
• Supplemental Symbols and Pictographs: U+1F900 to U+1F9FF
• Symbols and Pictographs Extended-A: U+1FA70 to U+1FAFF

These ranges include various types of emojis, such as faces, gestures, objects, animals, and more.

3. Inserting Emojis Using Unicode Escapes

One of the simplest ways to insert an emoji into a Java string is by using Unicode escape sequences. Let’s take an example:

String expected = "Java Tutorials and Guides at Baeldung. 😀";
@Test
public void givenUnicodeEscape_whenInsertEmoji_thenCorrectString() {
    String textWithEmoji = "Java Tutorials and Guides at Baeldung. \uD83D\uDE00";

    assertEquals(expected, textWithEmoji);
}

In this method, \uD83D\uDE00 represents the Unicode escape sequence for the smiley face emoji 😀. The \uD83D and \uDE00 are the high and low surrogates, respectively. Moreover, the assertion ensures that the string with the emoji is exactly as expected. This approach is straightforward but requires knowing the Unicode code point of the emoji.

4. Using the toChars() Method

Java provides a method called toChars() from the Character class*,* which we can utilize to convert a Unicode code point into a char array. Let’s implement this approach:

int smileyCodePoint = 0x1F600;
@Test
public void givenCodePoint_whenConvertToEmoji_thenCorrectString() {
    String textWithEmoji = "Java Tutorials and Guides at Baeldung. " + new String(Character.toChars(smileyCodePoint));

    assertEquals(expected, textWithEmoji);
}

Here, Character.toChars(smileyCodePoint) converts the code point 0x1F600 into a char array, which is then used to create a new string containing the emoji. This approach is useful for inserting emojis programmatically.

5. Using StringBuilder

StringBuilder can be beneficial when building strings dynamically. Additionally, the StringBuilder helps in scenarios where we need to construct strings through multiple append operations, making the process efficient and easier to manage.

Here’s how we can implement this approach:

@Test
public void givenStringBuilder_whenAppendEmoji_thenCorrectString() {
    StringBuilder sb = new StringBuilder("Java Tutorials and Guides at Baeldung. ");
    sb.append(Character.toChars(smileyCodePoint));
    String textWithEmoji = sb.toString();

    assertEquals(expected, textWithEmoji);
}

Here, we first create a StringBuilder object initialized with the string “*Java Tutorials and Guides at Baeldung.*“. Then, we append the emoji to this StringBuilder using the Character.toChars() method, which converts the Unicode code point into a char array. Finally, we utilize the toString() method to convert the StringBuilder to a string.

6. Conclusion

Inserting emojis into Java strings can be accomplished using Unicode escapes, the Character.toChars() method, and StringBuilder. With these techniques, we can enhance our Java applications by incorporating emojis seamlessly.

As always, the complete code samples for this article can be found over on GitHub.