Class UnicodeEscaper

Direct Known Subclasses:
JavaUnicodeEscaper

public class UnicodeEscaper extends CodePointTranslator
Translates codepoints to their Unicode escaped value.
Since:
1.0
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private final int
    int value representing the highest codepoint boundary.
    private final int
    int value representing the lowest codepoint boundary.
    private final boolean
    whether to escape between the boundaries or outside them.

    Fields inherited from class org.apache.commons.text.translate.CharSequenceTranslator

    HEX_DIGITS
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
     
    Constructs a UnicodeEscaper for all characters.
    protected
    UnicodeEscaper(int below, int above, boolean between)
    Constructs a UnicodeEscaper for the specified range.
  • Method Summary

    Modifier and Type
    Method
    Description
    above(int codepoint)
    Constructs a UnicodeEscaper above the specified value (exclusive).
    below(int codepoint)
    Constructs a UnicodeEscaper below the specified value (exclusive).
    between(int codepointLow, int codepointHigh)
    Constructs a UnicodeEscaper between the specified values (inclusive).
    outsideOf(int codepointLow, int codepointHigh)
    Constructs a UnicodeEscaper outside of the specified values (exclusive).
    protected String
    toUtf16Escape(int codepoint)
    Converts the given codepoint to a hex string of the form "\\uXXXX".
    boolean
    translate(int codepoint, Writer out)
    Translate the specified codepoint into another.

    Methods inherited from class org.apache.commons.text.translate.CodePointTranslator

    translate

    Methods inherited from class org.apache.commons.text.translate.CharSequenceTranslator

    hex, translate, translate, with

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • below

      private final int below
      int value representing the lowest codepoint boundary.
    • above

      private final int above
      int value representing the highest codepoint boundary.
    • between

      private final boolean between
      whether to escape between the boundaries or outside them.
  • Constructor Details

    • UnicodeEscaper

      public UnicodeEscaper()

      Constructs a UnicodeEscaper for all characters.

    • UnicodeEscaper

      protected UnicodeEscaper(int below, int above, boolean between)

      Constructs a UnicodeEscaper for the specified range. This is the underlying method for the other constructors/builders. The below and above boundaries are inclusive when between is true and exclusive when it is false.

      Parameters:
      below - int value representing the lowest codepoint boundary
      above - int value representing the highest codepoint boundary
      between - whether to escape between the boundaries or outside them
  • Method Details

    • below

      public static UnicodeEscaper below(int codepoint)

      Constructs a UnicodeEscaper below the specified value (exclusive).

      Parameters:
      codepoint - below which to escape
      Returns:
      The newly created UnicodeEscaper instance
    • above

      public static UnicodeEscaper above(int codepoint)

      Constructs a UnicodeEscaper above the specified value (exclusive).

      Parameters:
      codepoint - above which to escape
      Returns:
      The newly created UnicodeEscaper instance
    • outsideOf

      public static UnicodeEscaper outsideOf(int codepointLow, int codepointHigh)

      Constructs a UnicodeEscaper outside of the specified values (exclusive).

      Parameters:
      codepointLow - below which to escape
      codepointHigh - above which to escape
      Returns:
      The newly created UnicodeEscaper instance
    • between

      public static UnicodeEscaper between(int codepointLow, int codepointHigh)

      Constructs a UnicodeEscaper between the specified values (inclusive).

      Parameters:
      codepointLow - above which to escape
      codepointHigh - below which to escape
      Returns:
      The newly created UnicodeEscaper instance
    • translate

      public boolean translate(int codepoint, Writer out) throws IOException
      Translate the specified codepoint into another.
      Specified by:
      translate in class CodePointTranslator
      Parameters:
      codepoint - int character input to translate
      out - Writer to optionally push the translated output to
      Returns:
      boolean as to whether translation occurred or not
      Throws:
      IOException - if and only if the Writer produces an IOException
    • toUtf16Escape

      protected String toUtf16Escape(int codepoint)
      Converts the given codepoint to a hex string of the form "\\uXXXX".
      Parameters:
      codepoint - a Unicode code point
      Returns:
      The hex string for the given codepoint