unum.h

Go to the documentation of this file.

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
* Copyright (C) 1997-2015, International Business Machines Corporation and others.
* All Rights Reserved.
* Modification History:
*
*   Date        Name        Description
*   06/24/99    helena      Integrated Alan's NF enhancements and Java2 bug fixes
*******************************************************************************
*/
 
#ifndef _UNUM
#define _UNUM
 
#include "unicode/utypes.h"
 
#if !UCONFIG_NO_FORMATTING
 
#include "unicode/uloc.h"
#include "unicode/ucurr.h"
#include "unicode/umisc.h"
#include "unicode/parseerr.h"
#include "unicode/uformattable.h"
#include "unicode/udisplaycontext.h"
#include "unicode/ufieldpositer.h"
 
#if U_SHOW_CPLUSPLUS_API
#include "unicode/localpointer.h"
#endif   // U_SHOW_CPLUSPLUS_API
 
typedef void* UNumberFormat;
 
typedef enum UNumberFormatStyle {
    UNUM_PATTERN_DECIMAL=0,
    UNUM_DECIMAL=1,
    UNUM_CURRENCY=2,
    UNUM_PERCENT=3,
    UNUM_SCIENTIFIC=4,
    UNUM_SPELLOUT=5,
    UNUM_ORDINAL=6,
    UNUM_DURATION=7,
    UNUM_NUMBERING_SYSTEM=8,
    UNUM_PATTERN_RULEBASED=9,
    UNUM_CURRENCY_ISO=10,
    UNUM_CURRENCY_PLURAL=11,
    UNUM_CURRENCY_ACCOUNTING=12,
    UNUM_CASH_CURRENCY=13,
    UNUM_DECIMAL_COMPACT_SHORT=14,
    UNUM_DECIMAL_COMPACT_LONG=15,
    UNUM_CURRENCY_STANDARD=16,
 
#ifndef U_HIDE_DEPRECATED_API
    UNUM_FORMAT_STYLE_COUNT=17,
#endif  /* U_HIDE_DEPRECATED_API */
 
    UNUM_DEFAULT = UNUM_DECIMAL,
    UNUM_IGNORE = UNUM_PATTERN_DECIMAL
} UNumberFormatStyle;
 
typedef enum UNumberFormatRoundingMode {
    UNUM_ROUND_CEILING,
    UNUM_ROUND_FLOOR,
    UNUM_ROUND_DOWN,
    UNUM_ROUND_UP,
    UNUM_ROUND_HALFEVEN,
#ifndef U_HIDE_DEPRECATED_API
    UNUM_FOUND_HALFEVEN = UNUM_ROUND_HALFEVEN,
#endif  /* U_HIDE_DEPRECATED_API */
    UNUM_ROUND_HALFDOWN = UNUM_ROUND_HALFEVEN + 1,
    UNUM_ROUND_HALFUP,
    UNUM_ROUND_UNNECESSARY,
    UNUM_ROUND_HALF_ODD,
    UNUM_ROUND_HALF_CEILING,
    UNUM_ROUND_HALF_FLOOR,
} UNumberFormatRoundingMode;
 
typedef enum UNumberFormatPadPosition {
    UNUM_PAD_BEFORE_PREFIX,
    UNUM_PAD_AFTER_PREFIX,
    UNUM_PAD_BEFORE_SUFFIX,
    UNUM_PAD_AFTER_SUFFIX
} UNumberFormatPadPosition;
 
typedef enum UNumberCompactStyle {
  UNUM_SHORT,
  UNUM_LONG
} UNumberCompactStyle;
 
enum UCurrencySpacing {
    UNUM_CURRENCY_MATCH,
    UNUM_CURRENCY_SURROUNDING_MATCH,
    UNUM_CURRENCY_INSERT,
 
