Transliterator is an abstract class that
* transliterates text from one format to another. The most common
* kind of transliterator is a script, or alphabet, transliterator.
@@ -52,7 +59,7 @@ class TransliteratorIDParser;
* transliterate(). (However, this does not
* mean that threads may share transliterators without synchronizing
* them. Transliterators are not immutable, so they must be
- * synchronized when shared between threads.) This1 might seem to
+ * synchronized when shared between threads.) This might seem to
* limit the complexity of the transliteration operation. In
* practice, subclasses perform complex transliterations by delaying
* the replacement of text until it is known that no other
@@ -68,12 +75,12 @@ class TransliteratorIDParser;
* transliteration. For example, given a string input
* and a transliterator t, the call
*
- * String result = t.transliterate(input);
- * \endhtmlonlyString result = t.transliterate(input);
+ * \htmlonly\endhtmlonly
*
* will transliterate it and return the result. Other methods allow
* the client to specify a substring to be transliterated and to use
- * {@link Replaceable} objects instead of strings, in order to
+ * {@link Replaceable } objects instead of strings, in order to
* preserve out-of-band information (such as text styles).
*
* Keyboard transliteration @@ -91,20 +98,20 @@ class TransliteratorIDParser; * *
Consider the simple RuleBasedTransliterator:
*
- *
+ * \htmlonly\endhtmlonly
* th>{theta}
* t>{tau}
- *
+ * \htmlonly
+ * \htmlonly\endhtmlonly
* t>|{tau}
* {tau}h>{theta}
- *
+ * \htmlonly"A" x AB -> "B"+ * \htmlonly
- * "B" x BA -> "A"
\endhtmlonly"A" x AB -> "B"\endhtmlonly * * where 'x' represents transliteration. However, * - *
+ * "B" x BA -> "A"\htmlonly
"ABCD" x AB -> "BBCD"+ * \htmlonly
- * "BBCD" x BA -> "AACD"
\endhtmlonly"ABCD" x AB -> "BBCD"\endhtmlonly * * so AB composed with BA is not the * identity. Nonetheless, BA may be usefully considered to be @@ -195,26 +202,26 @@ class TransliteratorIDParser; * *
+ * "BBCD" x BA -> "AACD"\htmlonly
In addition to programmatic IDs, transliterator objects have * display names for presentation in user interfaces, returned by - * {@link #getDisplayName()}. + * {@link #getDisplayName }. * *
Factory methods and registration * *
In general, client code should use the factory method
- * {@link #createInstance()} to obtain an instance of a
+ * {@link #createInstance } to obtain an instance of a
* transliterator given its ID. Valid IDs may be enumerated using
* getAvailableIDs(). Since transliterators are mutable,
- * multiple calls to {@link #createInstance()} with the same ID will
+ * multiple calls to {@link #createInstance } with the same ID will
* return distinct objects.
*
*
In addition to the system transliterators registered at startup,
* user transliterators may be registered by calling
* registerInstance() at run time. A registered instance
- * acts a template; future calls to {@link #createInstance()} with the ID
+ * acts a template; future calls to {@link #createInstance } with the ID
* of the registered object return clones of that object. Thus any
* object passed to registerInstance() must implement
* clone() propertly. To register a transliterator subclass
* without instantiating it (until it is needed), users may call
- * registerClass(). In this case, the objects are
+ * {@link #registerFactory }. In this case, the objects are
* instantiated by invoking the zero-argument public constructor of
* the class.
*
@@ -255,34 +262,36 @@ private:
/**
* A context integer or pointer for a factory function, passed by
* value.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
union Token {
/**
* This token, interpreted as a 32-bit integer.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
int32_t integer;
/**
* This token, interpreted as a native pointer.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
void* pointer;
};
+#ifndef U_HIDE_INTERNAL_API
/**
* Return a token containing an integer.
* @return a token containing an integer.
- * @draft ICU 2.4
+ * @internal
*/
inline static Token integerToken(int32_t);
/**
* Return a token containing a pointer.
* @return a token containing a pointer.
- * @draft ICU 2.4
+ * @internal
*/
inline static Token pointerToken(void*);
+#endif /* U_HIDE_INTERNAL_API */
/**
* A function that creates and returns a Transliterator. When
@@ -297,9 +306,9 @@ private:
* @param context a context pointer that will be stored and
* later passed to the factory function when an ID matching
* the registration ID is being instantiated with this factory.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
- typedef Transliterator* (*Factory)(const UnicodeString& ID, Token context);
+ typedef Transliterator* (U_EXPORT2 *Factory)(const UnicodeString& ID, Token context);
protected:
@@ -310,22 +319,22 @@ protected:
* filter.contains() returns false will not be
* altered by this transliterator. If filter is
* null then no filtering is applied.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
Transliterator(const UnicodeString& ID, UnicodeFilter* adoptedFilter);
/**
* Copy constructor.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
Transliterator(const Transliterator&);
/**
* Assignment operator.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
Transliterator& operator=(const Transliterator&);
-
+
/**
* Create a transliterator from a basic ID. This is an ID
* containing only the forward direction source, target, and
@@ -335,13 +344,14 @@ protected:
* NULL to leave the ID unchanged
* @return a newly created Transliterator or null if the ID is
* invalid.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
static Transliterator* createBasicInstance(const UnicodeString& id,
const UnicodeString* canon);
friend class TransliteratorParser; // for parseID()
friend class TransliteratorIDParser; // for createBasicInstance()
+ friend class TransliteratorAlias; // for setID()
public:
@@ -355,7 +365,7 @@ public:
* Implements Cloneable.
* All subclasses are encouraged to implement this method if it is
* possible and reasonable to do so. Subclasses that are to be
- * registered with the system using registerInstance()
+ * registered with the system using registerInstance()
* are required to implement this method. If a subclass does not
* implement clone() properly and is registered with the system
* using registerInstance(), then the default clone() implementation
@@ -365,7 +375,7 @@ public:
* @see #registerInstance
* @stable ICU 2.0
*/
- virtual Transliterator* clone() const { return 0; }
+ virtual Transliterator* clone() const;
/**
* Transliterates a segment of a string, with optional filtering.
@@ -425,7 +435,7 @@ public:
* 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
- * #finishTransliteration()} after the last call to this
+ * #finishTransliteration } after the last call to this
* method has been made.
*
* @param text the buffer holding transliterated and untransliterated text
@@ -464,17 +474,15 @@ public:
* 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, UTransPosition, UnicodeString)} for details.
+ * convenience method.
* @param text the buffer holding transliterated and
* untransliterated text
- * @param index an array of three integers. See {@link
- * #transliterate(Replaceable, UTransPosition, UnicodeString)}.
+ * @param index an array of three integers.
* @param insertion text to be inserted and possibly
* transliterated into the translation buffer at
* index.limit.
* @param status Output param to filled in with a success or an error.
- * @see #transliterate(Replaceable, UTransPosition, UnicodeString)
+ * @see #transliterate(Replaceable&, UTransPosition&, const UnicodeString&, UErrorCode&) const
* @stable ICU 2.0
*/
virtual void transliterate(Replaceable& text, UTransPosition& index,
@@ -484,12 +492,12 @@ public:
/**
* Transliterates the portion of the text buffer that can be
* transliterated unambiguosly. This is a convenience method; see
- * {@link #transliterate(Replaceable, UTransPosition, UnicodeString)} for
- * details.
+ * {@link
+ * #transliterate(Replaceable&, UTransPosition&, const UnicodeString&, UErrorCode&) const }
+ * for details.
* @param text the buffer holding transliterated and
* untransliterated text
- * @param index an array of three integers. See {@link
- * #transliterate(Replaceable, UTransPosition, UnicodeString)}.
+ * @param index an array of three integers. See {@link #transliterate(Replaceable&, UTransPosition&, const UnicodeString*, UErrorCode&) const }.
* @param status Output param to filled in with a success or an error.
* @see #transliterate(Replaceable, int[], String)
* @stable ICU 2.0
@@ -505,7 +513,7 @@ public:
* @param text the buffer holding transliterated and
* untransliterated text.
* @param index the array of indices previously passed to {@link
- * #transliterate()}
+ * #transliterate }
* @stable ICU 2.0
*/
virtual void finishTransliteration(Replaceable& text,
@@ -541,7 +549,7 @@ protected:
* incremental and non-incremental transliteration. Let
* originalStart refer to the value of
* pos.start upon entry.
- *
+ *
*
*
- *
+ *
* incremental is false, then this method
* should transliterate all characters between
@@ -561,7 +569,7 @@ protected:
* transliterator and characters [pos.start,
* pos.limit) are unchanged.
Implementations of this method should also obey the * following invariants:
* @@ -584,40 +592,41 @@ protected: *pos.contextStart and text after
* pos.contextLimit should be ignored.Subclasses may safely assume that all characters in
* [pos.start, pos.limit) are filtered.
* In other words, the filter has already been applied by the time
* this method is called. See
* filteredTransliterate().
- *
+ *
*
This method is not for public consumption. Calling
* this method directly will transliterate
* [pos.start, pos.limit) without
* applying the filter. End user code should call
* transliterate() instead of this method. Subclass code
- * should call filteredTransliterate() instead of
- * this method.
- *
+ * and wrapping transliterators should call
+ * filteredTransliterate() instead of this method.
+ *
* @param text the buffer holding transliterated and
* untransliterated text
- *
+ *
* @param pos the indices indicating the start, limit, context
* start, and context limit of the text.
- *
+ *
* @param 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 #transliterate
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
virtual void handleTransliterate(Replaceable& text,
UTransPosition& pos,
UBool incremental) const = 0;
+public:
/**
* Transliterate a substring of text, as specified by index, taking filters
* into account. This method is for subclasses that need to delegate to
@@ -627,15 +636,12 @@ protected:
* @param incremental if TRUE, then assume more characters may be inserted
* at index.limit, and postpone processing to accomodate future incoming
* characters
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
virtual void filteredTransliterate(Replaceable& text,
UTransPosition& index,
UBool incremental) const;
- friend class CompoundTransliterator; // for filteredTransliterate()
- friend class AnyTransliterator; // for filteredTransliterate()
-
private:
/**
@@ -644,10 +650,10 @@ private:
* public API methods eventually call this method with a rollback argument
* of TRUE. Other entities may call this method but rollback should be
* FALSE.
- *
+ *
*
If this transliterator has a filter, break up the input text into runs
* of unfiltered characters. Pass each run to
- * In incremental mode, if rollback is TRUE, perform a special
* incremental procedure in which several passes are made over the input
@@ -693,7 +699,7 @@ protected:
* Method for subclasses to use to set the maximum context length.
* @param maxContextLength the new value to be set.
* @see #getMaximumContextLength
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
void setMaximumContextLength(int32_t maxContextLength);
@@ -705,7 +711,7 @@ public:
* will return this object, if it has been registered.
* @return a programmatic identifier for this transliterator.
* @see #registerInstance
- * @see #registerClass
+ * @see #registerFactory
* @see #getAvailableIDs
* @stable ICU 2.0
*/
@@ -714,13 +720,13 @@ public:
/**
* Returns a name for this transliterator that is appropriate for
* display to the user in the default locale. See {@link
- * #getDisplayName()} for details.
+ * #getDisplayName } for details.
* @param ID the string identifier for this transliterator
* @param result Output param to receive the display name
* @return A reference to 'result'.
* @stable ICU 2.0
*/
- static UnicodeString& getDisplayName(const UnicodeString& ID,
+ static UnicodeString& U_EXPORT2 getDisplayName(const UnicodeString& ID,
UnicodeString& result);
/**
@@ -744,7 +750,7 @@ public:
* @return A reference to 'result'.
* @stable ICU 2.0
*/
- static UnicodeString& getDisplayName(const UnicodeString& ID,
+ static UnicodeString& U_EXPORT2 getDisplayName(const UnicodeString& ID,
const Locale& inLocale,
UnicodeString& result);
@@ -764,7 +770,7 @@ public:
* NULL.
* @return the filter used by this transliterator, or NULL if this
* transliterator uses no filter.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
UnicodeFilter* orphanFilter(void);
@@ -808,7 +814,7 @@ public:
*
* @param ID a valid ID, as enumerated by If this transliterator is not composed of other
+ * transliterators, then this method returns 1.
+ * @return the number of transliterators that compose this
+ * transliterator, or 1 if this transliterator is not composed of
+ * multiple transliterators
+ * @stable ICU 3.0
+ */
+ int32_t countElements() const;
+
+ /**
+ * Return an element that makes up this transliterator. For
+ * example, if the transliterator "NFD;Jamo-Latin;Latin-Greek"
+ * were created, the return value of this method would be one
+ * of the three transliterator objects that make up that
+ * transliterator: [NFD, Jamo-Latin, Latin-Greek].
+ *
+ * If this transliterator is not composed of other
+ * transliterators, then this method will return a reference to
+ * this transliterator when given the index 0.
+ * @param index a value from 0..countElements()-1 indicating the
+ * transliterator to return
+ * @param ec input-output error code
+ * @return one of the transliterators that makes up this
+ * transliterator, if this transliterator is made up of multiple
+ * transliterators, otherwise a reference to this object if given
+ * an index of 0
+ * @stable ICU 3.0
+ */
+ const Transliterator& getElement(int32_t index, UErrorCode& ec) const;
+
/**
* Returns the set of all characters that may be modified in the
* input text by this Transliterator. This incorporates this
* object's current filter; if the filter is changed, the return
* value of this function will change. The default implementation
* returns an empty set. Some subclasses may override {@link
- * #handleGetSourceSet()} to return a more precise result. The
+ * #handleGetSourceSet } to return a more precise result. The
* return result is approximate in any case and is intended for
* use by tests, tools, or utilities.
* @param result receives result set; previous contents lost
* @return a reference to result
* @see #getTargetSet
* @see #handleGetSourceSet
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
UnicodeSet& getSourceSet(UnicodeSet& result) const;
@@ -899,7 +941,7 @@ public:
* @param result receives result set; previous contents lost
* @see #getSourceSet
* @see #getTargetSet
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
virtual void handleGetSourceSet(UnicodeSet& result) const;
@@ -914,7 +956,7 @@ public:
* @param result receives result set; previous contents lost
* @return a reference to result
* @see #getTargetSet
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
virtual UnicodeSet& getTargetSet(UnicodeSet& result) const;
@@ -931,12 +973,12 @@ public:
* the registration ID is being instantiated with this factory.
* @stable ICU 2.0
*/
- static void registerFactory(const UnicodeString& id,
+ static void U_EXPORT2 registerFactory(const UnicodeString& id,
Factory factory,
Token context);
/**
- * Registers a instance obj of a subclass of
+ * Registers an instance obj of a subclass of
* Concrete subclasses of Transliterator that wish clients to
- * be able to identify them should implement getDynamicClassID()
- * and also a static method and data member:
- *
- * Concrete subclasses of Transliterator must use the
+ * UOBJECT_DEFINE_RTTI_IMPLEMENTATION macro from
+ * uobject.h to provide the RTTI functions.
*
* @return The class ID for this object. All objects of a given
* class have the same class ID. Objects of other classes have
@@ -1219,28 +1268,44 @@ public:
virtual UClassID getDynamicClassID(void) const = 0;
private:
+ static UBool initializeRegistry(UErrorCode &status);
+public:
+#ifndef U_HIDE_OBSOLETE_API
/**
- * Class identifier for subclasses of Transliterator that do not
- * define their class (anonymous subclasses).
+ * 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.
+ * @return the number of IDs currently registered with the system.
+ * @obsolete ICU 3.4 use getAvailableIDs() instead
*/
- static const char fgClassID;
-
-private:
- static UBool initializeRegistry(void);
+ static int32_t U_EXPORT2 countAvailableIDs(void);
+ /**
+ * 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.
+ * @param index the given ID index.
+ * @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.
+ * @obsolete ICU 3.4 use getAvailableIDs() instead; this function
+ * is not thread safe, since it returns a reference to storage that
+ * may become invalid if another thread calls unregister
+ */
+ static const UnicodeString& U_EXPORT2 getAvailableID(int32_t index);
+#endif /* U_HIDE_OBSOLETE_API */
};
-inline UClassID
-Transliterator::getStaticClassID(void)
-{ return (UClassID)&fgClassID; }
-
inline int32_t Transliterator::getMaximumContextLength(void) const {
return maximumContextLength;
}
inline void Transliterator::setID(const UnicodeString& id) {
ID = id;
+ // NUL-terminate the ID string, which is a non-aliased copy.
+ ID.append((UChar)0);
+ ID.truncate(ID.length()-1);
}
inline Transliterator::Token Transliterator::integerToken(int32_t i) {
getAvailableIDs()
* @param dir either FORWARD or REVERSE.
- * @param parseError Struct to recieve information on position
+ * @param parseError Struct to recieve information on position
* of error if an error is encountered
* @param status Output param to filled in with a success or an error.
* @return A Transliterator object with the given ID
@@ -817,7 +823,7 @@ public:
* @see #getID
* @stable ICU 2.0
*/
- static Transliterator* createInstance(const UnicodeString& ID,
+ static Transliterator* U_EXPORT2 createInstance(const UnicodeString& ID,
UTransDirection dir,
UParseError& parseError,
UErrorCode& status);
@@ -832,9 +838,10 @@ public:
* @return A Transliterator object with the given ID
* @stable ICU 2.0
*/
- static Transliterator* createInstance(const UnicodeString& ID,
+ static Transliterator* U_EXPORT2 createInstance(const UnicodeString& ID,
UTransDirection dir,
UErrorCode& status);
+
/**
* Returns a Transliterator object constructed from
* the given rule string. This will be a RuleBasedTransliterator,
@@ -845,12 +852,12 @@ public:
* @param ID the id for the transliterator.
* @param rules rules, separated by ';'
* @param dir either FORWARD or REVERSE.
- * @param parseError Struct to recieve information on position
+ * @param parseError Struct to recieve information on position
* of error if an error is encountered
* @param status Output param set to success/failure code.
* @stable ICU 2.0
*/
- static Transliterator* createFromRules(const UnicodeString& ID,
+ static Transliterator* U_EXPORT2 createFromRules(const UnicodeString& ID,
const UnicodeString& rules,
UTransDirection dir,
UParseError& parseError,
@@ -862,28 +869,63 @@ public:
* @param result the string to receive the rules. Previous
* contents will be deleted.
* @param escapeUnprintable if TRUE then convert unprintable
- * character to their hex escape representations, \uxxxx or
- * \Uxxxxxxxx. Unprintable characters are those other than
+ * character to their hex escape representations, \\uxxxx or
+ * \\Uxxxxxxxx. Unprintable characters are those other than
* U+000A, U+0020..U+007E.
* @stable ICU 2.0
*/
virtual UnicodeString& toRules(UnicodeString& result,
UBool escapeUnprintable) const;
+ /**
+ * Return the number of elements that make up this transliterator.
+ * For example, if the transliterator "NFD;Jamo-Latin;Latin-Greek"
+ * were created, the return value of this method would be 3.
+ *
+ * Transliterator with the system. When
* createInstance() is called with an ID string that is
* equal to obj->getID(), then obj->clone() is
@@ -948,14 +990,32 @@ public:
* @param adoptedObj an instance of subclass of
* Transliterator that defines clone()
* @see #createInstance
- * @see #registerClass
+ * @see #registerFactory
* @see #unregister
* @stable ICU 2.0
*/
- static void registerInstance(Transliterator* adoptedObj);
+ static void U_EXPORT2 registerInstance(Transliterator* adoptedObj);
+
+ /**
+ * Registers an ID string as an alias of another ID string.
+ * That is, after calling this function, createInstance(aliasID)
+ * will return the same thing as createInstance(realID).
+ * This is generally used to create shorter, more mnemonic aliases
+ * for long compound IDs.
+ *
+ * @param aliasID The new ID being registered.
+ * @param realID The ID that the new ID is to be an alias for.
+ * This can be a compound ID and can include filters and should
+ * refer to transliterators that have already been registered with
+ * the framework, although this isn't checked.
+ * @stable ICU 3.6
+ */
+ static void U_EXPORT2 registerAlias(const UnicodeString& aliasID,
+ const UnicodeString& realID);
protected:
+#ifndef U_HIDE_INTERNAL_API
/**
* @internal
* @param id the ID being registered
@@ -974,6 +1034,11 @@ protected:
*/
static void _registerInstance(Transliterator* adoptedObj);
+ /**
+ * @internal
+ */
+ static void _registerAlias(const UnicodeString& aliasID, const UnicodeString& realID);
+
/**
* Register two targets as being inverses of one another. For
* example, calling registerSpecialInverse("NFC", "NFD", true) causes
@@ -1010,6 +1075,7 @@ protected:
static void _registerSpecialInverse(const UnicodeString& target,
const UnicodeString& inverseTarget,
UBool bidirectional);
+#endif /* U_HIDE_INTERNAL_API */
public:
@@ -1023,41 +1089,31 @@ public:
* @return the Object that was registered with
* ID, or null if none was
* @see #registerInstance
- * @see #registerClass
+ * @see #registerFactory
* @stable ICU 2.0
*/
- static void unregister(const UnicodeString& ID);
+ static void U_EXPORT2 unregister(const UnicodeString& ID);
public:
/**
- * 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.
- * @return the number of IDs currently registered with the system.
- * @stable ICU 2.0
+ * Return a StringEnumeration over the IDs available at the time of the
+ * call, including user-registered IDs.
+ * @param ec input-output error code
+ * @return a newly-created StringEnumeration over the transliterators
+ * available at the time of the call. The caller should delete this object
+ * when done using it.
+ * @stable ICU 3.0
*/
- static int32_t countAvailableIDs(void);
-
- /**
- * 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.
- * @param index the given ID index.
- * @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.
- * @stable ICU 2.0
- */
- static const UnicodeString& getAvailableID(int32_t index);
+ static StringEnumeration* U_EXPORT2 getAvailableIDs(UErrorCode& ec);
/**
* Return the number of registered source specifiers.
* @return the number of registered source specifiers.
* @stable ICU 2.0
*/
- static int32_t countAvailableSources(void);
-
+ static int32_t U_EXPORT2 countAvailableSources(void);
+
/**
* Return a registered source specifier.
* @param index which specifier to return, from 0 to n-1, where
@@ -1067,9 +1123,9 @@ public:
* @return reference to result
* @stable ICU 2.0
*/
- static UnicodeString& getAvailableSource(int32_t index,
+ static UnicodeString& U_EXPORT2 getAvailableSource(int32_t index,
UnicodeString& result);
-
+
/**
* Return the number of registered target specifiers for a given
* source specifier.
@@ -1078,8 +1134,8 @@ public:
* source specifier.
* @stable ICU 2.0
*/
- static int32_t countAvailableTargets(const UnicodeString& source);
-
+ static int32_t U_EXPORT2 countAvailableTargets(const UnicodeString& source);
+
/**
* Return a registered target specifier for a given source.
* @param index which specifier to return, from 0 to n-1, where
@@ -1091,10 +1147,10 @@ public:
* @return reference to result
* @stable ICU 2.0
*/
- static UnicodeString& getAvailableTarget(int32_t index,
+ static UnicodeString& U_EXPORT2 getAvailableTarget(int32_t index,
const UnicodeString& source,
UnicodeString& result);
-
+
/**
* Return the number of registered variant specifiers for a given
* source-target pair.
@@ -1102,9 +1158,9 @@ public:
* @param target the target specifiers.
* @stable ICU 2.0
*/
- static int32_t countAvailableVariants(const UnicodeString& source,
+ static int32_t U_EXPORT2 countAvailableVariants(const UnicodeString& source,
const UnicodeString& target);
-
+
/**
* Return a registered variant specifier for a given source-target
* pair.
@@ -1118,55 +1174,57 @@ public:
* @return reference to result
* @stable ICU 2.0
*/
- static UnicodeString& getAvailableVariant(int32_t index,
+ static UnicodeString& U_EXPORT2 getAvailableVariant(int32_t index,
const UnicodeString& source,
const UnicodeString& target,
UnicodeString& result);
protected:
+#ifndef U_HIDE_INTERNAL_API
/**
* Non-mutexed internal method
* @internal
*/
static int32_t _countAvailableSources(void);
-
+
/**
* Non-mutexed internal method
* @internal
*/
static UnicodeString& _getAvailableSource(int32_t index,
- UnicodeString& result);
-
+ UnicodeString& result);
+
/**
* Non-mutexed internal method
* @internal
*/
static int32_t _countAvailableTargets(const UnicodeString& source);
-
+
/**
* Non-mutexed internal method
* @internal
*/
static UnicodeString& _getAvailableTarget(int32_t index,
- const UnicodeString& source,
- UnicodeString& result);
-
+ const UnicodeString& source,
+ UnicodeString& result);
+
/**
* Non-mutexed internal method
* @internal
*/
static int32_t _countAvailableVariants(const UnicodeString& source,
- const UnicodeString& target);
-
+ const UnicodeString& target);
+
/**
* Non-mutexed internal method
* @internal
*/
static UnicodeString& _getAvailableVariant(int32_t index,
- const UnicodeString& source,
- const UnicodeString& target,
- UnicodeString& result);
+ const UnicodeString& source,
+ const UnicodeString& target,
+ UnicodeString& result);
+#endif /* U_HIDE_INTERNAL_API */
protected:
@@ -1174,7 +1232,7 @@ protected:
* Set the ID of this transliterators. Subclasses shouldn't do
* this, unless the underlying script behavior has changed.
* @param id the new id t to be set.
- * @draft ICU 2.4
+ * @stable ICU 2.4
*/
void setID(const UnicodeString& id);
@@ -1182,34 +1240,25 @@ public:
/**
* Return the class ID for this class. This is useful only for
- * comparing to a return value from getDynamicClassID(). For example:
- *
- * . Base* polymorphic_pointer = createPolymorphicObject();
- * . if (polymorphic_pointer->getDynamicClassID() ==
- * . Derived::getStaticClassID()) ...
- *
- * @return The class ID for all objects of this class.
+ * comparing to a return value from getDynamicClassID().
+ * Note that Transliterator is an abstract base class, and therefor
+ * no fully constructed object will have a dynamic
+ * UCLassID that equals the UClassID returned from
+ * TRansliterator::getStaticClassID().
+ * @return The class ID for class Transliterator.
* @stable ICU 2.0
*/
- static inline UClassID getStaticClassID(void);
+ static UClassID U_EXPORT2 getStaticClassID(void);
/**
* Returns a unique class ID polymorphically. This method
* is to implement a simple version of RTTI, since not all C++
* compilers support genuine RTTI. Polymorphic operator==() and
* clone() methods call this method.
- *
- *
- * static UClassID getStaticClassID() { return (UClassID)&fgClassID; }
- * static char fgClassID;
- *
*
- * Subclasses that do not implement this method will have a
- * dynamic class ID of Transliterator::getStatisClassID().
+ *