Package com.ibm.icu.text
Class UnescapeTransliterator
- java.lang.Object
-
- com.ibm.icu.text.Transliterator
-
- com.ibm.icu.text.UnescapeTransliterator
-
- All Implemented Interfaces:
StringTransform
,Transform<java.lang.String,java.lang.String>
class UnescapeTransliterator extends Transliterator
A transliterator that converts Unicode escape forms to the characters they represent. Escape forms have a prefix, a suffix, a radix, and minimum and maximum digit counts.This class is package private. It registers several standard variants with the system which are then accessed via their IDs.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.ibm.icu.text.Transliterator
Transliterator.Factory, Transliterator.Position
-
-
Field Summary
Fields Modifier and Type Field Description private static char
END
Special character marking the end of the spec[] array.private char[]
spec
The encoded pattern specification.-
Fields inherited from class com.ibm.icu.text.Transliterator
DEBUG, FORWARD, ID_DELIM, ID_SEP, REVERSE, VARIANT_SEP
-
-
Constructor Summary
Constructors Constructor Description UnescapeTransliterator(java.lang.String ID, char[] spec)
Package private constructor.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addSourceTargetSet(UnicodeSet inputFilter, UnicodeSet sourceSet, UnicodeSet targetSet)
Returns the set of all characters that may be generated as replacement text by this transliterator, filtered by BOTH the input filter, and the current getFilter().protected void
handleTransliterate(Replaceable text, Transliterator.Position pos, boolean isIncremental)
(package private) static void
register()
Registers standard variants with the system.-
Methods inherited from class com.ibm.icu.text.Transliterator
baseToRules, createFromRules, filteredTransliterate, finishTransliteration, getAvailableIDs, getAvailableSources, getAvailableTargets, getAvailableVariants, getBasicInstance, getDisplayName, getDisplayName, getDisplayName, getElements, getFilter, getFilterAsUnicodeSet, getID, getInstance, getInstance, getInverse, getMaximumContextLength, getSourceSet, getTargetSet, handleGetSourceSet, registerAlias, registerAny, registerClass, registerFactory, registerInstance, registerInstance, registerSpecialInverse, setFilter, setID, setMaximumContextLength, toRules, transform, transliterate, transliterate, transliterate, transliterate, transliterate, transliterate, unregister
-
-
-
-
Field Detail
-
spec
private char[] spec
The encoded pattern specification. The pattern consists of zero or more forms. Each form consists of a prefix, suffix, radix, minimum digit count, and maximum digit count. These values are stored as a five character header. That is, their numeric values are cast to 16-bit characters and stored in the string. Following these five characters, the prefix characters, then suffix characters are stored. Each form thus takes n+5 characters, where n is the total length of the prefix and suffix. The end is marked by a header of length one consisting of the character END.
-
END
private static final char END
Special character marking the end of the spec[] array.- See Also:
- Constant Field Values
-
-
Method Detail
-
register
static void register()
Registers standard variants with the system. Called by Transliterator during initialization.
-
handleTransliterate
protected void handleTransliterate(Replaceable text, Transliterator.Position pos, boolean isIncremental)
- Specified by:
handleTransliterate
in classTransliterator
- Parameters:
text
- the buffer holding transliterated and untransliterated textpos
- the indices indicating the start, limit, context start, and context limit of the text.isIncremental
- if true, assume more text may be inserted atpos.limit
and act accordingly. Otherwise, transliterate all text betweenpos.start
andpos.limit
and movepos.start
up topos.limit
.- See Also:
Transliterator.transliterate(com.ibm.icu.text.Replaceable, int, int)
-
addSourceTargetSet
public void addSourceTargetSet(UnicodeSet inputFilter, UnicodeSet sourceSet, UnicodeSet targetSet)
Description copied from class:Transliterator
Returns the set of all characters that may be generated as replacement text by this transliterator, filtered by BOTH the input filter, and the current getFilter().SHOULD BE OVERRIDDEN BY SUBCLASSES. It is probably an error for any transliterator to NOT override this, but we can't force them to for backwards compatibility.
Other methods vector through this.
When gathering the information on source and target, the compound transliterator makes things complicated. For example, suppose we have:
Global FILTER = [ax] a > b; :: NULL; b > c; x > d;
While the filter just allows a and x, b is an intermediate result, which could produce c. So the source and target sets cannot be gathered independently. What we have to do is filter the sources for the first transliterator according to the global filter, intersect that transliterator's filter. Based on that we get the target. The next transliterator gets as a global filter (global + last target). And so on.There is another complication:
Global FILTER = [ax] a >|b; b >c;
Even though b would be filtered from the input, whenever we have a backup, it could be part of the input. So ideally we will change the global filter as we go.- Overrides:
addSourceTargetSet
in classTransliterator
targetSet
- TODO- See Also:
Transliterator.getTargetSet()
-
-