    /* Do not conditionalize the following with #ifndef U_HIDE_DEPRECATED_API,
     * it is needed for layout of DecimalFormatSymbols object. */
#ifndef U_FORCE_HIDE_DEPRECATED_API
    UNUM_CURRENCY_SPACING_COUNT
#endif  // U_FORCE_HIDE_DEPRECATED_API
};
typedef enum UCurrencySpacing UCurrencySpacing; 
typedef enum UNumberFormatFields {
    UNUM_INTEGER_FIELD,
    UNUM_FRACTION_FIELD,
    UNUM_DECIMAL_SEPARATOR_FIELD,
    UNUM_EXPONENT_SYMBOL_FIELD,
    UNUM_EXPONENT_SIGN_FIELD,
    UNUM_EXPONENT_FIELD,
    UNUM_GROUPING_SEPARATOR_FIELD,
    UNUM_CURRENCY_FIELD,
    UNUM_PERCENT_FIELD,
    UNUM_PERMILL_FIELD,
    UNUM_SIGN_FIELD,
    UNUM_MEASURE_UNIT_FIELD,
    UNUM_COMPACT_FIELD,
#ifndef U_HIDE_DRAFT_API
    UNUM_APPROXIMATELY_SIGN_FIELD,
#endif // U_HIDE_DRAFT_API
 
#ifndef U_HIDE_DEPRECATED_API
#ifndef U_HIDE_DRAFT_API
    UNUM_FIELD_COUNT = UNUM_COMPACT_FIELD + 2
#else  // U_HIDE_DRAFT_API (for UNUM_APPROXIMATELY_SIGN_FIELD)
    UNUM_FIELD_COUNT = UNUM_COMPACT_FIELD + 1
#endif  // U_HIDE_DRAFT_API (for UNUM_APPROXIMATELY_SIGN_FIELD)
#endif  /* U_HIDE_DEPRECATED_API */
} UNumberFormatFields;
 
 
typedef enum UNumberFormatMinimumGroupingDigits {
    UNUM_MINIMUM_GROUPING_DIGITS_AUTO = -2,
    UNUM_MINIMUM_GROUPING_DIGITS_MIN2 = -3,
} UNumberFormatMinimumGroupingDigits;
 
U_CAPI UNumberFormat* U_EXPORT2 
unum_open(  UNumberFormatStyle    style,
            const    UChar*    pattern,
            int32_t            patternLength,
            const    char*     locale,
            UParseError*       parseErr,
            UErrorCode*        status);
 
 
U_CAPI void U_EXPORT2 
unum_close(UNumberFormat* fmt);
 
#if U_SHOW_CPLUSPLUS_API
 
U_NAMESPACE_BEGIN
 
U_DEFINE_LOCAL_OPEN_POINTER(LocalUNumberFormatPointer, UNumberFormat, unum_close);
 
U_NAMESPACE_END
 
#endif
 
U_CAPI UNumberFormat* U_EXPORT2 
unum_clone(const UNumberFormat *fmt,
       UErrorCode *status);
 
U_CAPI int32_t U_EXPORT2 
unum_format(    const    UNumberFormat*    fmt,
        int32_t            number,
        UChar*            result,
        int32_t            resultLength,
        UFieldPosition    *pos,
        UErrorCode*        status);
 
U_CAPI int32_t U_EXPORT2 
unum_formatInt64(const UNumberFormat *fmt,
        int64_t         number,
        UChar*          result,
        int32_t         resultLength,
        UFieldPosition *pos,
        UErrorCode*     status);
 
U_CAPI int32_t U_EXPORT2 
unum_formatDouble(    const    UNumberFormat*  fmt,
            double          number,
            UChar*          result,
            int32_t         resultLength,
            UFieldPosition  *pos, /* 0 if ignore */
            UErrorCode*     status);
 
U_CAPI int32_t U_EXPORT2
unum_formatDoubleForFields(const UNumberFormat* format,
                           double number,
                           UChar* result,
                           int32_t resultLength,
                           UFieldPositionIterator* fpositer,
                           UErrorCode* status);
 
 
