Class ConvertToAscii

java.lang.Object
io.github.connellite.util.ConvertToAscii

public class ConvertToAscii extends Object
Escapes non-ASCII text to \\uXXXX sequences and decodes those sequences back to Unicode, similar in spirit to the JDK native2ascii tool.
  • Constructor Details

    • ConvertToAscii

      public ConvertToAscii()
  • Method Details

    • native2ascii

      public static String native2ascii(String text)
      Escapes characters above U+007F as \\uXXXX. ASCII letters, digits, and punctuation stay as-is.
      Parameters:
      text - source text; null and empty are returned unchanged
      Returns:
      escaped text, or null if text was null
    • native2ascii

      public static String native2ascii(String text, boolean ignoreLatinCharacters)
      Escapes characters to \\uXXXX form.

      If ignoreLatinCharacters is false, only code points > 0x7F are escaped. If true, every character (including ASCII) is written as a \\uXXXX escape.

      Parameters:
      text - source text; null and empty are returned unchanged
      ignoreLatinCharacters - when true, escape all characters; when false, only non-ASCII
      Returns:
      escaped text, or null if text was null
    • ascii2native

      public static String ascii2native(String text)
      Replaces each \\uXXXX substring (four hex digits, case-insensitive) with the corresponding UTF-16 code unit. Unmatched parts of the input are copied unchanged.
      Parameters:
      text - text possibly containing \\uXXXX escapes; null and empty are returned unchanged
      Returns:
      decoded text, or null if text was null