CURRENCYFMTW structure (winnls.h)

Contains information that defines the format of a currency string. The GetCurrencyFormat function uses this information to customize a currency string for a specified locale.

Syntax

typedef struct _currencyfmtW {
  UINT   NumDigits;
  UINT   LeadingZero;
  UINT   Grouping;
  LPWSTR lpDecimalSep;
  LPWSTR lpThousandSep;
  UINT   NegativeOrder;
  UINT   PositiveOrder;
  LPWSTR lpCurrencySymbol;
} CURRENCYFMTW, *LPCURRENCYFMTW;

Members

NumDigits

Number of fractional digits. This number is equivalent to LOCALE_ICURRDIGITS.

LeadingZero

Value indicating if leading zeros should be used in decimal fields. This value is equivalent to LOCALE_ILZERO.

Grouping

Number of digits in each group of numbers to the left of the decimal separator specified by lpDecimalSep. The most significant grouping digit indicates the number of digits in the least significant group immediately to the left of the decimal separator. Each subsequent grouping digit indicates the next significant group of digits to the left of the previous group. If the last value supplied is not 0, the remaining groups repeat the last group. Typical examples of settings for this member are: 0 to group digits as in 123456789.00; 3 to group digits as in 123,456,789.00; and 32 to group digits as in 12,34,56,789.00.

Note   You can use settings other than the typical settings, but they will not show up in the regional and language settings portion of the Control Panel. Such settings are extremely uncommon and might have unexpected results.

 

lpDecimalSep

Pointer to a null-terminated decimal separator string.

lpThousandSep

Pointer to a null-terminated thousand separator string.

NegativeOrder

Negative currency mode. This mode is equivalent to LOCALE_INEGCURR.

PositiveOrder

Positive currency mode. This mode is equivalent to LOCALE_ICURRENCY.

lpCurrencySymbol

Pointer to a null-terminated currency symbol string.

Remarks

Note

The winnls.h header defines CURRENCYFMT as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server	Windows 2000 Server [desktop apps | UWP apps]
Header	winnls.h (include Windows.h)

See also

GetCurrencyFormat

National Language Support Structures