U_CAPI int32_t U_EXPORT2 
unum_formatDecimal(    const    UNumberFormat*  fmt,
            const char *    number,
            int32_t         length,
            UChar*          result,
            int32_t         resultLength,
            UFieldPosition  *pos, /* 0 if ignore */
            UErrorCode*     status);
 
U_CAPI int32_t U_EXPORT2
unum_formatDoubleCurrency(const UNumberFormat* fmt,
                          double number,
                          UChar* currency,
                          UChar* result,
                          int32_t resultLength,
                          UFieldPosition* pos,
                          UErrorCode* status);
 
U_CAPI int32_t U_EXPORT2
unum_formatUFormattable(const UNumberFormat* fmt,
                        const UFormattable *number,
                        UChar *result,
                        int32_t resultLength,
                        UFieldPosition *pos,
                        UErrorCode *status);
 
U_CAPI int32_t U_EXPORT2 
unum_parse(    const   UNumberFormat*  fmt,
        const   UChar*          text,
        int32_t         textLength,
        int32_t         *parsePos /* 0 = start */,
        UErrorCode      *status);
 
U_CAPI int64_t U_EXPORT2 
unum_parseInt64(const UNumberFormat*  fmt,
        const UChar*  text,
        int32_t       textLength,
        int32_t       *parsePos /* 0 = start */,
        UErrorCode    *status);
 
U_CAPI double U_EXPORT2 
unum_parseDouble(    const   UNumberFormat*  fmt,
            const   UChar*          text,
            int32_t         textLength,
            int32_t         *parsePos /* 0 = start */,
            UErrorCode      *status);
 
 
U_CAPI int32_t U_EXPORT2 
unum_parseDecimal(const   UNumberFormat*  fmt,
                 const   UChar*          text,
                         int32_t         textLength,
                         int32_t         *parsePos /* 0 = start */,
                         char            *outBuf,
                         int32_t         outBufLength,
                         UErrorCode      *status);
 
U_CAPI double U_EXPORT2
unum_parseDoubleCurrency(const UNumberFormat* fmt,
                         const UChar* text,
                         int32_t textLength,
                         int32_t* parsePos, /* 0 = start */
                         UChar* currency,
                         UErrorCode* status);
 
U_CAPI UFormattable* U_EXPORT2
unum_parseToUFormattable(const UNumberFormat* fmt,
                         UFormattable *result,
                         const UChar* text,
                         int32_t textLength,
                         int32_t* parsePos, /* 0 = start */
                         UErrorCode* status);
 
U_CAPI void U_EXPORT2 
unum_applyPattern(          UNumberFormat  *format,
                            UBool          localized,
                    const   UChar          *pattern,
                            int32_t         patternLength,
                            UParseError    *parseError,
                            UErrorCode     *status
                                    );
 
U_CAPI const char* U_EXPORT2 
unum_getAvailable(int32_t localeIndex);
 
U_CAPI int32_t U_EXPORT2 
unum_countAvailable(void);
 
#if UCONFIG_HAVE_PARSEALLINPUT
/* The UNumberFormatAttributeValue type cannot be #ifndef U_HIDE_INTERNAL_API, needed for .h variable declaration */
typedef enum UNumberFormatAttributeValue {
#ifndef U_HIDE_INTERNAL_API
  UNUM_NO = 0,
  UNUM_YES = 1,
  UNUM_MAYBE = 2
#else
  UNUM_FORMAT_ATTRIBUTE_VALUE_HIDDEN
#endif /* U_HIDE_INTERNAL_API */
} UNumberFormatAttributeValue;
#endif
 
