scuffed-code/icu4c/source/i18n/rbt_data.h
Andy Heninger be25c30571 ICU-1866 translit thread safety patch.
X-SVN-Rev: 14070
2003-12-10 01:52:39 +00:00

153 lines
4.7 KiB
C++

/*
* Copyright (C) {1999}, International Business Machines Corporation and others. All Rights Reserved.
**********************************************************************
* Date Name Description
* 11/17/99 aliu Creation.
**********************************************************************
*/
#ifndef RBT_DATA_H
#define RBT_DATA_H
#include "unicode/utypes.h"
#include "unicode/uclean.h"
#if !UCONFIG_NO_TRANSLITERATION
#include "unicode/uobject.h"
#include "rbt_set.h"
U_NAMESPACE_BEGIN
class UnicodeFunctor;
class UnicodeString;
class UnicodeMatcher;
class UnicodeReplacer;
class Hashtable;
/**
* The rule data for a RuleBasedTransliterators. RBT objects hold
* a const pointer to a TRD object that they do not own. TRD objects
* are essentially the parsed rules in compact, usable form. The
* TRD objects themselves are held for the life of the process in
* a static cache owned by Transliterator.
*
* This class' API is a little asymmetric. There is a method to
* define a variable, but no way to define a set. This is because the
* sets are defined by the parser in a UVector, and the vector is
* copied into a fixed-size array here. Once this is done, no new
* sets may be defined. In practice, there is no need to do so, since
* generating the data and using it are discrete phases. When there
* is a need to access the set data during the parse phase, another
* data structure handles this. See the parsing code for more
* details.
*/
class U_I18N_API TransliterationRuleData : public UMemory {
public:
// PUBLIC DATA MEMBERS
/**
* Rule table. May be empty.
*/
TransliterationRuleSet ruleSet;
/**
* Map variable name (String) to variable (UnicodeString). A variable name
* corresponds to zero or more characters, stored in a UnicodeString in
* this hash. One or more of these chars may also correspond to a
* UnicodeMatcher, in which case the character in the UnicodeString in this hash is
* a stand-in: it is an index for a secondary lookup in
* data.variables. The stand-in also represents the UnicodeMatcher in
* the stored rules.
*/
Hashtable* variableNames;
/**
* Map category variable (UChar) to set (UnicodeFunctor).
* Variables that correspond to a set of characters are mapped
* from variable name to a stand-in character in data.variableNames.
* The stand-in then serves as a key in this hash to lookup the
* actual UnicodeFunctor object. In addition, the stand-in is
* stored in the rule text to represent the set of characters.
* variables[i] represents character (variablesBase + i).
*/
UnicodeFunctor** variables;
/**
* The character that represents variables[0]. Characters
* variablesBase through variablesBase +
* variablesLength - 1 represent UnicodeFunctor objects.
*/
UChar variablesBase;
/**
* The length of variables.
*/
int32_t variablesLength;
public:
/**
* Constructor
* @param status Output param set to success/failure code on exit.
*/
TransliterationRuleData(UErrorCode& status);
/**
* Copy Constructor
*/
TransliterationRuleData(const TransliterationRuleData&);
/**
* destructor
*/
~TransliterationRuleData();
/**
* Given a stand-in character, return the UnicodeFunctor that it
* represents, or NULL if it doesn't represent anything.
* @param standIn the given stand-in character.
* @return the UnicodeFunctor that 'standIn' represents
*/
UnicodeFunctor* lookup(UChar32 standIn) const;
/**
* Given a stand-in character, return the UnicodeMatcher that it
* represents, or NULL if it doesn't represent anything or if it
* represents something that is not a matcher.
* @param standIn the given stand-in character.
* @return return the UnicodeMatcher that 'standIn' represents
*/
UnicodeMatcher* lookupMatcher(UChar32 standIn) const;
/**
* Given a stand-in character, return the UnicodeReplacer that it
* represents, or NULL if it doesn't represent anything or if it
* represents something that is not a replacer.
* @param standIn the given stand-in character.
* @return return the UnicodeReplacer that 'standIn' represents
*/
UnicodeReplacer* lookupReplacer(UChar32 standIn) const;
/**
* Acquire the mutex lock for this data.
*/
void lock();
/**
* Release the mutex lock for this data
*/
void unlock();
private:
TransliterationRuleData &operator=(const TransliterationRuleData &other); // forbid copying of this class
UMTX fLock;
};
U_NAMESPACE_END
#endif /* #if !UCONFIG_NO_TRANSLITERATION */
#endif