summaryrefslogtreecommitdiffstats
path: root/intl/locale/nsILocaleService.idl
diff options
context:
space:
mode:
authorMatt A. Tobin <mattatobin@localhost.localdomain>2018-02-02 04:16:08 -0500
committerMatt A. Tobin <mattatobin@localhost.localdomain>2018-02-02 04:16:08 -0500
commit5f8de423f190bbb79a62f804151bc24824fa32d8 (patch)
tree10027f336435511475e392454359edea8e25895d /intl/locale/nsILocaleService.idl
parent49ee0794b5d912db1f95dce6eb52d781dc210db5 (diff)
downloadUXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.gz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.lz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.xz
UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.zip
Add m-esr52 at 52.6.0
Diffstat (limited to 'intl/locale/nsILocaleService.idl')
-rw-r--r--intl/locale/nsILocaleService.idl77
1 files changed, 77 insertions, 0 deletions
diff --git a/intl/locale/nsILocaleService.idl b/intl/locale/nsILocaleService.idl
new file mode 100644
index 000000000..477470a86
--- /dev/null
+++ b/intl/locale/nsILocaleService.idl
@@ -0,0 +1,77 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#include "nsISupports.idl"
+#include "nsILocale.idl"
+
+/**
+ * The Locale service interface. This is a singleton object, and should be
+ * obtained from the <tt>nsServiceManager</tt>.
+ */
+[scriptable, uuid(c2edc848-4219-4440-abbf-98119882c83f)]
+interface nsILocaleService : nsISupports
+{
+ /**
+ * Create a new nsILocale from a locale string.
+ *
+ * @param aLocale
+ * A locale code as described in nsILocale.
+ * @return A nsILocale representing the given locale.
+ */
+ nsILocale newLocale(in AString aLocale);
+
+ /**
+ * Get the user preference for locale from the operating system.
+ *
+ * @return User's OS setting for preferred locale.
+ */
+ nsILocale getSystemLocale();
+
+ /**
+ * Get the user preference for locale from the operating system.
+ *
+ * NOTE: This has nothing to do with the locale used for localization of
+ * the application (UI text strings etc.). This method returns something
+ * similar to getSystemLocale.
+ *
+ * @return User's OS setting for preferred locale.
+ */
+ nsILocale getApplicationLocale();
+
+ /**
+ * Get the most preferred locale from a list of locale preferences.
+ *
+ * @param acceptLanguage
+ * Locale preference in the same format as the Accept-Language HTTP
+ * header.
+ * @return The most preferred locale according to the acceptLanguage
+ * parameter.
+ */
+ nsILocale getLocaleFromAcceptLanguage(in string acceptLanguage);
+
+ /**
+ * Get the user preference for locale from the operating system.
+ *
+ * NOTE: This has nothing to do with any HTTP User-Agent. This method
+ * returns the same as getSystemLocale, but as a string.
+ *
+ * @return User's OS setting for preferred locale in the format described
+ * in nsILocale.
+ */
+ AString getLocaleComponentForUserAgent();
+};
+
+%{C++
+
+// {C8E518C1-47AE-11d3-91CD-00105AA3F7DC}
+#define NS_LOCALESERVICE_CID {0xc8e518c1,0x47ae,0x11d3,{0x91,0xcd,0x0,0x10,0x5a,0xa3,0xf7,0xdc}}
+#define NS_LOCALESERVICE_CONTRACTID "@mozilla.org/intl/nslocaleservice;1"
+
+extern nsresult
+NS_NewLocaleService(nsILocaleService** result);
+
+%}
+
+