CURRENCYFMTA 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.


typedef struct _currencyfmtA {
  UINT  NumDigits;
  UINT  LeadingZero;
  UINT  Grouping;
  LPSTR lpDecimalSep;
  LPSTR lpThousandSep;
  UINT  NegativeOrder;
  UINT  PositiveOrder;
  LPSTR lpCurrencySymbol;



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


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


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.


Pointer to a null-terminated decimal separator string.


Pointer to a null-terminated thousand separator string.


Negative currency mode. This mode is equivalent to LOCALE_INEGCURR.


Positive currency mode. This mode is equivalent to LOCALE_ICURRENCY.


Pointer to a null-terminated currency symbol string.



The winnls.h header defines CURRENCYFMT as an alias which 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 not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.


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


National Language Support Structures