typedef enum UNumberFormatAttribute {
  UNUM_PARSE_INT_ONLY,
  UNUM_GROUPING_USED,
  UNUM_DECIMAL_ALWAYS_SHOWN,
  UNUM_MAX_INTEGER_DIGITS,
  UNUM_MIN_INTEGER_DIGITS,
  UNUM_INTEGER_DIGITS,
  UNUM_MAX_FRACTION_DIGITS,
  UNUM_MIN_FRACTION_DIGITS,
  UNUM_FRACTION_DIGITS,
  UNUM_MULTIPLIER,
  UNUM_GROUPING_SIZE,
  UNUM_ROUNDING_MODE,
  UNUM_ROUNDING_INCREMENT,
  UNUM_FORMAT_WIDTH,
  UNUM_PADDING_POSITION,
  UNUM_SECONDARY_GROUPING_SIZE,
  UNUM_SIGNIFICANT_DIGITS_USED,
  UNUM_MIN_SIGNIFICANT_DIGITS,
  UNUM_MAX_SIGNIFICANT_DIGITS,
  UNUM_LENIENT_PARSE,
#if UCONFIG_HAVE_PARSEALLINPUT
  UNUM_PARSE_ALL_INPUT = 20,
#endif
  UNUM_SCALE = 21,
 
  UNUM_MINIMUM_GROUPING_DIGITS = 22,
 
  UNUM_CURRENCY_USAGE = 23,
 
#ifndef U_HIDE_INTERNAL_API
  UNUM_MAX_NONBOOLEAN_ATTRIBUTE = 0x0FFF,
#endif /* U_HIDE_INTERNAL_API */
 
  UNUM_FORMAT_FAIL_IF_MORE_THAN_MAX_DIGITS = 0x1000,
  UNUM_PARSE_NO_EXPONENT = 0x1001,
 
  UNUM_PARSE_DECIMAL_MARK_REQUIRED = 0x1002,
 
  UNUM_PARSE_CASE_SENSITIVE = 0x1003,
 
  UNUM_SIGN_ALWAYS_SHOWN = 0x1004,
 
#ifndef U_HIDE_INTERNAL_API
  UNUM_LIMIT_BOOLEAN_ATTRIBUTE = 0x1005,
#endif /* U_HIDE_INTERNAL_API */
 
} UNumberFormatAttribute;
 
#ifndef U_HIDE_DRAFT_API
U_CAPI bool U_EXPORT2
unum_hasAttribute(const UNumberFormat*          fmt,
          UNumberFormatAttribute  attr);
#endif // U_HIDE_DRAFT_API
 
U_CAPI int32_t U_EXPORT2 
unum_getAttribute(const UNumberFormat*          fmt,
          UNumberFormatAttribute  attr);
 
U_CAPI void U_EXPORT2 
unum_setAttribute(    UNumberFormat*          fmt,
            UNumberFormatAttribute  attr,
            int32_t                 newValue);
 
 
U_CAPI double U_EXPORT2 
unum_getDoubleAttribute(const UNumberFormat*          fmt,
          UNumberFormatAttribute  attr);
 
U_CAPI void U_EXPORT2 
unum_setDoubleAttribute(    UNumberFormat*          fmt,
            UNumberFormatAttribute  attr,
            double                 newValue);
 
typedef enum UNumberFormatTextAttribute {
  UNUM_POSITIVE_PREFIX,
  UNUM_POSITIVE_SUFFIX,
  UNUM_NEGATIVE_PREFIX,
  UNUM_NEGATIVE_SUFFIX,
  UNUM_PADDING_CHARACTER,
  UNUM_CURRENCY_CODE,
  UNUM_DEFAULT_RULESET,
  UNUM_PUBLIC_RULESETS
} UNumberFormatTextAttribute;
 
U_CAPI int32_t U_EXPORT2 
unum_getTextAttribute(    const    UNumberFormat*                    fmt,
            UNumberFormatTextAttribute      tag,
            UChar*                            result,
            int32_t                            resultLength,
            UErrorCode*                        status);
 
