16f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/* 26f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org ******************************************************************** 36f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * COPYRIGHT: 46f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Copyright (c) 1996-2011, International Business Machines Corporation and 56f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * others. All Rights Reserved. 66f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org ******************************************************************** 76f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 86f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 96f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#ifndef NORMLZR_H 106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#define NORMLZR_H 116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/utypes.h" 136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \file 166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \brief C++ API: Unicode Normalization 176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#if !UCONFIG_NO_NORMALIZATION 206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/chariter.h" 226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/normalizer2.h" 236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/unistr.h" 246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/unorm.h" 256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#include "unicode/uobject.h" 266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_NAMESPACE_BEGIN 286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org/** 296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The Normalizer class supports the standard normalization forms described in 306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <a href="http://www.unicode.org/unicode/reports/tr15/" target="unicode"> 316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Unicode Standard Annex #15: Unicode Normalization Forms</a>. 326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Note: This API has been replaced by the Normalizer2 class and is only available 346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * for backward compatibility. This class simply delegates to the Normalizer2 class. 356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * There is one exception: The new API does not provide a replacement for Normalizer::compare(). 366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The Normalizer class consists of two parts: 386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - static functions that normalize strings or test if strings are normalized 396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - a Normalizer object is an iterator that takes any kind of text and 406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * provides iteration over its normalized form 416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The Normalizer class is not suitable for subclassing. 436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For basic information about normalization forms and details about the C API 456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * please see the documentation in unorm.h. 466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The iterator API with the Normalizer constructors and the non-static functions 486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * use a CharacterIterator as input. It is possible to pass a string which 496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * is then internally wrapped in a CharacterIterator. 506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The input text is not normalized all at once, but incrementally where needed 516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (providing efficient random access). 526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This allows to pass in a large text but spend only a small amount of time 536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * normalizing a small part of that text. 546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * However, if the entire text is normalized, then the iterator will be 556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * slower than normalizing the entire text at once and iterating over the result. 566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * A possible use of the Normalizer iterator is also to report an index into the 576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * original text that is close to where the normalized characters come from. 586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <em>Important:</em> The iterator API was cleaned up significantly for ICU 2.0. 606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The earlier implementation reported the getIndex() inconsistently, 616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * and previous() could not be used after setIndex(), next(), first(), and current(). 626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Normalizer allows to start normalizing from anywhere in the input text by 646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * calling setIndexOnly(), first(), or last(). 656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Without calling any of these, the iterator will start at the beginning of the text. 666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * At any time, next() returns the next normalized code point (UChar32), 686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * with post-increment semantics (like CharacterIterator::next32PostInc()). 696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * previous() returns the previous normalized code point (UChar32), 706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * with pre-decrement semantics (like CharacterIterator::previous32()). 716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * current() returns the current code point 736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (respectively the one at the newly set index) without moving 746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the getIndex(). Note that if the text at the current position 756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * needs to be normalized, then these functions will do that. 766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (This is why current() is not const.) 776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It is more efficient to call setIndexOnly() instead, which does not 786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * normalize. 796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * getIndex() always refers to the position in the input text where the normalized 816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * code points are returned from. It does not always change with each returned 826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * code point. 836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The code point that is returned from any of the functions 846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * corresponds to text at or after getIndex(), according to the 856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * function's iteration semantics (post-increment or pre-decrement). 866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * next() returns a code point from at or after the getIndex() 886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * from before the next() call. After the next() call, the getIndex() 896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * might have moved to where the next code point will be returned from 906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (from a next() or current() call). 916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is semantically equivalent to array access with array[index++] 926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (post-increment semantics). 936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * previous() returns a code point from at or after the getIndex() 956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * from after the previous() call. 966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is semantically equivalent to array access with array[--index] 976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (pre-decrement semantics). 986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Internally, the Normalizer iterator normalizes a small piece of text 1006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * starting at the getIndex() and ending at a following "safe" index. 1016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The normalized results is stored in an internal string buffer, and 1026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the code points are iterated from there. 1036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * With multiple iteration calls, this is repeated until the next piece 1046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * of text needs to be normalized, and the getIndex() needs to be moved. 1056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The following "safe" index, the internal buffer, and the secondary 1076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * iteration index into that buffer are not exposed on the API. 1086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This also means that it is currently not practical to return to 1096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * a particular, arbitrary position in the text because one would need to 1106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * know, and be able to set, in addition to the getIndex(), at least also the 1116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * current index into the internal buffer. 1126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It is currently only possible to observe when getIndex() changes 1136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (with careful consideration of the iteration semantics), 1146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * at which time the internal index will be 0. 1156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For example, if getIndex() is different after next() than before it, 1166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * then the internal index is 0 and one can return to this getIndex() 1176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * later with setIndexOnly(). 1186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Note: While the setIndex() and getIndex() refer to indices in the 1206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * underlying Unicode input text, the next() and previous() methods 1216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * iterate through characters in the normalized output. 1226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This means that there is not necessarily a one-to-one correspondence 1236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * between characters returned by next() and previous() and the indices 1246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * passed to and returned from setIndex() and getIndex(). 1256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It is for this reason that Normalizer does not implement the CharacterIterator interface. 1266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @author Laura Werner, Mark Davis, Markus Scherer 1286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgclass U_COMMON_API Normalizer : public UObject { 1316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgpublic: 1326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If DONE is returned from an iteration function that returns a code point, 1346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * then there are no more normalization results available. 1356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org enum { 1386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org DONE=0xffff 1396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org }; 1406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Constructors 1426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Creates a new <code>Normalizer</code> object for iterating over the 1456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * normalized form of a given string. 1466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p> 1476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param str The string to be normalized. The normalization 1486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * will start at the beginning of the string. 1496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode The normalization mode. 1516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer(const UnicodeString& str, UNormalizationMode mode); 1546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Creates a new <code>Normalizer</code> object for iterating over the 1576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * normalized form of a given string. 1586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p> 1596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param str The string to be normalized. The normalization 1606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * will start at the beginning of the string. 1616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param length Length of the string, or -1 if NUL-terminated. 1636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode The normalization mode. 1646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer(const UChar* str, int32_t length, UNormalizationMode mode); 1676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Creates a new <code>Normalizer</code> object for iterating over the 1706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * normalized form of the given text. 1716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p> 1726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param iter The input text to be normalized. The normalization 1736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * will start at the beginning of the string. 1746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 1756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode The normalization mode. 1766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer(const CharacterIterator& iter, UNormalizationMode mode); 1796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Copy constructor. 1826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param copy The object to be copied. 1836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer(const Normalizer& copy); 1866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Destructor 1896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 1906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 1916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org virtual ~Normalizer(); 1926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 1956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Static utility methods 1966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 1976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 1986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 1996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Normalizes a <code>UnicodeString</code> according to the specified normalization mode. 2006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is a wrapper for unorm_normalize(), using UnicodeString's. 2016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The <code>options</code> parameter specifies which optional 2036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>Normalizer</code> features are to be enabled for this operation. 2046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param source the input string to be normalized. 2066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode the normalization mode 2076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options the optional features to be enabled (0 for no options) 2086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param result The normalized string (on output). 2096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status The error code. 2106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static void U_EXPORT2 normalize(const UnicodeString& source, 2136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UNormalizationMode mode, int32_t options, 2146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UnicodeString& result, 2156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status); 2166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 2186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Compose a <code>UnicodeString</code>. 2196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is equivalent to normalize() with mode UNORM_NFC or UNORM_NFKC. 2206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is a wrapper for unorm_normalize(), using UnicodeString's. 2216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The <code>options</code> parameter specifies which optional 2236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>Normalizer</code> features are to be enabled for this operation. 2246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param source the string to be composed. 2266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param compat Perform compatibility decomposition before composition. 2276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If this argument is <code>FALSE</code>, only canonical 2286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * decomposition will be performed. 2296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options the optional features to be enabled (0 for no options) 2306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param result The composed string (on output). 2316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status The error code. 2326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static void U_EXPORT2 compose(const UnicodeString& source, 2356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool compat, int32_t options, 2366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UnicodeString& result, 2376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status); 2386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 2406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Static method to decompose a <code>UnicodeString</code>. 2416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is equivalent to normalize() with mode UNORM_NFD or UNORM_NFKD. 2426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is a wrapper for unorm_normalize(), using UnicodeString's. 2436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The <code>options</code> parameter specifies which optional 2456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <code>Normalizer</code> features are to be enabled for this operation. 2466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param source the string to be decomposed. 2486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param compat Perform compatibility decomposition. 2496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If this argument is <code>FALSE</code>, only canonical 2506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * decomposition will be performed. 2516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options the optional features to be enabled (0 for no options) 2526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param result The decomposed string (on output). 2536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status The error code. 2546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static void U_EXPORT2 decompose(const UnicodeString& source, 2576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool compat, int32_t options, 2586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UnicodeString& result, 2596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status); 2606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 2626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Performing quick check on a string, to quickly determine if the string is 2636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * in a particular normalization format. 2646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is a wrapper for unorm_quickCheck(), using a UnicodeString. 2656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Three types of result can be returned UNORM_YES, UNORM_NO or 2676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * UNORM_MAYBE. Result UNORM_YES indicates that the argument 2686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * string is in the desired normalized format, UNORM_NO determines that 2696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * argument string is not in the desired normalized format. A 2706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * UNORM_MAYBE result indicates that a more thorough check is required, 2716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the user may have to put the string in its normalized form and compare the 2726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * results. 2736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param source string for determining if it is in a normalized format 2746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode normalization format 2756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status A reference to a UErrorCode to receive any errors 2766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return UNORM_YES, UNORM_NO or UNORM_MAYBE 2776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see isNormalized 2796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 2806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static inline UNormalizationCheckResult 2826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org quickCheck(const UnicodeString &source, UNormalizationMode mode, UErrorCode &status); 2836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 2846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 2856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Performing quick check on a string; same as the other version of quickCheck 2866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * but takes an extra options parameter like most normalization functions. 2876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param source string for determining if it is in a normalized format 2896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode normalization format 2906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options the optional features to be enabled (0 for no options) 2916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status A reference to a UErrorCode to receive any errors 2926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return UNORM_YES, UNORM_NO or UNORM_MAYBE 2936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 2946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see isNormalized 2956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.6 2966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 2976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static UNormalizationCheckResult 2986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org quickCheck(const UnicodeString &source, UNormalizationMode mode, int32_t options, UErrorCode &status); 2996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 3016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Test if a string is in a given normalization form. 3026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is semantically equivalent to source.equals(normalize(source, mode)) . 3036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Unlike unorm_quickCheck(), this function returns a definitive result, 3056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * never a "maybe". 3066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For NFD, NFKD, and FCD, both functions work exactly the same. 3076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For NFC and NFKC where quickCheck may return "maybe", this function will 3086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * perform further tests to arrive at a TRUE/FALSE result. 3096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param src String that is to be tested if it is in a normalization format. 3116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode Which normalization form to test for. 3126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param errorCode ICU error code in/out parameter. 3136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Must fulfill U_SUCCESS before the function call. 3146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return Boolean value indicating whether the source string is in the 3156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * "mode" normalization form. 3166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see quickCheck 3186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.2 3196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static inline UBool 3216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org isNormalized(const UnicodeString &src, UNormalizationMode mode, UErrorCode &errorCode); 3226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 3246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Test if a string is in a given normalization form; same as the other version of isNormalized 3256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * but takes an extra options parameter like most normalization functions. 3266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param src String that is to be tested if it is in a normalization format. 3286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode Which normalization form to test for. 3296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options the optional features to be enabled (0 for no options) 3306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param errorCode ICU error code in/out parameter. 3316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Must fulfill U_SUCCESS before the function call. 3326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return Boolean value indicating whether the source string is in the 3336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * "mode" normalization form. 3346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see quickCheck 3366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.6 3376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static UBool 3396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org isNormalized(const UnicodeString &src, UNormalizationMode mode, int32_t options, UErrorCode &errorCode); 3406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 3426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Concatenate normalized strings, making sure that the result is normalized as well. 3436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If both the left and the right strings are in 3456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the normalization form according to "mode/options", 3466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * then the result will be 3476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \code 3496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * dest=normalize(left+right, mode, options) 3506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * \endcode 3516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For details see unorm_concatenate in unorm.h. 3536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param left Left source string. 3556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param right Right source string. 3566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param result The output string. 3576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param mode The normalization mode. 3586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options A bit set of normalization options. 3596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param errorCode ICU error code in/out parameter. 3606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Must fulfill U_SUCCESS before the function call. 3616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return result 3626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see unorm_concatenate 3646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see normalize 3656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see unorm_next 3666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see unorm_previous 3676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.1 3696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 3706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static UnicodeString & 3716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org U_EXPORT2 concatenate(const UnicodeString &left, const UnicodeString &right, 3726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UnicodeString &result, 3736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UNormalizationMode mode, int32_t options, 3746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &errorCode); 3756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 3766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 3776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Compare two strings for canonical equivalence. 3786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Further options include case-insensitive comparison and 3796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * code point order (as opposed to code unit order). 3806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Canonical equivalence between two strings is defined as their normalized 3826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * forms (NFD or NFC) being identical. 3836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This function compares strings incrementally instead of normalizing 3846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (and optionally case-folding) both strings entirely, 3856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * improving performance significantly. 3866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Bulk normalization is only necessary if the strings do not fulfill the FCD 3886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * conditions. Only in this case, and only if the strings are relatively long, 3896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * is memory allocated temporarily. 3906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * For FCD strings and short non-FCD strings there is no memory allocation. 3916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Semantically, this is equivalent to 3936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * strcmp[CodePointOrder](NFD(foldCase(s1)), NFD(foldCase(s2))) 3946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * where code point order and foldCase are all optional. 3956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * UAX 21 2.5 Caseless Matching specifies that for a canonical caseless match 3976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the case folding must be performed first, then the normalization. 3986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 3996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param s1 First source string. 4006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param s2 Second source string. 4016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param options A bit set of options: 4036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - U_FOLD_CASE_DEFAULT or 0 is used for default options: 4046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Case-sensitive comparison in code unit order, and the input strings 4056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * are quick-checked for FCD. 4066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - UNORM_INPUT_IS_FCD 4086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set if the caller knows that both s1 and s2 fulfill the FCD conditions. 4096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If not set, the function will quickCheck for FCD 4106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * and normalize if necessary. 4116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - U_COMPARE_CODE_POINT_ORDER 4136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set to choose code point order instead of code unit order 4146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (see u_strCompare for details). 4156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - U_COMPARE_IGNORE_CASE 4176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set to compare strings case-insensitively using case folding, 4186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * instead of case-sensitively. 4196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If set, then the following case folding options are used. 4206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - Options as used with case-insensitive comparisons, currently: 4226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - U_FOLD_CASE_EXCLUDE_SPECIAL_I 4246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (see u_strCaseCompare for details) 4256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * - regular normalization options shifted left by UNORM_COMPARE_NORM_OPTIONS_SHIFT 4276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param errorCode ICU error code in/out parameter. 4296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Must fulfill U_SUCCESS before the function call. 4306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return <0 or 0 or >0 as usual for string comparisons 4316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see unorm_compare 4336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see normalize 4346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see UNORM_FCD 4356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see u_strCompare 4366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see u_strCaseCompare 4376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.2 4396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 4406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static inline int32_t 4416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org compare(const UnicodeString &s1, const UnicodeString &s2, 4426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint32_t options, 4436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &errorCode); 4446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 4466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Iteration API 4476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 4486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 4506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Return the current character in the normalized text. 4516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * current() may need to normalize some text at getIndex(). 4526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The getIndex() is not changed. 4536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the current normalized code point 4556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 4566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 4576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UChar32 current(void); 4586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 4606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Return the first character in the normalized text. 4616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is equivalent to setIndexOnly(startIndex()) followed by next(). 4626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (Post-increment semantics.) 4636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the first normalized code point 4656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 4666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 4676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UChar32 first(void); 4686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 4706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Return the last character in the normalized text. 4716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is equivalent to setIndexOnly(endIndex()) followed by previous(). 4726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (Pre-decrement semantics.) 4736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the last normalized code point 4756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 4766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 4776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UChar32 last(void); 4786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 4806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Return the next character in the normalized text. 4816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (Post-increment semantics.) 4826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If the end of the text has already been reached, DONE is returned. 4836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The DONE value could be confused with a U+FFFF non-character code point 4846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * in the text. If this is possible, you can test getIndex()<endIndex() 4856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * before calling next(), or (getIndex()<endIndex() || last()!=DONE) 4866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * after calling next(). (Calling last() will change the iterator state!) 4876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The C API unorm_next() is more efficient and does not have this ambiguity. 4896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 4906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the next normalized code point 4916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 4926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 4936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UChar32 next(void); 4946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 4956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 4966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Return the previous character in the normalized text and decrement. 4976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (Pre-decrement semantics.) 4986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If the beginning of the text has already been reached, DONE is returned. 4996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The DONE value could be confused with a U+FFFF non-character code point 5006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * in the text. If this is possible, you can test 5016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * (getIndex()>startIndex() || first()!=DONE). (Calling first() will change 5026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the iterator state!) 5036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The C API unorm_previous() is more efficient and does not have this ambiguity. 5056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the previous normalized code point 5076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UChar32 previous(void); 5106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set the iteration position in the input text that is being normalized, 5136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * without any immediate normalization. 5146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * After setIndexOnly(), getIndex() will return the same index that is 5156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * specified here. 5166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param index the desired index in the input text. 5186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void setIndexOnly(int32_t index); 5216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Reset the index to the beginning of the text. 5246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is equivalent to setIndexOnly(startIndex)). 5256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void reset(void); 5286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Retrieve the current iteration position in the input text that is 5316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * being normalized. 5326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * A following call to next() will return a normalized code point from 5346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * the input text at or after this index. 5356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * After a call to previous(), getIndex() will point at or before the 5376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * position in the input text where the normalized code point 5386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * was returned from with previous(). 5396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the current index in the input text 5416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t getIndex(void) const; 5446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Retrieve the index of the start of the input text. This is the begin index 5476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * of the <code>CharacterIterator</code> or the start (i.e. index 0) of the string 5486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * over which this <code>Normalizer</code> is iterating. 5496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the smallest index in the input text where the Normalizer operates 5516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t startIndex(void) const; 5546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Retrieve the index of the end of the input text. This is the end index 5576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * of the <code>CharacterIterator</code> or the length of the string 5586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * over which this <code>Normalizer</code> is iterating. 5596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This end index is exclusive, i.e., the Normalizer operates only on characters 5606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * before this index. 5616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the first index in the input text where the Normalizer does not operate 5636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t endIndex(void) const; 5666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Returns TRUE when both iterators refer to the same character in the same 5696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * input text. 5706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param that a Normalizer object to compare this one to 5726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return comparison result 5736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool operator==(const Normalizer& that) const; 5766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Returns FALSE when both iterators refer to the same character in the same 5796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * input text. 5806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param that a Normalizer object to compare this one to 5826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return comparison result 5836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org inline UBool operator!=(const Normalizer& that) const; 5866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Returns a pointer to a new Normalizer that is a clone of this one. 5896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The caller is responsible for deleting the new clone. 5906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return a pointer to a new Normalizer 5916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 5926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 5936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer* clone(void) const; 5946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 5956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 5966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Generates a hash code for this iterator. 5976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 5986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the hash code 5996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t hashCode(void) const; 6026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 6046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Property access methods 6056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 6066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set the normalization mode for this object. 6096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p> 6106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <b>Note:</b>If the normalization mode is changed while iterating 6116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * over a string, calls to {@link #next() } and {@link #previous() } may 6126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * return previously buffers characters in the old normalization mode 6136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * until the iteration is able to re-sync at the next base character. 6146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It is safest to call {@link #setIndexOnly }, {@link #reset() }, 6156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * {@link #setText }, {@link #first() }, 6166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * {@link #last() }, etc. after calling <code>setMode</code>. 6176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p> 6186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param newMode the new mode for this <code>Normalizer</code>. 6196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see #getUMode 6206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void setMode(UNormalizationMode newMode); 6236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Return the normalization mode for this object. 6266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * This is an unusual name because there used to be a getMode() that 6286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * returned a different type. 6296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return the mode for this <code>Normalizer</code> 6316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see #setMode 6326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UNormalizationMode getUMode(void) const; 6356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set options that affect this <code>Normalizer</code>'s operation. 6386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Options do not change the basic composition or decomposition operation 6396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * that is being performed, but they control whether 6406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * certain optional portions of the operation are done. 6416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Currently the only available option is obsolete. 6426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * It is possible to specify multiple options that are all turned on or off. 6446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param option the option(s) whose value is/are to be set. 6466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param value the new setting for the option. Use <code>TRUE</code> to 6476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * turn the option(s) on and <code>FALSE</code> to turn it/them off. 6486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see #getOption 6506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void setOption(int32_t option, 6536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool value); 6546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Determine whether an option is turned on or off. 6576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * If multiple options are specified, then the result is TRUE if any 6586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * of them are set. 6596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * <p> 6606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param option the option(s) that are to be checked 6616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return TRUE if any of the option(s) are set 6626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @see #setOption 6636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool getOption(int32_t option) const; 6666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set the input text over which this <code>Normalizer</code> will iterate. 6696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The iteration position is set to the beginning. 6706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param newText a string that replaces the current input text 6726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status a UErrorCode 6736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void setText(const UnicodeString& newText, 6766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status); 6776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set the input text over which this <code>Normalizer</code> will iterate. 6806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The iteration position is set to the beginning. 6816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param newText a CharacterIterator object that replaces the current input text 6836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status a UErrorCode 6846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void setText(const CharacterIterator& newText, 6876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status); 6886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 6896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 6906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Set the input text over which this <code>Normalizer</code> will iterate. 6916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * The iteration position is set to the beginning. 6926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 6936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param newText a string that replaces the current input text 6946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param length the length of the string, or -1 if NUL-terminated 6956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param status a UErrorCode 6966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 6976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 6986f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void setText(const UChar* newText, 6996f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t length, 7006f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status); 7016f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 7026f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * Copies the input text into the UnicodeString argument. 7036f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * 7046f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @param result Receives a copy of the text under iteration. 7056f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.0 7066f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 7076f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void getText(UnicodeString& result); 7086f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7096f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 7106f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * ICU "poor man's RTTI", returns a UClassID for this class. 7116f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @returns a UClassID for this class. 7126f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.2 7136f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 7146f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org static UClassID U_EXPORT2 getStaticClassID(); 7156f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7166f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org /** 7176f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * ICU "poor man's RTTI", returns a UClassID for the actual class. 7186f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @return a UClassID for the actual class. 7196f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org * @stable ICU 2.2 7206f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org */ 7216f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org virtual UClassID getDynamicClassID() const; 7226f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7236f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgprivate: 7246f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 7256f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Private functions 7266f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 7276f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7286f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer(); // default constructor not implemented 7296f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org Normalizer &operator=(const Normalizer &that); // assignment operator not implemented 7306f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7316f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Private utility methods for iteration 7326f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // For documentation, see the source code 7336f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool nextNormalize(); 7346f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UBool previousNormalize(); 7356f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7366f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void init(); 7376f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org void clearBuffer(void); 7386f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7396f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 7406f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // Private data 7416f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org //------------------------------------------------------------------------- 7426f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7436f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org FilteredNormalizer2*fFilteredNorm2; // owned if not NULL 7446f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org const Normalizer2 *fNorm2; // not owned; may be equal to fFilteredNorm2 7456f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UNormalizationMode fUMode; 7466f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t fOptions; 7476f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7486f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // The input text and our position in it 7496f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org CharacterIterator *text; 7506f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7516f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // The normalization buffer is the result of normalization 7526f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // of the source in [currentIndex..nextIndex[ . 7536f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t currentIndex, nextIndex; 7546f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7556f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // A buffer for holding intermediate results 7566f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UnicodeString buffer; 7576f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org int32_t bufferPos; 7586f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org}; 7596f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7606f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org//------------------------------------------------------------------------- 7616f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org// Inline implementations 7626f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org//------------------------------------------------------------------------- 7636f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7646f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orginline UBool 7656f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgNormalizer::operator!= (const Normalizer& other) const 7666f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org{ return ! operator==(other); } 7676f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7686f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orginline UNormalizationCheckResult 7696f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgNormalizer::quickCheck(const UnicodeString& source, 7706f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UNormalizationMode mode, 7716f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status) { 7726f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org return quickCheck(source, mode, 0, status); 7736f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org} 7746f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7756f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orginline UBool 7766f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgNormalizer::isNormalized(const UnicodeString& source, 7776f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UNormalizationMode mode, 7786f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &status) { 7796f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org return isNormalized(source, mode, 0, status); 7806f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org} 7816f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7826f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orginline int32_t 7836f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgNormalizer::compare(const UnicodeString &s1, const UnicodeString &s2, 7846f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org uint32_t options, 7856f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org UErrorCode &errorCode) { 7866f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org // all argument checking is done in unorm_compare 7876f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org return unorm_compare(s1.getBuffer(), s1.length(), 7886f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org s2.getBuffer(), s2.length(), 7896f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org options, 7906f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org &errorCode); 7916f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org} 7926f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7936f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.orgU_NAMESPACE_END 7946f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7956f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#endif /* #if !UCONFIG_NO_NORMALIZATION */ 7966f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org 7976f31ac30b9092fd02a8c97e5216cf53f3e4fae4jshin@chromium.org#endif // NORMLZR_H 798