Estrutura NUMBERFMTA (winnls.h)

Artigo
11/20/2024

Contém informações que definem o formato de uma cadeia de caracteres numérica. A função GetNumberFormat usa essas informações para personalizar uma cadeia de caracteres numérica para uma localidade especificada.

Sintaxe

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

Membros

NumDigits

Número de dígitos fracionários. Esse valor é equivalente às informações de localidade especificadas pelo valor LOCALE_IDIGITS.

LeadingZero

Um valor que indica se zeros à esquerda devem ser usados em campos decimais. Esse valor é equivalente às informações de localidade especificadas pelo valor LOCALE_ILZERO.

Grouping

Número de dígitos em cada grupo de números à esquerda do separador decimal especificado por lpDecimalSep. Os valores no intervalo de 0 a 9 e 32 são válidos. O dígito de agrupamento mais significativo indica o número de dígitos no grupo menos significativo imediatamente à esquerda do separador decimal. Cada dígito de agrupamento subsequente indica o próximo grupo significativo de dígitos à esquerda do grupo anterior. Se o último valor fornecido não for 0, os grupos restantes repetirão o último grupo. Exemplos típicos de configurações para este membro são: 0 para agrupar dígitos como em 123456789.00; 3 para agrupar dígitos como em 123.456.789,00; e 32 para agrupar dígitos como em 12,34,56.789,00.

Observação Você pode usar configurações diferentes das configurações típicas, mas elas não aparecerão na parte regional e de opções de idioma do Painel de Controle. Essas configurações são extremamente incomuns e podem ter resultados inesperados.

lpDecimalSep

Ponteiro para uma cadeia de caracteres separador decimal terminada em nulo.

lpThousandSep

Ponteiro para uma cadeia de caracteres separador de mil terminadas em nulo.

NegativeOrder

Modo de número negativo. Esse modo é equivalente às informações de localidade especificadas pelo valor LOCALE_INEGNUMBER.

Observações

Nota

O cabeçalho winnls.h define NUMBERFMT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
cabeçalho	winnls.h (inclua Windows.h)

Consulte também

GetNumberFormat

estruturas de suporte à linguagem nacional

Compartilhar via