michael@0: /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "nsISupports.idl"
michael@0: 
michael@0: %{C++
michael@0: #define NS_UNICODE_NORMALIZER_CID { 0xa665e49a, 0xf3e6, 0x4fed, { 0x9f, 0x31, 0xf7, 0xc5, 0x68, 0xa2, 0x98, 0x99 } }
michael@0: #define NS_UNICODE_NORMALIZER_CONTRACTID "@mozilla.org/intl/unicodenormalizer;1"
michael@0: %}
michael@0: 
michael@0: [scriptable, uuid(B43A461F-1BCF-4329-820B-66E48C979E14)]
michael@0: interface nsIUnicodeNormalizer : nsISupports
michael@0: {
michael@0:  /**
michael@0:  * Normalize Unicode (NFD, NFC, NFKD, NFKC).
michael@0:  *
michael@0:  * NFD: Canonical Decomposition
michael@0:  * NFC: Canonical Decomposition, followed by Canonical Composition
michael@0:  * NFKD: Compatibility Decomposition
michael@0:  * NFKC: Compatibility Decomposition, followed by Canonical Composition
michael@0:  * Reference: Unicode Standard, TR15, Unicode Normalization Forms
michael@0:  *
michael@0:  * @param aSrc         [IN]  nsAString which contains an input UTF-16 string.
michael@0:  * @param aDest        [OUT] A pointer to an output buffer provided by a callee.
michael@0:  * @return             NS_OK for success, 
michael@0:  */
michael@0:   void NormalizeUnicodeNFD(in AString aSrc, out AString aDest);
michael@0:   void NormalizeUnicodeNFC(in AString aSrc, out AString aDest);
michael@0:   void NormalizeUnicodeNFKD(in AString aSrc, out AString aDest);
michael@0:   void NormalizeUnicodeNFKC(in AString aSrc, out AString aDest);
michael@0: };