Update ICU to 54.1 step 1

source/i18n/unicode/ucurr.h

 /*
 **********************************************************************
-* Copyright (c) 2002-2013, International Business Machines
+* Copyright (c) 2002-2014, International Business Machines
 * Corporation and others.  All Rights Reserved.
 **********************************************************************
 */
 #ifndef _UCURR_H_
 #define _UCURR_H_
 
 #include "unicode/utypes.h"
 #include "unicode/uenum.h"
 
 /**
  * \file 
  * \brief C API: Encapsulates information about a currency.
  */
 
 #if !UCONFIG_NO_FORMATTING
 
 /**
+ * Currency Usage used for Decimal Format
+ * @draft ICU 54
+ */
+enum UCurrencyUsage {
+#ifndef U_HIDE_DRAFT_API
+    /**
+     * a setting to specify currency usage which determines currency digit
+     * and rounding for standard usage, for example: "50.00 NT$"
+     * used as DEFAULT value
+     * @draft ICU 54
+     */
+    UCURR_USAGE_STANDARD=0,
+    /**
+     * a setting to specify currency usage which determines currency digit
+     * and rounding for cash usage, for example: "50 NT$"
+     * @draft ICU 54
+     */
+    UCURR_USAGE_CASH=1,
+#endif  /* U_HIDE_DRAFT_API */
+    /**
+     * One higher than the last enum UCurrencyUsage constant.
+     * @draft ICU 54
+     */
+    UCURR_USAGE_COUNT=2
+};
+typedef enum UCurrencyUsage UCurrencyUsage; 
+
+/**
  * The ucurr API encapsulates information about a currency, as defined by
  * ISO 4217.  A currency is represented by a 3-character string
  * containing its ISO 4217 code.  This API can return various data
  * necessary the proper display of a currency:
  *
  * <ul><li>A display symbol, for a specific locale
  * <li>The number of fraction digits to display
  * <li>A rounding increment
  * </ul>
  *
@@ skipping 127 matching lines @@
 ucurr_getPluralName(const UChar* currency,
                     const char* locale,
                     UBool* isChoiceFormat,
                     const char* pluralCount,
                     int32_t* len,
                     UErrorCode* ec);
 
 /**
  * Returns the number of the number of fraction digits that should
  * be displayed for the given currency.
+ * This is equivalent to ucurr_getDefaultFractionDigitsForUsage(currency,UCURR_USAGE_STANDARD,ec);
  * @param currency null-terminated 3-letter ISO 4217 code
  * @param ec input-output error code
  * @return a non-negative number of fraction digits to be
  * displayed, or 0 if there is an error
  * @stable ICU 3.0
  */
 U_STABLE int32_t U_EXPORT2
 ucurr_getDefaultFractionDigits(const UChar* currency,
                                UErrorCode* ec);
 
+#ifndef U_HIDE_DRAFT_API
+/**
+ * Returns the number of the number of fraction digits that should
+ * be displayed for the given currency with usage.
+ * @param currency null-terminated 3-letter ISO 4217 code
+ * @param usage enum usage for the currency
+ * @param ec input-output error code
+ * @return a non-negative number of fraction digits to be
+ * displayed, or 0 if there is an error
+ * @draft ICU 54
+ */
+U_DRAFT int32_t U_EXPORT2
+ucurr_getDefaultFractionDigitsForUsage(const UChar* currency, 
+                                       const UCurrencyUsage usage,
+                                       UErrorCode* ec);
+#endif  /* U_HIDE_DRAFT_API */
+
 /**
  * Returns the rounding increment for the given currency, or 0.0 if no
  * rounding is done by the currency.
+ * This is equivalent to ucurr_getRoundingIncrementForUsage(currency,UCURR_USAGE_STANDARD,ec);
  * @param currency null-terminated 3-letter ISO 4217 code
  * @param ec input-output error code
  * @return the non-negative rounding increment, or 0.0 if none,
  * or 0.0 if there is an error
  * @stable ICU 3.0
  */
 U_STABLE double U_EXPORT2
 ucurr_getRoundingIncrement(const UChar* currency,
                            UErrorCode* ec);
 
+#ifndef U_HIDE_DRAFT_API
+/**
+ * Returns the rounding increment for the given currency, or 0.0 if no
+ * rounding is done by the currency given usage.
+ * @param currency null-terminated 3-letter ISO 4217 code
+ * @param usage enum usage for the currency
+ * @param ec input-output error code
+ * @return the non-negative rounding increment, or 0.0 if none,
+ * or 0.0 if there is an error
+ * @draft ICU 54
+ */
+U_DRAFT double U_EXPORT2
+ucurr_getRoundingIncrementForUsage(const UChar* currency,
+                                   const UCurrencyUsage usage,
+                                   UErrorCode* ec);
+#endif  /* U_HIDE_DRAFT_API */
+
 /**
  * Selector constants for ucurr_openCurrencies().
  *
  * @see ucurr_openCurrencies
  * @stable ICU 3.2
  */
 typedef enum UCurrCurrencyType {
     /**
      * Select all ISO-4217 currency codes.
      * @stable ICU 3.2
@@ skipping 150 matching lines @@
  * @param currency null-terminated 3-letter ISO 4217 code
  * @return The ISO 4217 numeric code of the currency
  * @stable ICU 49
  */
 U_STABLE int32_t U_EXPORT2
 ucurr_getNumericCode(const UChar* currency);
 
 #endif /* #if !UCONFIG_NO_FORMATTING */
 
 #endif