ICU-551.24.tar.gz

[apple/icu.git] / icuSources / i18n / unicode / uldnames.h

diff --git a/icuSources/i18n/unicode/uldnames.h b/icuSources/i18n/unicode/uldnames.h
index 4a119ea2653b89f2b2288bd06c168406dcbf454c..b0a2bb0fc89ffb6c9e54c333cec2a2c29f5e882c 100644 (file)
--- a/icuSources/i18n/unicode/uldnames.h
+++ b/icuSources/i18n/unicode/uldnames.h
@@ -1,6 +1,6 @@
 /*
 *******************************************************************************
 /*
 *******************************************************************************

-*   Copyright (C) 2010, International Business Machines Corporation and       * 
+*   Copyright (C) 2010-2014, International Business Machines Corporation and       * 

 *   others.  All Rights Reserved.                                             *
 *******************************************************************************
 */
 *   others.  All Rights Reserved.                                             *
 *******************************************************************************
 */


@@ -10,12 +10,13 @@
 
 /**
  * \file
 
 /**
  * \file

- * \brief C++ API: Provides display names of Locale ids and their components.
+ * \brief C API: Provides display names of Locale ids and their components.

  */
 
 #include "unicode/utypes.h"
 #include "unicode/localpointer.h"
 #include "unicode/uscript.h"
  */
 
 #include "unicode/utypes.h"
 #include "unicode/localpointer.h"
 #include "unicode/uscript.h"

+#include "unicode/udisplaycontext.h"

 
 /**
  * Enum used in LocaleDisplayNames::createInstance.
 
 /**
  * Enum used in LocaleDisplayNames::createInstance.


@@ -265,6 +266,37 @@ uldn_keyValueDisplayName(const ULocaleDisplayNames *ldn,
                          int32_t maxResultSize,
                          UErrorCode *pErrorCode);
 
                          int32_t maxResultSize,
                          UErrorCode *pErrorCode);
 

+/**
+* Returns an instance of LocaleDisplayNames that returns names formatted
+* for the provided locale, using the provided UDisplayContext settings.
+*
+* @param locale The display locale 
+* @param contexts List of one or more context settings (e.g. for dialect
+*               handling, capitalization, etc.
+* @param length Number of items in the contexts list
+* @param pErrorCode Pointer to UErrorCode input/output status. If at entry this indicates
+*               a failure status, the function will do nothing; otherwise this will be
+*               updated with any new status from the function. 
+* @return a ULocaleDisplayNames instance 
+* @stable ICU 51
+*/
+U_STABLE ULocaleDisplayNames * U_EXPORT2
+uldn_openForContext(const char * locale, UDisplayContext *contexts,
+                    int32_t length, UErrorCode *pErrorCode);
+
+/**
+* Returns the UDisplayContext value for the specified UDisplayContextType.
+* @param ldn the ULocaleDisplayNames instance
+* @param type the UDisplayContextType whose value to return
+* @param pErrorCode Pointer to UErrorCode input/output status. If at entry this indicates
+*               a failure status, the function will do nothing; otherwise this will be
+*               updated with any new status from the function. 
+* @return the UDisplayContextValue for the specified type.
+* @stable ICU 51
+*/
+U_STABLE UDisplayContext U_EXPORT2
+uldn_getContext(const ULocaleDisplayNames *ldn, UDisplayContextType type,
+                UErrorCode *pErrorCode);

 
 #endif  /* !UCONFIG_NO_FORMATTING */
 #endif  /* __ULDNAMES_H__ */
 
 #endif  /* !UCONFIG_NO_FORMATTING */
 #endif  /* __ULDNAMES_H__ */