946 lines
34 KiB
C++
946 lines
34 KiB
C++
/*
|
|
**********************************************************************
|
|
* Copyright (C) 1999-2001, International Business Machines
|
|
* Corporation and others. All Rights Reserved.
|
|
**********************************************************************
|
|
* Date Name Description
|
|
* 11/17/99 aliu Creation.
|
|
**********************************************************************
|
|
*/
|
|
#include "unicode/translit.h"
|
|
#include "cmemory.h"
|
|
#include "cstring.h"
|
|
#include "unicode/hextouni.h"
|
|
#include "unicode/locid.h"
|
|
#include "unicode/msgfmt.h"
|
|
#include "mutex.h"
|
|
#include "rbt_data.h"
|
|
#include "rbt_pars.h"
|
|
#include "unicode/rep.h"
|
|
#include "unicode/resbund.h"
|
|
#include "hash.h"
|
|
#include "unicode/unifilt.h"
|
|
#include "unicode/unitohex.h"
|
|
#include "unicode/nultrans.h"
|
|
#include "unicode/putil.h"
|
|
#include "unicode/cpdtrans.h"
|
|
#include "unicode/jamohang.h"
|
|
#include "unicode/hangjamo.h"
|
|
#include <stdio.h>
|
|
const UChar Transliterator::ID_SEP = 0x002D; /*-*/
|
|
const UChar Transliterator::ID_DELIM = 0x003B; /*;*/
|
|
|
|
static Hashtable _cache;
|
|
static Hashtable _internalCache;
|
|
|
|
/**
|
|
* Cache of public system transliterators. Keys are UnicodeString
|
|
* names, values are CacheEntry objects.
|
|
*/
|
|
Hashtable* Transliterator::cache = &_cache;
|
|
|
|
/**
|
|
* Like 'cache', but IDs are not public. Internal transliterators are
|
|
* combined together and aliased to public IDs.
|
|
*/
|
|
Hashtable* Transliterator::internalCache = &_internalCache;
|
|
|
|
/**
|
|
* The mutex controlling access to the cache.
|
|
*/
|
|
UMTX Transliterator::cacheMutex = NULL;
|
|
|
|
/**
|
|
* When set to TRUE, the cache has been initialized. Any code must
|
|
* check this boolean before accessing the cache, and if the boolean
|
|
* is FALSE, it must call initializeCache(). We do this form of lazy
|
|
* evaluation for two reasons: (1) so we don't initialize if we don't
|
|
* have to (i.e., if no one is using Transliterator, but has included
|
|
* the code as part of a shared library, and (2) to avoid static
|
|
* intialization problems.
|
|
*/
|
|
UBool Transliterator::cacheInitialized = FALSE;
|
|
|
|
/**
|
|
* Prefix for resource bundle key for the display name for a
|
|
* transliterator. The ID is appended to this to form the key.
|
|
* The resource bundle value should be a String.
|
|
*/
|
|
const char* Transliterator::RB_DISPLAY_NAME_PREFIX = "%Translit%%";
|
|
|
|
/**
|
|
* Prefix for resource bundle key for the display name for a
|
|
* transliterator SCRIPT. The ID is appended to this to form the key.
|
|
* The resource bundle value should be a String.
|
|
*/
|
|
const char* Transliterator::RB_SCRIPT_DISPLAY_NAME_PREFIX = "%Translit%";
|
|
|
|
/**
|
|
* Resource bundle key for display name pattern.
|
|
* The resource bundle value should be a String forming a
|
|
* MessageFormat pattern, e.g.:
|
|
* "{0,choice,0#|1#{1} Transliterator|2#{1} to {2} Transliterator}".
|
|
*/
|
|
const char* Transliterator::RB_DISPLAY_NAME_PATTERN =
|
|
"TransliteratorNamePattern";
|
|
|
|
/**
|
|
* Resource bundle key for the list of RuleBasedTransliterator IDs.
|
|
* The resource bundle value should be a String[] with each element
|
|
* being a valid ID. The ID will be appended to RB_RULE_BASED_PREFIX
|
|
* to obtain the class name in which the RB_RULE key will be sought.
|
|
*/
|
|
const char* Transliterator::RB_RULE_BASED_IDS =
|
|
"RuleBasedTransliteratorIDs";
|
|
|
|
/**
|
|
* Resource bundle key for the RuleBasedTransliterator rule.
|
|
*/
|
|
const char* Transliterator::RB_RULE = "Rule";
|
|
|
|
/**
|
|
* Default constructor.
|
|
* @param theID the string identifier for this transliterator
|
|
* @param theFilter the filter. Any character for which
|
|
* <tt>filter.contains()</tt> returns <tt>FALSE</tt> will not be
|
|
* altered by this transliterator. If <tt>filter</tt> is
|
|
* <tt>null</tt> then no filtering is applied.
|
|
*/
|
|
Transliterator::Transliterator(const UnicodeString& theID,
|
|
UnicodeFilter* adoptedFilter) :
|
|
ID(theID), filter(adoptedFilter),
|
|
maximumContextLength(0) {}
|
|
|
|
/**
|
|
* Destructor.
|
|
*/
|
|
Transliterator::~Transliterator() {
|
|
delete filter;
|
|
}
|
|
|
|
/**
|
|
* Copy constructor.
|
|
*/
|
|
Transliterator::Transliterator(const Transliterator& other) :
|
|
ID(other.ID), filter(0),
|
|
maximumContextLength(other.maximumContextLength) {
|
|
if (other.filter != 0) {
|
|
// We own the filter, so we must have our own copy
|
|
filter = other.filter->clone();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Assignment operator.
|
|
*/
|
|
Transliterator& Transliterator::operator=(const Transliterator& other) {
|
|
ID = other.ID;
|
|
maximumContextLength = other.maximumContextLength;
|
|
// MUST go through adoptFilter in case latter is overridden
|
|
adoptFilter((other.filter == 0) ? 0 : other.filter->clone());
|
|
return *this;
|
|
}
|
|
|
|
/**
|
|
* Transliterates a segment of a string. <code>Transliterator</code> API.
|
|
* @param text the string to be transliterated
|
|
* @param start the beginning index, inclusive; <code>0 <= start
|
|
* <= limit</code>.
|
|
* @param limit the ending index, exclusive; <code>start <= limit
|
|
* <= text.length()</code>.
|
|
* @return the new limit index
|
|
*/
|
|
int32_t Transliterator::transliterate(Replaceable& text,
|
|
int32_t start, int32_t limit) const {
|
|
|
|
UTransPosition offsets;
|
|
offsets.contextStart= start;
|
|
offsets.contextLimit = limit;
|
|
offsets.start = start;
|
|
offsets.limit = limit;
|
|
handleTransliterate(text, offsets, FALSE);
|
|
return offsets.limit;
|
|
}
|
|
|
|
/**
|
|
* Transliterates an entire string in place. Convenience method.
|
|
* @param text the string to be transliterated
|
|
*/
|
|
void Transliterator::transliterate(Replaceable& text) const {
|
|
transliterate(text, 0, text.length());
|
|
}
|
|
|
|
/**
|
|
* Transliterates the portion of the text buffer that can be
|
|
* transliterated unambiguosly after new text has been inserted,
|
|
* typically as a result of a keyboard event. The new text in
|
|
* <code>insertion</code> will be inserted into <code>text</code>
|
|
* at <code>index.contextLimit</code>, advancing
|
|
* <code>index.contextLimit</code> by <code>insertion.length()</code>.
|
|
* Then the transliterator will try to transliterate characters of
|
|
* <code>text</code> between <code>index.start</code> and
|
|
* <code>index.contextLimit</code>. Characters before
|
|
* <code>index.start</code> will not be changed.
|
|
*
|
|
* <p>Upon return, values in <code>index</code> will be updated.
|
|
* <code>index.contextStart</code> will be advanced to the first
|
|
* character that future calls to this method will read.
|
|
* <code>index.start</code> and <code>index.contextLimit</code> will
|
|
* be adjusted to delimit the range of text that future calls to
|
|
* this method may change.
|
|
*
|
|
* <p>Typical usage of this method begins with an initial call
|
|
* with <code>index.contextStart</code> and <code>index.contextLimit</code>
|
|
* set to indicate the portion of <code>text</code> to be
|
|
* transliterated, and <code>index.start == index.contextStart</code>.
|
|
* Thereafter, <code>index</code> can be used without
|
|
* modification in future calls, provided that all changes to
|
|
* <code>text</code> are made via this method.
|
|
*
|
|
* <p>This method assumes that future calls may be made that will
|
|
* insert new text into the buffer. As a result, it only performs
|
|
* unambiguous transliterations. After the last call to this
|
|
* method, there may be untransliterated text that is waiting for
|
|
* more input to resolve an ambiguity. In order to perform these
|
|
* pending transliterations, clients should call {@link
|
|
* #finishKeyboardTransliteration} after the last call to this
|
|
* method has been made.
|
|
*
|
|
* @param text the buffer holding transliterated and untransliterated text
|
|
* @param index an array of three integers.
|
|
*
|
|
* <ul><li><code>index.contextStart</code>: the beginning index,
|
|
* inclusive; <code>0 <= index.contextStart <= index.contextLimit</code>.
|
|
*
|
|
* <li><code>index.contextLimit</code>: the ending index, exclusive;
|
|
* <code>index.contextStart <= index.contextLimit <= text.length()</code>.
|
|
* <code>insertion</code> is inserted at
|
|
* <code>index.contextLimit</code>.
|
|
*
|
|
* <li><code>index.start</code>: the next character to be
|
|
* considered for transliteration; <code>index.contextStart <=
|
|
* index.start <= index.contextLimit</code>. Characters before
|
|
* <code>index.start</code> will not be changed by future calls
|
|
* to this method.</ul>
|
|
*
|
|
* @param insertion text to be inserted and possibly
|
|
* transliterated into the translation buffer at
|
|
* <code>index.contextLimit</code>. If <code>null</code> then no text
|
|
* is inserted.
|
|
* @see #START
|
|
* @see #LIMIT
|
|
* @see #CURSOR
|
|
* @see #handleTransliterate
|
|
* @exception IllegalArgumentException if <code>index</code>
|
|
* is invalid
|
|
*/
|
|
void Transliterator::transliterate(Replaceable& text,
|
|
UTransPosition& index,
|
|
const UnicodeString& insertion,
|
|
UErrorCode &status) const {
|
|
_transliterate(text, index, &insertion, status);
|
|
}
|
|
|
|
/**
|
|
* Transliterates the portion of the text buffer that can be
|
|
* transliterated unambiguosly after a new character has been
|
|
* inserted, typically as a result of a keyboard event. This is a
|
|
* convenience method; see {@link
|
|
* #transliterate(Replaceable, int[], String)} for details.
|
|
* @param text the buffer holding transliterated and
|
|
* untransliterated text
|
|
* @param index an array of three integers. See {@link
|
|
* #transliterate(Replaceable, int[], String)}.
|
|
* @param insertion text to be inserted and possibly
|
|
* transliterated into the translation buffer at
|
|
* <code>index.contextLimit</code>.
|
|
* @see #transliterate(Replaceable, int[], String)
|
|
*/
|
|
void Transliterator::transliterate(Replaceable& text,
|
|
UTransPosition& index,
|
|
UChar insertion,
|
|
UErrorCode& status) const {
|
|
UnicodeString str(insertion);
|
|
_transliterate(text, index, &str, status);
|
|
}
|
|
|
|
/**
|
|
* Transliterates the portion of the text buffer that can be
|
|
* transliterated unambiguosly. This is a convenience method; see
|
|
* {@link #transliterate(Replaceable, int[], String)} for
|
|
* details.
|
|
* @param text the buffer holding transliterated and
|
|
* untransliterated text
|
|
* @param index an array of three integers. See {@link
|
|
* #transliterate(Replaceable, int[], String)}.
|
|
* @see #transliterate(Replaceable, int[], String)
|
|
*/
|
|
void Transliterator::transliterate(Replaceable& text,
|
|
UTransPosition& index,
|
|
UErrorCode& status) const {
|
|
_transliterate(text, index, 0, status);
|
|
}
|
|
|
|
/**
|
|
* Finishes any pending transliterations that were waiting for
|
|
* more characters. Clients should call this method as the last
|
|
* call after a sequence of one or more calls to
|
|
* <code>transliterate()</code>.
|
|
* @param text the buffer holding transliterated and
|
|
* untransliterated text.
|
|
* @param index the array of indices previously passed to {@link
|
|
* #transliterate}
|
|
*/
|
|
void Transliterator::finishTransliteration(Replaceable& text,
|
|
UTransPosition& index) const {
|
|
handleTransliterate(text, index, FALSE);
|
|
}
|
|
|
|
/**
|
|
* This internal method does keyboard transliteration. If the
|
|
* 'insertion' is non-null then we append it to 'text' before
|
|
* proceeding. This method calls through to the pure virtual
|
|
* framework method handleTransliterate() to do the actual
|
|
* work.
|
|
*/
|
|
void Transliterator::_transliterate(Replaceable& text,
|
|
UTransPosition& index,
|
|
const UnicodeString* insertion,
|
|
UErrorCode &status) const {
|
|
if (U_FAILURE(status)) {
|
|
return;
|
|
}
|
|
|
|
if (index.contextStart < 0 ||
|
|
index.contextLimit > text.length() ||
|
|
index.start < index.contextStart ||
|
|
index.start > index.contextLimit) {
|
|
status = U_ILLEGAL_ARGUMENT_ERROR;
|
|
return;
|
|
}
|
|
|
|
int32_t originalStart = index.contextStart;
|
|
if (insertion != 0) {
|
|
text.handleReplaceBetween(index.limit, index.limit, *insertion);
|
|
index.limit += insertion->length();
|
|
index.contextLimit += insertion->length();
|
|
}
|
|
|
|
handleTransliterate(text, index, TRUE);
|
|
|
|
index.contextStart = uprv_max(index.start - getMaximumContextLength(),
|
|
originalStart);
|
|
}
|
|
|
|
/**
|
|
* Method for subclasses to use to set the maximum context length.
|
|
* @see #getMaximumContextLength
|
|
*/
|
|
void Transliterator::setMaximumContextLength(int32_t maxContextLength) {
|
|
maximumContextLength = maxContextLength;
|
|
}
|
|
|
|
/**
|
|
* Returns a programmatic identifier for this transliterator.
|
|
* If this identifier is passed to <code>getInstance()</code>, it
|
|
* will return this object, if it has been registered.
|
|
* @see #registerInstance
|
|
* @see #getAvailableIDs
|
|
*/
|
|
const UnicodeString& Transliterator::getID(void) const {
|
|
return ID;
|
|
}
|
|
|
|
/**
|
|
* Returns a name for this transliterator that is appropriate for
|
|
* display to the user in the default locale. See {@link
|
|
* #getDisplayName(Locale)} for details.
|
|
*/
|
|
UnicodeString& Transliterator::getDisplayName(const UnicodeString& ID,
|
|
UnicodeString& result) {
|
|
return getDisplayName(ID, Locale::getDefault(), result);
|
|
}
|
|
|
|
/**
|
|
* Returns a name for this transliterator that is appropriate for
|
|
* display to the user in the given locale. This name is taken
|
|
* from the locale resource data in the standard manner of the
|
|
* <code>java.text</code> package.
|
|
*
|
|
* <p>If no localized names exist in the system resource bundles,
|
|
* a name is synthesized using a localized
|
|
* <code>MessageFormat</code> pattern from the resource data. The
|
|
* arguments to this pattern are an integer followed by one or two
|
|
* strings. The integer is the number of strings, either 1 or 2.
|
|
* The strings are formed by splitting the ID for this
|
|
* transliterator at the first ID_SEP. If there is no ID_SEP, then the
|
|
* entire ID forms the only string.
|
|
* @param inLocale the Locale in which the display name should be
|
|
* localized.
|
|
* @see java.text.MessageFormat
|
|
*/
|
|
UnicodeString& Transliterator::getDisplayName(const UnicodeString& ID,
|
|
const Locale& inLocale,
|
|
UnicodeString& result) {
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
|
|
ResourceBundle bundle(u_getDataDirectory(), inLocale, status);
|
|
|
|
// Suspend checking status until later...
|
|
|
|
// build the char* key
|
|
char key[100];
|
|
uprv_strcpy(key, RB_DISPLAY_NAME_PREFIX);
|
|
int32_t length=uprv_strlen(RB_DISPLAY_NAME_PREFIX);
|
|
key[length + ID.extract(0, sizeof(key)-length-1, key+length, "")]=0;
|
|
|
|
// Try to retrieve a UnicodeString* from the bundle. The result,
|
|
// if any, should NOT be deleted.
|
|
/*const UnicodeString* resString = bundle.getString(key, status);*/
|
|
UnicodeString resString = bundle.getStringEx(key, status);
|
|
|
|
/*if (U_SUCCESS(status) && resString != 0) {*/
|
|
if (U_SUCCESS(status) && resString.length() != 0) {
|
|
/*return result = *resString; // [sic] assign & return*/
|
|
return result = resString; // [sic] assign & return
|
|
}
|
|
|
|
// We have failed to get a name from the locale data. This is
|
|
// typical, since most transliterators will not have localized
|
|
// name data. The next step is to retrieve the MessageFormat
|
|
// pattern from the locale data and to use it to synthesize the
|
|
// name from the ID.
|
|
|
|
status = U_ZERO_ERROR;
|
|
/*resString = bundle.getString(RB_DISPLAY_NAME_PATTERN, status);*/
|
|
resString = bundle.getStringEx(RB_DISPLAY_NAME_PATTERN, status);
|
|
|
|
/*if (U_SUCCESS(status) && resString != 0) {*/
|
|
if (U_SUCCESS(status) && resString.length() != 0) {
|
|
/*MessageFormat msg(*resString, inLocale, status);*/
|
|
MessageFormat msg(resString, inLocale, status);
|
|
// Suspend checking status until later...
|
|
|
|
// We pass either 2 or 3 Formattable objects to msg.
|
|
Formattable args[3];
|
|
int32_t i = ID.indexOf(ID_SEP);
|
|
int32_t nargs;
|
|
if (i < 0) {
|
|
args[0].setLong(1); // # of args to follow
|
|
args[1].setString(ID);
|
|
nargs = 2;
|
|
} else {
|
|
UnicodeString left, right;
|
|
ID.extractBetween(0, i, left);
|
|
ID.extractBetween(i+1, ID.length(), right);
|
|
args[0].setLong(2); // # of args to follow
|
|
args[1].setString(left);
|
|
args[2].setString(right);
|
|
nargs = 3;
|
|
}
|
|
|
|
// Use display names for the scripts, if they exist
|
|
UnicodeString s;
|
|
for (int j=1; j<=((i<0)?1:2); ++j) {
|
|
status = U_ZERO_ERROR;
|
|
uprv_strcpy(key, RB_SCRIPT_DISPLAY_NAME_PREFIX);
|
|
length=uprv_strlen(RB_SCRIPT_DISPLAY_NAME_PREFIX);
|
|
args[j].getString(s);
|
|
key[length + s.extract(0, sizeof(key)-length-1, key+length, "")]=0;
|
|
|
|
/*resString = bundle.getString(key, status);*/
|
|
resString = bundle.getStringEx(key, status);
|
|
|
|
if (U_SUCCESS(status)) {
|
|
/*args[j] = *resString;*/
|
|
args[j] = resString;
|
|
}
|
|
}
|
|
|
|
status = U_ZERO_ERROR;
|
|
FieldPosition pos; // ignored by msg
|
|
msg.format(args, nargs, result, pos, status);
|
|
if (U_SUCCESS(status)) {
|
|
return result;
|
|
}
|
|
}
|
|
|
|
// We should not reach this point unless there is something
|
|
// wrong with the build or the RB_DISPLAY_NAME_PATTERN has
|
|
// been deleted from the root RB_LOCALE_ELEMENTS resource.
|
|
result = ID;
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Returns the filter used by this transliterator, or <tt>null</tt>
|
|
* if this transliterator uses no filter. Caller musn't delete
|
|
* the result!
|
|
*/
|
|
const UnicodeFilter* Transliterator::getFilter(void) const {
|
|
return filter;
|
|
}
|
|
|
|
/**
|
|
* Returns the filter used by this transliterator, or
|
|
* <tt>NULL</tt> if this transliterator uses no filter. The
|
|
* caller must eventually delete the result. After this call,
|
|
* this transliterator's filter is set to <tt>NULL</tt>.
|
|
*/
|
|
UnicodeFilter* Transliterator::orphanFilter(void) {
|
|
UnicodeFilter *result = filter;
|
|
// MUST go through adoptFilter in case latter is overridden
|
|
adoptFilter(0);
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* Changes the filter used by this transliterator. If the filter
|
|
* is set to <tt>null</tt> then no filtering will occur.
|
|
*
|
|
* <p>Callers must take care if a transliterator is in use by
|
|
* multiple threads. The filter should not be changed by one
|
|
* thread while another thread may be transliterating.
|
|
*/
|
|
void Transliterator::adoptFilter(UnicodeFilter* filterToAdopt) {
|
|
delete filter;
|
|
filter = filterToAdopt;
|
|
}
|
|
|
|
/**
|
|
* Returns this transliterator's inverse. See the class
|
|
* documentation for details. This implementation simply inverts
|
|
* the two entities in the ID and attempts to retrieve the
|
|
* resulting transliterator. That is, if <code>getID()</code>
|
|
* returns "A-B", then this method will return the result of
|
|
* <code>getInstance("B-A")</code>, or <code>null</code> if that
|
|
* call fails.
|
|
*
|
|
* <p>This method does not take filtering into account. The
|
|
* returned transliterator will have no filter.
|
|
*
|
|
* <p>Subclasses with knowledge of their inverse may wish to
|
|
* override this method.
|
|
*
|
|
* @return a transliterator that is an inverse, not necessarily
|
|
* exact, of this transliterator, or <code>null</code> if no such
|
|
* transliterator is registered.
|
|
* @see #registerInstance
|
|
*/
|
|
Transliterator* Transliterator::createInverse(void) const {
|
|
return Transliterator::createInstance(ID, UTRANS_REVERSE);
|
|
}
|
|
|
|
/**
|
|
* Returns a <code>Transliterator</code> object given its ID.
|
|
* The ID must be either a system transliterator ID or a ID registered
|
|
* using <code>registerInstance()</code>.
|
|
*
|
|
* @param ID a valid ID, as enumerated by <code>getAvailableIDs()</code>
|
|
* @return A <code>Transliterator</code> object with the given ID
|
|
* @see #registerInstance
|
|
* @see #getAvailableIDs
|
|
* @see #getID
|
|
*/
|
|
Transliterator* Transliterator::createInstance(const UnicodeString& ID,
|
|
UTransDirection dir,
|
|
UParseError* parseError) {
|
|
Transliterator* t = 0;
|
|
if (ID.indexOf(ID_DELIM) >= 0) {
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
t = new CompoundTransliterator(ID, dir, 0, status);
|
|
if (U_FAILURE(status)) {
|
|
delete t;
|
|
t = 0;
|
|
}
|
|
} else {
|
|
// The 'facadeID' is the ID to be applied to an alias
|
|
// transliterator like Hangul-Latin, which is really
|
|
// Hangul-Jamo;Jamo-Latin, but which should have a getID()
|
|
// result of "Hangul-Latin". The 'facadeID' is only used in
|
|
// that way for alias transliterators. The 'alias' parameter
|
|
// is non-empty if _createInstance() finds that the given ID
|
|
// refers to an alias. The reason _createInstance() doesn't
|
|
// call createInstance() (this method) directly is to avoid
|
|
// deadlock. There are other ways to do this but this is one
|
|
// of the more efficient ways.
|
|
UnicodeString alias, facadeID;
|
|
if (dir == UTRANS_REVERSE) {
|
|
int32_t i = ID.indexOf(ID_SEP);
|
|
if (i >= 0) {
|
|
UnicodeString right;
|
|
ID.extractBetween(i+1, ID.length(), facadeID);
|
|
ID.extractBetween(0, i, right);
|
|
facadeID.append(ID_SEP).append(right);
|
|
t = _createInstance(facadeID, alias, parseError);
|
|
}
|
|
} else {
|
|
t = _createInstance(ID, alias, parseError);
|
|
facadeID = ID;
|
|
}
|
|
if (alias.length() > 0) { // assert(t==0)
|
|
t = createInstance(alias);
|
|
if (t != 0) {
|
|
t->setID(ID);
|
|
}
|
|
}
|
|
}
|
|
return t;
|
|
}
|
|
|
|
/**
|
|
* Returns a transliterator object given its ID. Unlike getInstance(),
|
|
* this method returns null if it cannot make use of the given ID.
|
|
* @param aliasReturn if ID is an alias transliterator this is set
|
|
* the the parameter to be passed to createInstance() and 0 is
|
|
* returned; otherwise, this is unchanged
|
|
*/
|
|
Transliterator* Transliterator::_createInstance(const UnicodeString& ID,
|
|
UnicodeString& aliasReturn,
|
|
UParseError* parseError) {
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
|
|
if (!cacheInitialized) {
|
|
initializeCache();
|
|
}
|
|
|
|
Mutex lock(&cacheMutex);
|
|
|
|
CacheEntry* entry = (CacheEntry*) cache->get(ID);
|
|
if (entry == 0) {
|
|
entry = (CacheEntry*) internalCache->get(ID);
|
|
}
|
|
|
|
TransliterationRuleData* data = 0;
|
|
|
|
if (entry == 0) {
|
|
return 0;
|
|
}
|
|
|
|
if (entry->entryType == CacheEntry::RBT_DATA) {
|
|
data = entry->u.data;
|
|
// Fall through to construct transliterator from cached Data object.
|
|
} else if (entry->entryType == CacheEntry::PROTOTYPE) {
|
|
return entry->u.prototype->clone();
|
|
} else if (entry->entryType == CacheEntry::ALIAS) {
|
|
// We can't call createInstance() here because of deadlock.
|
|
aliasReturn = entry->stringArg;
|
|
return 0;
|
|
} else {
|
|
// At this point entry type must be either RULES_FORWARD
|
|
// or RULES_REVERSE
|
|
UBool isReverse = (entry->entryType == CacheEntry::RULES_REVERSE);
|
|
|
|
// We use the file name, taken from another resource bundle
|
|
// 2-d array at static init time, as a locale language. We're
|
|
// just using the locale mechanism to map through to a file
|
|
// name; this in no way represents an actual locale.
|
|
|
|
char *ch;
|
|
ch = new char[entry->stringArg.length() + 1];
|
|
ch[entry->stringArg.extract(0, 0x7fffffff, ch, "")] = 0;
|
|
Locale fakeLocale(ch);
|
|
delete [] ch;
|
|
|
|
ResourceBundle bundle((char *)0,
|
|
fakeLocale, status);
|
|
|
|
// Call RBT to parse the rules from the resource bundle
|
|
|
|
UnicodeString rules = bundle.getStringEx(RB_RULE, status);
|
|
|
|
// If the status indicates a failure, then we don't have any
|
|
// rules -- there is probably an installation error. The list
|
|
// in the root locale should correspond to all the installed
|
|
// transliterators; if it lists something that's not
|
|
// installed, we'll get an error from ResourceBundle.
|
|
if (U_SUCCESS(status)) {
|
|
|
|
data = TransliterationRuleParser::parse(rules, isReverse
|
|
? UTRANS_REVERSE
|
|
: UTRANS_FORWARD,
|
|
parseError);
|
|
|
|
// Double check to see if someone has modified the entry
|
|
// since we last looked at it.
|
|
if (entry->entryType != CacheEntry::RBT_DATA) {
|
|
entry->entryType = CacheEntry::RBT_DATA;
|
|
entry->u.data = data;
|
|
} else {
|
|
// Oops! Another thread has updated this cache entry
|
|
// already to point to a data object. Discard the
|
|
// one we just created and use the one in the cache
|
|
// instead.
|
|
delete data;
|
|
data = entry->u.data;
|
|
}
|
|
}
|
|
}
|
|
|
|
if (data != 0) {
|
|
return new RuleBasedTransliterator(ID, data);
|
|
} else {
|
|
// We have a failure of some kind. Remove the ID from the
|
|
// cache so we don't keep trying. NOTE: This will throw off
|
|
// anyone who is, at the moment, trying to iterate over the
|
|
// available IDs. That's acceptable since we should never
|
|
// really get here except under installation, configuration,
|
|
// or unrecoverable run time memory failures.
|
|
_unregister(ID);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* Registers a instance <tt>obj</tt> of a subclass of
|
|
* <code>Transliterator</code> with the system. This object must
|
|
* implement the <tt>clone()</tt> method. When
|
|
* <tt>getInstance()</tt> is called with an ID string that is
|
|
* equal to <tt>obj.getID()</tt>, then <tt>obj.clone()</tt> is
|
|
* returned.
|
|
*
|
|
* @param obj an instance of subclass of
|
|
* <code>Transliterator</code> that defines <tt>clone()</tt>
|
|
* @see #getInstance
|
|
* @see #unregister
|
|
*/
|
|
void Transliterator::registerInstance(Transliterator* adoptedPrototype,
|
|
UErrorCode &status) {
|
|
if (!cacheInitialized) {
|
|
initializeCache();
|
|
}
|
|
|
|
Mutex lock(&cacheMutex);
|
|
_registerInstance(adoptedPrototype, status);
|
|
}
|
|
|
|
/**
|
|
* This internal method registers a prototype instance in the cache.
|
|
* The CALLER MUST MUTEX using cacheMutex before calling this method.
|
|
*/
|
|
void Transliterator::_registerInstance(Transliterator* adoptedPrototype,
|
|
UErrorCode &status) {
|
|
if (U_FAILURE(status)) {
|
|
return;
|
|
}
|
|
|
|
/*int32_t hashCode = hash(adoptedPrototype->getID());*/
|
|
|
|
// This needs explaining: The string reference that getID returns
|
|
// is to the ID data member of Transliterator. As long as the
|
|
// Transliterator object exists, this reference is valid, and in
|
|
// fact we can take its address and store it in IDS. No problem
|
|
// there. The only thing we have to be sure of is that before we
|
|
// remove the prototype (via unregister()), we remove the ID
|
|
// entry.
|
|
cacheIDs.addElement((void*) &adoptedPrototype->getID());
|
|
|
|
CacheEntry* entry = (CacheEntry*) cache->get(adoptedPrototype->getID());
|
|
if (entry == 0) {
|
|
entry = new CacheEntry();
|
|
}
|
|
|
|
entry->adoptPrototype(adoptedPrototype);
|
|
|
|
//uhash_putKey(cache, hashCode, entry, &status);
|
|
cache->put(adoptedPrototype->getID(), entry, status);
|
|
}
|
|
|
|
/**
|
|
* Unregisters a transliterator or class. This may be either
|
|
* a system transliterator or a user transliterator or class.
|
|
*
|
|
* @param ID the ID of the transliterator or class
|
|
* @see #registerInstance
|
|
*/
|
|
void Transliterator::unregister(const UnicodeString& ID) {
|
|
if (!cacheInitialized) {
|
|
initializeCache();
|
|
}
|
|
Mutex lock(&cacheMutex);
|
|
_unregister(ID);
|
|
}
|
|
|
|
/**
|
|
* Unregisters a transliterator or class. Internal method.
|
|
* Prerequisites: The cache must be initialized, and the
|
|
* caller must own the cacheMutex.
|
|
*/
|
|
void Transliterator::_unregister(const UnicodeString& ID) {
|
|
cacheIDs.removeElement((void*) &ID);
|
|
//int32_t hc = hash(ID);
|
|
CacheEntry* entry = (CacheEntry*) cache->get(ID);
|
|
if (entry != 0) {
|
|
cache->remove(ID);
|
|
delete entry;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Vector of registered IDs.
|
|
*/
|
|
UVector Transliterator::cacheIDs;
|
|
|
|
/**
|
|
* Return the number of IDs currently registered with the system.
|
|
* To retrieve the actual IDs, call getAvailableID(i) with
|
|
* i from 0 to countAvailableIDs() - 1.
|
|
*/
|
|
int32_t Transliterator::countAvailableIDs(void) {
|
|
if (!cacheInitialized) {
|
|
initializeCache();
|
|
}
|
|
Mutex lock(&cacheMutex);
|
|
return cacheIDs.size();
|
|
}
|
|
|
|
/**
|
|
* Return the index-th available ID. index must be between 0
|
|
* and countAvailableIDs() - 1, inclusive. If index is out of
|
|
* range, the result of getAvailableID(0) is returned.
|
|
*/
|
|
const UnicodeString& Transliterator::getAvailableID(int32_t index) {
|
|
if (index < 0 || index >= cacheIDs.size()) {
|
|
index = 0;
|
|
}
|
|
if (!cacheInitialized) {
|
|
initializeCache();
|
|
}
|
|
Mutex lock(&cacheMutex);
|
|
return *(const UnicodeString*) cacheIDs[index];
|
|
}
|
|
|
|
/**
|
|
* Method for subclasses to use to obtain a character in the given
|
|
* string, with filtering.
|
|
*/
|
|
UChar Transliterator::filteredCharAt(const Replaceable& text, int32_t i) const {
|
|
UChar c;
|
|
const UnicodeFilter* localFilter = getFilter();
|
|
return (localFilter == 0) ? text.charAt(i) :
|
|
(localFilter->contains(c = text.charAt(i)) ? c : (UChar)0xFFFE);
|
|
}
|
|
|
|
/**
|
|
* Comparison function for UVector. Compares two UnicodeString
|
|
* objects given void* pointers to them.
|
|
*/
|
|
UBool Transliterator::compareIDs(void* a, void* b) {
|
|
const UnicodeString* aa = (const UnicodeString*) a;
|
|
const UnicodeString* bb = (const UnicodeString*) b;
|
|
return *aa == *bb;
|
|
}
|
|
|
|
void Transliterator::initializeCache(void) {
|
|
// Lock first, check init boolean second
|
|
Mutex lock(&cacheMutex);
|
|
if (cacheInitialized) {
|
|
return;
|
|
}
|
|
|
|
UErrorCode status = U_ZERO_ERROR;
|
|
|
|
// Before looking for the resource, construct our cache.
|
|
// That way if the resource is absent, we will at least
|
|
// have a valid cache object.
|
|
cacheIDs.setComparer(compareIDs);
|
|
|
|
/* The following code parses the index table located in
|
|
* icu/data/translit_index.txt. The index is an n x 4 table
|
|
* that follows this format:
|
|
*
|
|
* <id>:file:<resource>:<direction>
|
|
* <id>:internal:<resource>:<direction>
|
|
* <id>:alias:<getInstanceArg>:
|
|
*
|
|
* <id> is the ID of the system transliterator being defined. These
|
|
* are public IDs enumerated by Transliterator.getAvailableIDs(),
|
|
* unless the second field is "internal".
|
|
*
|
|
* <resource> is a ResourceReader resource name. Currently these refer
|
|
* to file names under com/ibm/text/resources. This string is passed
|
|
* directly to ResourceReader, together with <encoding>.
|
|
*
|
|
* <direction> is either "FORWARD" or "REVERSE".
|
|
*
|
|
* <getInstanceArg> is a string to be passed directly to
|
|
* Transliterator.getInstance(). The returned Transliterator object
|
|
* then has its ID changed to <id> and is returned.
|
|
*
|
|
* The extra blank field on "alias" lines is to make the array square.
|
|
*/
|
|
|
|
Locale indexLoc("translit_index");
|
|
|
|
ResourceBundle bundle((char *)0,
|
|
indexLoc, status);
|
|
ResourceBundle transIDs(bundle.get(RB_RULE_BASED_IDS, status));
|
|
|
|
int32_t row, maxRows;
|
|
if (U_SUCCESS(status)) {
|
|
maxRows = transIDs.getSize();
|
|
for (row = 0; row < maxRows; row++) {
|
|
ResourceBundle colBund(transIDs.get(row, status));
|
|
|
|
if (U_SUCCESS(status) && colBund.getSize() == 4) {
|
|
UnicodeString id(colBund.getStringEx((int32_t)0, status));
|
|
UChar type = colBund.getStringEx(1, status).charAt(0);
|
|
UnicodeString resource(colBund.getStringEx(2, status));
|
|
|
|
if (U_SUCCESS(status)) {
|
|
CacheEntry* entry = new CacheEntry();
|
|
if (type == 0x0066 || type == 0x0069) { // 'f', 'i'
|
|
// 'file' or 'internal'; row[2]=resource, row[3]=direction
|
|
if ((colBund.getStringEx(3, status).charAt(0)) == 0x0052) {// 'R'
|
|
entry->entryType = CacheEntry::RULES_REVERSE;
|
|
} else {
|
|
entry->entryType = CacheEntry::RULES_FORWARD;
|
|
}
|
|
} else { // assert(type == 0x0061 /*a*/)
|
|
// 'alias'; row[2]=createInstance argument
|
|
entry->entryType = CacheEntry::ALIAS;
|
|
}
|
|
entry->stringArg = resource;
|
|
// Use internalCache for 'internal' entries
|
|
Hashtable* c = (type == 0x0069/*i*/) ? internalCache : cache;
|
|
c->put(id, entry, status);
|
|
// cacheIDs owns & should delete the following string
|
|
cacheIDs.addElement((void*) new UnicodeString(id));
|
|
}
|
|
}
|
|
}
|
|
}
|
|
// Manually add prototypes that the system knows about to the
|
|
// cache. This is how new non-rule-based transliterators are
|
|
// added to the system.
|
|
|
|
status = U_ZERO_ERROR; // Reset status for following calls
|
|
_registerInstance(new HexToUnicodeTransliterator(), status);
|
|
_registerInstance(new UnicodeToHexTransliterator(), status);
|
|
_registerInstance(new JamoHangulTransliterator(), status);
|
|
_registerInstance(new HangulJamoTransliterator(), status);
|
|
_registerInstance(new NullTransliterator(), status);
|
|
|
|
cacheInitialized = TRUE;
|
|
}
|
|
|
|
Transliterator::CacheEntry::CacheEntry() {
|
|
u.prototype = 0;
|
|
entryType = NONE;
|
|
}
|
|
|
|
Transliterator::CacheEntry::~CacheEntry() {
|
|
if (entryType == PROTOTYPE) {
|
|
delete u.prototype;
|
|
}
|
|
}
|
|
|
|
void Transliterator::CacheEntry::adoptPrototype(Transliterator* adopted) {
|
|
if (entryType == PROTOTYPE) {
|
|
delete u.prototype;
|
|
}
|
|
entryType = PROTOTYPE;
|
|
u.prototype = adopted;
|
|
}
|