U_CAPI void U_EXPORT2 
unum_setTextAttribute(    UNumberFormat*                    fmt,
            UNumberFormatTextAttribute      tag,
            const    UChar*                            newValue,
            int32_t                            newValueLength,
            UErrorCode                        *status);
 
U_CAPI int32_t U_EXPORT2 
unum_toPattern(    const    UNumberFormat*          fmt,
        UBool                  isPatternLocalized,
        UChar*                  result,
        int32_t                 resultLength,
        UErrorCode*             status);
 
 
typedef enum UNumberFormatSymbol {
  UNUM_DECIMAL_SEPARATOR_SYMBOL = 0,
  UNUM_GROUPING_SEPARATOR_SYMBOL = 1,
  UNUM_PATTERN_SEPARATOR_SYMBOL = 2,
  UNUM_PERCENT_SYMBOL = 3,
  UNUM_ZERO_DIGIT_SYMBOL = 4,
  UNUM_DIGIT_SYMBOL = 5,
  UNUM_MINUS_SIGN_SYMBOL = 6,
  UNUM_PLUS_SIGN_SYMBOL = 7,
  UNUM_CURRENCY_SYMBOL = 8,
  UNUM_INTL_CURRENCY_SYMBOL = 9,
  UNUM_MONETARY_SEPARATOR_SYMBOL = 10,
  UNUM_EXPONENTIAL_SYMBOL = 11,
  UNUM_PERMILL_SYMBOL = 12,
  UNUM_PAD_ESCAPE_SYMBOL = 13,
  UNUM_INFINITY_SYMBOL = 14,
  UNUM_NAN_SYMBOL = 15,
  UNUM_SIGNIFICANT_DIGIT_SYMBOL = 16,
  UNUM_MONETARY_GROUPING_SEPARATOR_SYMBOL = 17,
  UNUM_ONE_DIGIT_SYMBOL = 18,
  UNUM_TWO_DIGIT_SYMBOL = 19,
  UNUM_THREE_DIGIT_SYMBOL = 20,
  UNUM_FOUR_DIGIT_SYMBOL = 21,
  UNUM_FIVE_DIGIT_SYMBOL = 22,
  UNUM_SIX_DIGIT_SYMBOL = 23,
  UNUM_SEVEN_DIGIT_SYMBOL = 24,
  UNUM_EIGHT_DIGIT_SYMBOL = 25,
  UNUM_NINE_DIGIT_SYMBOL = 26,
 
  UNUM_EXPONENT_MULTIPLICATION_SYMBOL = 27,
 
#ifndef U_HIDE_INTERNAL_API
  UNUM_APPROXIMATELY_SIGN_SYMBOL = 28,
#endif
 
#ifndef U_HIDE_DEPRECATED_API
  UNUM_FORMAT_SYMBOL_COUNT = 29
#endif  /* U_HIDE_DEPRECATED_API */
} UNumberFormatSymbol;
 
U_CAPI int32_t U_EXPORT2
unum_getSymbol(const UNumberFormat *fmt,
               UNumberFormatSymbol symbol,
               UChar *buffer,
               int32_t size,
               UErrorCode *status);
 
U_CAPI void U_EXPORT2
unum_setSymbol(UNumberFormat *fmt,
               UNumberFormatSymbol symbol,
               const UChar *value,
               int32_t length,
               UErrorCode *status);
 
 
U_CAPI const char* U_EXPORT2
unum_getLocaleByType(const UNumberFormat *fmt,
                     ULocDataLocaleType type,
                     UErrorCode* status); 
 
U_CAPI void U_EXPORT2
unum_setContext(UNumberFormat* fmt, UDisplayContext value, UErrorCode* status);
 
U_CAPI UDisplayContext U_EXPORT2
unum_getContext(const UNumberFormat *fmt, UDisplayContextType type, UErrorCode* status);
 
#endif /* #if !UCONFIG_NO_FORMATTING */
 
#endif