ICU 76.1: common/unicode/ucurr.h Source File

ICU 76.1 76.1

ucurr.h
Go to the documentation of this file.
1// © 2016 and later: Unicode, Inc. and others.
2// License & terms of use: http://www.unicode.org/copyright.html
3/*
4**********************************************************************
5* Copyright (c) 2002-2016, International Business Machines
6* Corporation and others. All Rights Reserved.
7**********************************************************************
8*/
9#ifndef _UCURR_H_
10#define _UCURR_H_
11
12#include "unicode/utypes.h"
13#include "unicode/uenum.h"
14
35#if !UCONFIG_NO_FORMATTING
36
41 enum UCurrencyUsage {
48 UCURR_USAGE_STANDARD=0,
54 UCURR_USAGE_CASH=1,
55#ifndef U_HIDE_DEPRECATED_API
60 UCURR_USAGE_COUNT=2
61#endif // U_HIDE_DEPRECATED_API
62};
64 typedef enum UCurrencyUsage UCurrencyUsage;
65
81 U_CAPI int32_t U_EXPORT2
82ucurr_forLocale(const char* locale,
83 UChar* buff,
84 int32_t buffCapacity,
85 UErrorCode* ec);
86
93 typedef enum UCurrNameStyle {
99 UCURR_SYMBOL_NAME,
100
106 UCURR_LONG_NAME,
107
116 UCURR_NARROW_SYMBOL_NAME,
117
126 UCURR_FORMAL_SYMBOL_NAME,
127
135 UCURR_VARIANT_SYMBOL_NAME
136
137} UCurrNameStyle;
138
139#if !UCONFIG_NO_SERVICE
143 typedef const void* UCurrRegistryKey;
144
156 U_CAPI UCurrRegistryKey U_EXPORT2
157ucurr_register(const UChar* isoCode,
158 const char* locale,
159 UErrorCode* status);
171 U_CAPI UBool U_EXPORT2
172ucurr_unregister(UCurrRegistryKey key, UErrorCode* status);
173#endif /* UCONFIG_NO_SERVICE */
174
192 U_CAPI const UChar* U_EXPORT2
193ucurr_getName(const UChar* currency,
194 const char* locale,
195 UCurrNameStyle nameStyle,
196 UBool* isChoiceFormat,
197 int32_t* len,
198 UErrorCode* ec);
199
217 U_CAPI const UChar* U_EXPORT2
218ucurr_getPluralName(const UChar* currency,
219 const char* locale,
220 UBool* isChoiceFormat,
221 const char* pluralCount,
222 int32_t* len,
223 UErrorCode* ec);
224
242 U_CAPI int32_t U_EXPORT2
243ucurr_getDefaultFractionDigits(const UChar* currency,
244 UErrorCode* ec);
245
263 U_CAPI int32_t U_EXPORT2
264ucurr_getDefaultFractionDigitsForUsage(const UChar* currency,
265 const UCurrencyUsage usage,
266 UErrorCode* ec);
267
278 U_CAPI double U_EXPORT2
279ucurr_getRoundingIncrement(const UChar* currency,
280 UErrorCode* ec);
281
292 U_CAPI double U_EXPORT2
293ucurr_getRoundingIncrementForUsage(const UChar* currency,
294 const UCurrencyUsage usage,
295 UErrorCode* ec);
296
303 typedef enum UCurrCurrencyType {
308 UCURR_ALL = INT32_MAX,
317 UCURR_COMMON = 1,
325 UCURR_UNCOMMON = 2,
331 UCURR_DEPRECATED = 4,
337 UCURR_NON_DEPRECATED = 8
338} UCurrCurrencyType;
339
349 U_CAPI UEnumeration * U_EXPORT2
350ucurr_openISOCurrencies(uint32_t currType, UErrorCode *pErrorCode);
351
378 U_CAPI UBool U_EXPORT2
379ucurr_isAvailable(const UChar* isoCode,
380 UDate from,
381 UDate to,
382 UErrorCode* errorCode);
383
398 U_CAPI int32_t U_EXPORT2
399ucurr_countCurrencies(const char* locale,
400 UDate date,
401 UErrorCode* ec);
402
422 U_CAPI int32_t U_EXPORT2
423ucurr_forLocaleAndDate(const char* locale,
424 UDate date,
425 int32_t index,
426 UChar* buff,
427 int32_t buffCapacity,
428 UErrorCode* ec);
429
446 U_CAPI UEnumeration* U_EXPORT2
447ucurr_getKeywordValuesForLocale(const char* key,
448 const char* locale,
449 UBool commonlyUsed,
450 UErrorCode* status);
451
461 U_CAPI int32_t U_EXPORT2
462ucurr_getNumericCode(const UChar* currency);
463
464#endif /* #if !UCONFIG_NO_FORMATTING */
465
466#endif
ucurr_getName
U_CAPI const UChar * ucurr_getName(const UChar *currency, const char *locale, UCurrNameStyle nameStyle, UBool *isChoiceFormat, int32_t *len, UErrorCode *ec)
Returns the display name for the given currency in the given locale.
ucurr_forLocaleAndDate
U_CAPI int32_t ucurr_forLocaleAndDate(const char *locale, UDate date, int32_t index, UChar *buff, int32_t buffCapacity, UErrorCode *ec)
Finds a currency code for the given locale and date.
UCurrCurrencyType
UCurrCurrencyType
Selector constants for ucurr_openCurrencies().
Definition ucurr.h:303
UCURR_UNCOMMON
@ UCURR_UNCOMMON
Select ISO-4217 uncommon currency codes.
Definition ucurr.h:325
UCURR_NON_DEPRECATED
@ UCURR_NON_DEPRECATED
Select only non-deprecated ISO-4217 codes.
Definition ucurr.h:337
UCURR_ALL
@ UCURR_ALL
Select all ISO-4217 currency codes.
Definition ucurr.h:308
UCURR_DEPRECATED
@ UCURR_DEPRECATED
Select only deprecated ISO-4217 codes.
Definition ucurr.h:331
UCURR_COMMON
@ UCURR_COMMON
Select only ISO-4217 commonly used currency codes.
Definition ucurr.h:317
UCurrRegistryKey
const void * UCurrRegistryKey
Definition ucurr.h:143
ucurr_register
U_CAPI UCurrRegistryKey ucurr_register(const UChar *isoCode, const char *locale, UErrorCode *status)
Register an (existing) ISO 4217 currency code for the given locale.
ucurr_getRoundingIncrementForUsage
U_CAPI double ucurr_getRoundingIncrementForUsage(const UChar *currency, const UCurrencyUsage usage, UErrorCode *ec)
Returns the rounding increment for the given currency, or 0.0 if no rounding is done by the currency ...
ucurr_getRoundingIncrement
U_CAPI double ucurr_getRoundingIncrement(const UChar *currency, UErrorCode *ec)
Returns the rounding increment for the given currency, or 0.0 if no rounding is done by the currency.
ucurr_getNumericCode
U_CAPI int32_t ucurr_getNumericCode(const UChar *currency)
Returns the ISO 4217 numeric code for the currency.
ucurr_getPluralName
U_CAPI const UChar * ucurr_getPluralName(const UChar *currency, const char *locale, UBool *isChoiceFormat, const char *pluralCount, int32_t *len, UErrorCode *ec)
Returns the plural name for the given currency in the given locale.
ucurr_openISOCurrencies
U_CAPI UEnumeration * ucurr_openISOCurrencies(uint32_t currType, UErrorCode *pErrorCode)
Provides a UEnumeration object for listing ISO-4217 codes.
ucurr_getKeywordValuesForLocale
U_CAPI UEnumeration * ucurr_getKeywordValuesForLocale(const char *key, const char *locale, UBool commonlyUsed, UErrorCode *status)
Given a key and a locale, returns an array of string values in a preferred order that would make a di...
ucurr_getDefaultFractionDigitsForUsage
U_CAPI int32_t ucurr_getDefaultFractionDigitsForUsage(const UChar *currency, const UCurrencyUsage usage, UErrorCode *ec)
Returns the number of the number of fraction digits that should be displayed for the given currency w...
UCurrNameStyle
UCurrNameStyle
Selector constants for ucurr_getName().
Definition ucurr.h:93
UCURR_FORMAL_SYMBOL_NAME
@ UCURR_FORMAL_SYMBOL_NAME
Selector for getName() indicating the formal currency symbol.
Definition ucurr.h:126
UCURR_VARIANT_SYMBOL_NAME
@ UCURR_VARIANT_SYMBOL_NAME
Selector for getName() indicating the variant currency symbol.
Definition ucurr.h:135
UCURR_SYMBOL_NAME
@ UCURR_SYMBOL_NAME
Selector for ucurr_getName indicating a symbolic name for a currency, such as "$" for USD.
Definition ucurr.h:99
UCURR_NARROW_SYMBOL_NAME
@ UCURR_NARROW_SYMBOL_NAME
Selector for getName() indicating the narrow currency symbol.
Definition ucurr.h:116
UCURR_LONG_NAME
@ UCURR_LONG_NAME
Selector for ucurr_getName indicating the long name for a currency, such as "US Dollar" for USD.
Definition ucurr.h:106
ucurr_getDefaultFractionDigits
U_CAPI int32_t ucurr_getDefaultFractionDigits(const UChar *currency, UErrorCode *ec)
Returns the number of the number of fraction digits that should be displayed for the given currency.
ucurr_forLocale
U_CAPI int32_t ucurr_forLocale(const char *locale, UChar *buff, int32_t buffCapacity, UErrorCode *ec)
Finds a currency code for the given locale.
ucurr_countCurrencies
U_CAPI int32_t ucurr_countCurrencies(const char *locale, UDate date, UErrorCode *ec)
Finds the number of valid currency codes for the given locale and date.
ucurr_isAvailable
U_CAPI UBool ucurr_isAvailable(const UChar *isoCode, UDate from, UDate to, UErrorCode *errorCode)
Queries if the given ISO 4217 3-letter code is available on the specified date range.
ucurr_unregister
U_CAPI UBool ucurr_unregister(UCurrRegistryKey key, UErrorCode *status)
Unregister the previously-registered currency definitions using the URegistryKey returned from ucurr_...
UCurrencyUsage
UCurrencyUsage
Currency Usage used for Decimal Format.
Definition ucurr.h:41
UCURR_USAGE_COUNT
@ UCURR_USAGE_COUNT
One higher than the last enum UCurrencyUsage constant.
Definition ucurr.h:60
UCURR_USAGE_STANDARD
@ UCURR_USAGE_STANDARD
a setting to specify currency usage which determines currency digit and rounding for standard usage,...
Definition ucurr.h:48
UCURR_USAGE_CASH
@ UCURR_USAGE_CASH
a setting to specify currency usage which determines currency digit and rounding for cash usage,...
Definition ucurr.h:54
uenum.h
C API: String Enumeration.
UEnumeration
struct UEnumeration UEnumeration
structure representing an enumeration object instance
Definition uenum.h:44
UChar
char16_t UChar
The base type for UTF-16 code units and pointers.
Definition umachine.h:378
INT32_MAX
#define INT32_MAX
The largest value a 32 bit signed integer can hold.
Definition umachine.h:186
UBool
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition umachine.h:247
U_CAPI
#define U_CAPI
This is used to declare a function as a public ICU C API.
Definition umachine.h:110
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition utypes.h:430
UDate
double UDate
Date and Time data type.
Definition utypes.h:218