Class UnicodeEscaper
- java.lang.Object
-
- org.apache.commons.text.translate.CharSequenceTranslator
-
- org.apache.commons.text.translate.CodePointTranslator
-
- org.apache.commons.text.translate.UnicodeEscaper
-
- Direct Known Subclasses:
JavaUnicodeEscaper
public class UnicodeEscaper extends CodePointTranslator
Translates code points to their Unicode escaped value.- Since:
- 1.0
-
-
Constructor Summary
Constructors Modifier Constructor Description UnicodeEscaper()
Constructs aUnicodeEscaper
for all characters.protected
UnicodeEscaper(int below, int above, boolean between)
Constructs aUnicodeEscaper
for the specified range.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static UnicodeEscaper
above(int codePoint)
Constructs aUnicodeEscaper
above the specified value (exclusive).static UnicodeEscaper
below(int codePoint)
Constructs aUnicodeEscaper
below the specified value (exclusive).static UnicodeEscaper
between(int codePointLow, int codePointHigh)
Constructs aUnicodeEscaper
between the specified values (inclusive).static UnicodeEscaper
outsideOf(int codePointLow, int codePointHigh)
Constructs aUnicodeEscaper
outside of the specified values (exclusive).protected java.lang.String
toUtf16Escape(int codePoint)
Converts the given code point to a hex string of the form"\\uXXXX"
.boolean
translate(int codePoint, java.io.Writer writer)
Translates the specified code point 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
-
-
-
-
Constructor Detail
-
UnicodeEscaper
public UnicodeEscaper()
Constructs aUnicodeEscaper
for all characters.
-
UnicodeEscaper
protected UnicodeEscaper(int below, int above, boolean between)
Constructs aUnicodeEscaper
for the specified range. This is the underlying method for the other constructors/builders. Thebelow
andabove
boundaries are inclusive whenbetween
istrue
and exclusive when it isfalse
.- Parameters:
below
- int value representing the lowest code point boundaryabove
- int value representing the highest code point boundarybetween
- whether to escape between the boundaries or outside them
-
-
Method Detail
-
above
public static UnicodeEscaper above(int codePoint)
Constructs aUnicodeEscaper
above the specified value (exclusive).- Parameters:
codePoint
- above which to escape- Returns:
- The newly created
UnicodeEscaper
instance
-
below
public static UnicodeEscaper below(int codePoint)
Constructs aUnicodeEscaper
below the specified value (exclusive).- Parameters:
codePoint
- below which to escape- Returns:
- The newly created
UnicodeEscaper
instance
-
between
public static UnicodeEscaper between(int codePointLow, int codePointHigh)
Constructs aUnicodeEscaper
between the specified values (inclusive).- Parameters:
codePointLow
- above which to escapecodePointHigh
- below which to escape- Returns:
- The newly created
UnicodeEscaper
instance
-
outsideOf
public static UnicodeEscaper outsideOf(int codePointLow, int codePointHigh)
Constructs aUnicodeEscaper
outside of the specified values (exclusive).- Parameters:
codePointLow
- below which to escapecodePointHigh
- above which to escape- Returns:
- The newly created
UnicodeEscaper
instance
-
toUtf16Escape
protected java.lang.String toUtf16Escape(int codePoint)
Converts the given code point to a hex string of the form"\\uXXXX"
.- Parameters:
codePoint
- a Unicode code point- Returns:
- The hex string for the given code point
-
translate
public boolean translate(int codePoint, java.io.Writer writer) throws java.io.IOException
Translates the specified code point into another.- Specified by:
translate
in classCodePointTranslator
- Parameters:
codePoint
- int character input to translatewriter
- Writer to optionally push the translated output to- Returns:
- boolean as to whether translation occurred or not
- Throws:
java.io.IOException
- if and only if the Writer produces an IOException
-
-