Class TitlecaseTransliterator

java.lang.Object

com.ibm.icu.text.Transliterator

com.ibm.icu.text.TitlecaseTransliterator

All Implemented Interfaces:

StringTransform, Transform<String,String>

class TitlecaseTransliterator
extends Transliterator

A transliterator that converts all letters (as defined by UCharacter.isLetter()) to lower case, except for those letters preceded by non-letters. The latter are converted to title case using UCharacter.toTitleCase().

Nested Class Summary

Nested classes/interfaces inherited from class Transliterator

Transliterator.Factory, Transliterator.Position

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final String	_ID
private int	caseLocale
private final UCaseProps	csp
private final ULocale	locale
(package private) SourceTargetUtility	sourceTargetUtility

Fields inherited from class Transliterator

DEBUG, FORWARD, ID_DELIM, ID_SEP, REVERSE, VARIANT_SEP

Constructor Summary

Constructors

Constructor	Description
TitlecaseTransliterator(ULocale loc)	Constructs a transliterator.

Method Summary

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 offsets, boolean isIncremental)	Implements Transliterator.handleTransliterate(Replaceable, Transliterator.Position, boolean).
(package private) static void	register()	System registration hook.

Methods inherited from class 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

Methods inherited from class Object

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

Field Details

_ID

static final String _ID

See Also:

• Constant Field Values

locale

private final ULocale locale

csp

private final UCaseProps csp

caseLocale

private int caseLocale

sourceTargetUtility

SourceTargetUtility sourceTargetUtility

Constructor Details

TitlecaseTransliterator

public TitlecaseTransliterator(ULocale loc)

Constructs a transliterator.

Method Details

register

static void register()

System registration hook.

handleTransliterate

protected void handleTransliterate(Replaceable text,
 Transliterator.Position offsets,
 boolean isIncremental)

Implements Transliterator.handleTransliterate(Replaceable, Transliterator.Position, boolean).

Specified by:

handleTransliterate in class Transliterator

Parameters:

text - the buffer holding transliterated and untransliterated text

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

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

Parameters:

targetSet - TODO

See Also:

• Transliterator.getTargetSet()