com.ibm.icu.text

Class RuleBasedTransliterator

java.lang.Object

com.ibm.icu.text.Transliterator

com.ibm.icu.text.RuleBasedTransliterator

All Implemented Interfaces:

StringTransform, Transform<String,String>

Deprecated.

This API is ICU internal only.

@Deprecated
public class RuleBasedTransliterator
extends Transliterator

RuleBasedTransliterator is a transliterator built from a set of rules as defined for Transliterator.createFromRules(String, String, int). See the class Transliterator documentation for the rule syntax.

Author:

Alan Liu

Status:

Internal. This API is ICU internal only.

Nested Class Summary

Nested classes/interfaces inherited from class com.ibm.icu.text.Transliterator

Transliterator.Factory, Transliterator.Position

Field Summary

Fields inherited from class com.ibm.icu.text.Transliterator

FORWARD, REVERSE

Method Summary

Modifier and Type	Method and Description
void	addSourceTargetSet(UnicodeSet filter, UnicodeSet sourceSet, UnicodeSet targetSet) Deprecated. This API is ICU internal only.
protected void	handleTransliterate(Replaceable text, Transliterator.Position index, boolean incremental) Deprecated. This API is ICU internal only.
Transliterator	safeClone() Deprecated. This API is ICU internal only.
String	toRules(boolean escapeUnprintable) Deprecated. This API is ICU internal only.

Methods inherited from class com.ibm.icu.text.Transliterator

baseToRules, createFromRules, filteredTransliterate, finishTransliteration, getAvailableIDs, getAvailableSources, getAvailableTargets, getAvailableVariants, getDisplayName, getDisplayName, getDisplayName, getElements, getFilter, getFilterAsUnicodeSet, getID, getInstance, getInstance, getInverse, getMaximumContextLength, getSourceSet, getTargetSet, handleGetSourceSet, registerAlias, registerAny, registerClass, registerFactory, registerInstance, setFilter, setID, setMaximumContextLength, transform, transliterate, transliterate, transliterate, transliterate, transliterate, transliterate, unregister

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

handleTransliterate

@Deprecated
protected void handleTransliterate(Replaceable text,
                                               Transliterator.Position index,
                                               boolean incremental)

Deprecated. This API is ICU internal only.

Implements Transliterator.handleTransliterate(com.ibm.icu.text.Replaceable, com.ibm.icu.text.Transliterator.Position, boolean).

Specified by:

handleTransliterate in class Transliterator

Parameters:

text - the buffer holding transliterated and untransliterated text

index - the indices indicating the start, limit, context start, and context limit of the text.

incremental - if true, assume more text may be inserted at pos.limit and act accordingly. Otherwise, transliterate all text between pos.start and pos.limit and move pos.start up to pos.limit.

See Also:

Transliterator.transliterate(com.ibm.icu.text.Replaceable, int, int)

Status:

Internal. This API is ICU internal only.

toRules

@Deprecated
public String toRules(boolean escapeUnprintable)

Deprecated. This API is ICU internal only.

Return a representation of this transliterator as source rules. These rules will produce an equivalent transliterator if used to construct a new transliterator.

Overrides:

toRules in class Transliterator

Parameters:

escapeUnprintable - if true then convert unprintable character to their hex escape representations, \\uxxxx or \\Uxxxxxxxx. Unprintable characters are those other than U+000A, U+0020..U+007E.

Returns:

rules string

Status:

Internal. This API is ICU internal only.

addSourceTargetSet

@Deprecated
public void addSourceTargetSet(UnicodeSet filter,
                                           UnicodeSet sourceSet,
                                           UnicodeSet targetSet)

Deprecated. This API is ICU internal only.

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 class Transliterator

targetSet - TODO

See Also:

Transliterator.getTargetSet()

Status:

Internal. This API is ICU internal only.

safeClone

@Deprecated
public Transliterator safeClone()

Deprecated. This API is ICU internal only.

Temporary hack for registry problem. Needs to be replaced by better architecture.

Status:

Internal. This API is ICU internal only.