NUMBERFMTA structure (winnls.h)

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

Syntax

typedef struct _numberfmtA {
  UINT  NumDigits;
  UINT  LeadingZero;
  UINT  Grouping;
  LPSTR lpDecimalSep;
  LPSTR lpThousandSep;
  UINT  NegativeOrder;
} NUMBERFMTA, *LPNUMBERFMTA;

Members

NumDigits

Number of fractional digits. This value is equivalent to the locale information specified by the value LOCALE_IDIGITS.

LeadingZero

A value indicating if leading zeros should be used in decimal fields. This value is equivalent to the locale information specified by the value LOCALE_ILZERO.

Grouping

Number of digits in each group of numbers to the left of the decimal separator specified by lpDecimalSep. Values in the range 0 through 9 and 32 are valid. 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 options 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 number mode. This mode is equivalent to the locale information specified by the value LOCALE_INEGNUMBER.

Remarks

Note

The winnls.h header defines NUMBERFMT 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

GetNumberFormat

National Language Support Structures