Compartilhar via


localeconv

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:

  • 0
    Parênteses cercam o símbolo de moeda e quantidade.

  • 1
    Seqüência de caracteres de sinal precede o símbolo de moeda e quantidade.

  • 2
    Seqüência de caracteres de sinal segue o símbolo de moeda e quantidade.

  • 3
    Seqüência de caracteres de sinal imediatamente precede o símbolo de moeda.

  • 4
    Seqüência de caracteres de sinal segue imediatamente o símbolo de moeda.

Requisitos

Rotina

Cabeçalho necessário

localeconv

<locale.h>

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Bibliotecas

Todas as versões da bibliotecas de tempo de execução c.

Consulte também

Referência

Localidade

setlocale

Funções de strcoll

STRFTIME, wcsftime, _strftime_l, _wcsftime_l

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l