intl/uconv/nsTextToSubURI.h

   1 /* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this
   4  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   5 #ifndef nsTextToSubURI_h__
   6 #define nsTextToSubURI_h__
   7
   8 #include "nsITextToSubURI.h"
   9 #include "nsString.h"
  10
  11 //==============================================================
  12 class nsTextToSubURI: public nsITextToSubURI {
  13   NS_DECL_ISUPPORTS
  14   NS_DECL_NSITEXTTOSUBURI
  15
  16 public:
  17   nsTextToSubURI();
  18
  19 private:
  20   virtual ~nsTextToSubURI();
  21
  22   // IRI is "Internationalized Resource Identifiers"
  23   // http://www.ietf.org/internet-drafts/draft-duerst-iri-01.txt
  24   //
  25   // if the IRI option is true then we assume that the URI is encoded as UTF-8
  26   // note: there is no definite way to distinguish between IRI and a URI encoded
  27   // with a non-UTF-8 charset
  28   // Use this option carefully -- it may cause dataloss
  29   // (recommended to set to true for UI purpose only)
  30   //
  31   nsresult convertURItoUnicode(const nsAFlatCString &aCharset,
  32                                const nsAFlatCString &aURI,
  33                                bool aIRI,
  34                                nsAString &_retval);
  35 };
  36
  37 #endif // nsTextToSubURI_h__
  38