org.apache.commons.text.translate

Class SingleLookupTranslator

java.lang.Object

org.apache.commons.text.translate.CharSequenceTranslator

org.apache.commons.text.translate.SingleLookupTranslator

public class SingleLookupTranslator
extends CharSequenceTranslator

Translates a value using a lookup table. But doesn't translate if that value is already translated.

Since:

1.0

Constructor Summary

Constructors

Constructor and Description
SingleLookupTranslator(String[][]... inputArrays) Define the look tables to be used in translation.

Method Summary

Modifier and Type	Method and Description
int	translate(CharSequence input, int index, Writer out) Translate a set of codepoints, represented by an int index into a CharSequence, into another set of codepoints.

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

Constructor Detail

SingleLookupTranslator

public SingleLookupTranslator(String[][]... inputArrays)

Define the look tables to be used in translation. Note that, as of Lang 3.1, the key to the lookup table is converted to a java.lang.String. This is because we need the key to support hashCode and equals(Object), allowing it to be the key for a HashMap. See LANG-882. Also note that, multiple lookup tables should be passed to this translator instead of passing multiple instances of this translator to the AggregateTranslator. Because, this translator only checks the values of the lookup table passed to this instance while deciding whether a value is already translated or not.

Parameters:

inputArrays, - an array of string arrays.

Method Detail

translate

public int translate(CharSequence input,
                     int index,
                     Writer out)
              throws IOException

Translate a set of codepoints, represented by an int index into a CharSequence, into another set of codepoints. The number of codepoints consumed must be returned, and the only IOExceptions thrown must be from interacting with the Writer so that the top level API may reliably ignore StringWriter IOExceptions.

Specified by:

translate in class CharSequenceTranslator

Parameters:

input - CharSequence that is being translated

index - int representing the current point of translation

out - Writer to translate the text to

Returns:

int count of codepoints consumed

Throws:

IOException - if and only if the Writer produces an IOException