localeconv

Artigo
02/25/2013

Deixa as informações detalhadas sobre configurações de localidade.

struct lconv *localeconv( void );

Valor de retorno

localeconvRetorna um ponteiro para um objeto preenchido do tipo struct lconv.Os valores contidos no objeto que podem ser substituídos por chamadas subseqüentes para localeconv e modifique o objeto diretamente.Chamadas para setlocale com category valores de LC_ALL, LC_MONETARY, ou LC_NUMERIC substituir o conteúdo da estrutura.

Comentários

O localeconv função obtém informações detalhadas sobre a formatação numérica para a localidade atual.Essas informações são armazenadas em uma estrutura do tipo lconv.O lconv estrutura, definida na localidade.H, contém os seguintes membros:

char *decimal_point, wchar_t *_W_decimal_point
Caractere de ponto decimal para quantidades não monetários.
char *thousands_sep, wchar_t *_W_thousands_sep
Caractere que separa grupos de dígitos à esquerda da vírgula decimal para quantidades não monetários.
char *grouping
Tamanho de cada grupo de dígitos em quantidades não monetários.
char *int_curr_symbol, wchar_t *_W_int_curr_symbol
Símbolo de moeda internacional de localidade atual.Três primeiros caracteres especificam o símbolo de moeda internacional alfabéticos conforme definido na Os códigos ISO 4217 para a representação de moeda e fundos padrão.Quarto caractere (imediatamente anterior o caractere nulo) separa o símbolo de moeda internacional da quantidade monetária.
char *currency_symbol, wchar_t *_W_currency_symbol
Símbolo de moeda local para a localidade atual.
char *mon_decimal_point, wchar_t *_W_mon_decimal_point
Caractere de ponto decimal para quantidades monetárias.
char *mon_thousands_sep, wchar_t *_W_mon_thousands_sep
Separador para grupos de dígitos à esquerda da casa decimal em quantidades monetárias.
char *mon_grouping
Tamanho de cada grupo de dígitos em quantidades monetários.
char *positive_sign, wchar_t *_W_positive_sign
A seqüência de caracteres indicando o sinal para quantidades monetárias não-negativos.
char *negative_sign, wchar_t *_W_negative_sign
A seqüência de caracteres que indicam o sinal para quantidades monetárias negativas.
char int_frac_digits
Número de dígitos à direita do ponto decimal em quantidades monetários internacionalmente formatados.
char frac_digits
Número de dígitos à direita do ponto decimal em quantidades monetários formatados.
char p_cs_precedes
Definido como 1 se o símbolo de moeda precede o valor para a quantidade de monetária formatada não-negativa.Definido como 0 se o símbolo sucede valor.
char p_sep_by_space
Definido como 1 se o símbolo da moeda é separado por espaço de valor para a quantidade de monetária formatada não-negativa.Definido como 0 se não houver nenhuma separação de espaço.
char n_cs_precedes
Definido como 1 se o símbolo de moeda precede o valor para a quantidade de monetária negativa formatada.Definido como 0 se o símbolo sucede valor.
char n_sep_by_space
Definido como 1 se o símbolo da moeda é separado por espaço do valor para a quantidade de monetária negativa formatada.Definido como 0 se não houver nenhuma separação de espaço.
char p_sign_posn
Posição do sinal positivo em quantidades de monetárias formatadas não-negativos.
char n_sign_posn
Posição do sinal positivo em quantidades negativas de monetárias formatadas.

Membros da estrutura que possuem char* e wchar_t * as versões são ponteiros para seqüências de caracteres. Qualquer um desses é igual a "" (ou L"" para wchar_t *) é de comprimento zero ou não suportado na localidade atual.Observe que decimal_point e _W_decimal_point são sempre compatível e de comprimento diferente de zero.

O char membros da estrutura são pequenas quantidades de não-negativos, não de caracteres.Qualquer um desses é igual a CHAR_MAX não há suporte para a localidade atual.

Os elementos de de agrupamento e mon_grouping são interpretados conforme as regras a seguir.

CHAR_MAX
Não realize qualquer agrupamento ainda mais.
0
Use o elemento anterior para cada um dos dígitos restantes.
n
Número de dígitos que compõem o grupo atual.Próximo elemento é examinado para determinar o tamanho do próximo grupo de dígitos antes do grupo atual.

Os valores para int_curr_symbol são interpretados conforme as regras a seguir:

Os três primeiros caracteres para especificar o símbolo de moeda internacional alfabéticos conforme definido na Os códigos ISO 4217 para a representação de moeda e fundos padrão.
O quarto caractere (imediatamente antes do caractere nulo) separa o símbolo de moeda internacional da quantidade monetária.

Os valores para p_cs_precedes e n_cs_precedes são interpretados conforme as regras a seguir (o n_cs_precedes a regra está em parênteses):

0
Símbolo de moeda segue o valor para não-negativo (negativo) valor monetário formatado.
1
Símbolo de moeda precede o valor para não-negativo (negativo) valor monetário formatado.

Os valores para p_sep_by_space e n_sep_by_space são interpretados conforme as regras a seguir (o n_sep_by_space a regra está em parênteses):

0
Símbolo de moeda é separado do valor por espaço para não-negativo (negativo) valor monetário formatado.
1
Não há nenhuma separação de espaço entre o símbolo de moeda e valor para não-negativo (negativo) valor monetário formatado.

Os valores para p_sign_posn e n_sign_posn são interpretados conforme as regras a seguir: