localeconv
Ottiene informazioni dettagliate sulle impostazioni locali.
struct lconv *localeconv( void );
Valore restituito
localeconv restituisce un puntatore a un oggetto compilato di tipo lconv struct. I valori contenuti nell'oggetto possono essere sovrascritti dalle chiamate successive a localeconv e non modificano direttamente l'oggetto. Le chiamate a setlocale con i valori category di LC_ALL, LC_MONETARY, o LC_NUMERIC sovrascrivono il contenuto della struttura.
Note
La funzione localeconv ottiene informazioni dettagliate sulla formattazione numerica per le impostazioni locali correnti. Queste informazioni vengono archiviate in una struttura di tipo lconv. La struttura lconv, definita in LOCALE.H, contiene i seguenti membri:
char *decimal_point, wchar_t *_W_decimal_point
Carattere del separatore decimale per quantità non monetarie.char *thousands_sep, wchar_t *_W_thousands_sep
Carattere che separa i gruppi di cifre a sinistra del separatore decimale per quantità non monetarie.char *grouping
Dimensione di ciascun gruppo di cifre in quantità non monetarie.char *int_curr_symbol, wchar_t *_W_int_curr_symbol
Simbolo di valuta internazionale per le impostazioni locali correnti. I primi tre caratteri specificano il simbolo di valuta internazionale alfabetico come definito nello standard ISO 4217 Codici per la rappresentazione di valuta e fondi. Il quarto carattere (immediatamente prima di carattere null) separa il simbolo di valuta internazionale dalla quantità monetaria.char *currency_symbol, wchar_t *_W_currency_symbol
Simbolo di valuta locale per le impostazioni locali correnti.char *mon_decimal_point, wchar_t *_W_mon_decimal_point
Carattere del separatore decimale per quantità monetarie.char *mon_thousands_sep, wchar_t *_W_mon_thousands_sep
Separatore per gruppi di cifre a sinistra del separatore decimale in quantità monetarie.char *mon_grouping
Dimensione di ciascun gruppo di cifre in quantità monetarie.char *positive_sign, wchar_t *_W_positive_sign
Stringa che denota il segno per quantità monetarie non negative.char *negative_sign, wchar_t *_W_negative_sign
Stringa che denota il segno per quantità monetarie negative.char int_frac_digits
Numero di cifre a destra del separatore decimale in quantità monetarie formattate a livello internazionale.char frac_digits
Numero di cifre a destra del separatore decimale in quantità monetarie formattate.char p_cs_precedes
Impostato ad 1 se il simbolo di valuta precede il valore per quantità monetaria formattata non negativa. Impostato a 0 se il simbolo segue il valore.char p_sep_by_space
Impostato ad 1 se il simbolo di valuta è separato tramite uno spazio dal valore per la quantità monetaria formattata non negativa. Impostato a 0 se non è presente una separazione tramite uno spazio.char n_cs_precedes
Impostato ad 1 se il simbolo di valuta precede il valore per quantità monetaria formattata negativa. Impostato a 0 se il simbolo segue il valore.char n_sep_by_space
Impostato ad 1 se il simbolo di valuta è separato tramite uno spazio dal valore per la quantità monetaria formattata negativa. Impostato a 0 se non è presente una separazione tramite uno spazio.char p_sign_posn
Posizione del segno positivo in quantità monetaria formattata non negativa.char n_sign_posn
Posizione del segno positivo in quantità monetaria formattata negativa.
I membri della struttura che hanno versioni char * e wchar_t * sono puntatori a stringhe. Qualsiasi di questi che equivalga a "" (o L"" per wchar_t *) è di lunghezza zero oppure non supportato nelle impostazioni locali correnti. Si noti che decimal_point e _W_decimal_point sono sempre supportati e di lunghezza diversa da zero.
I membri char della struttura sono numeri piccoli non negativi, non caratteri. Qualsiasi di questi che equivalga a CHAR_MAX non è supportato nelle impostazioni locali correnti.
Gli elementi di grouping e mon_grouping vengono interpretati secondo le regole seguenti.
CHAR_MAX
Non eseguire alcun raggruppamento ulteriore.0
Utilizzare l'elemento precedente per ognuna delle cifre rimanenti.n
Numero di cifre che costituisce il gruppo corrente. L'elemento seguente viene esaminato per determinare la dimensione del gruppo successivo di cifre prima del gruppo corrente.
I valori per int_curr_symbol vengono interpretati secondo le regole seguenti:
I primi tre caratteri specificano il simbolo di valuta internazionale alfabetico come definito nello standard ISO 4217 Codici per la rappresentazione di valuta e fondi.
Il quarto carattere (immediatamente prima del carattere null) separa il simbolo di valuta internazionale dalla quantità monetaria.
I valori per p_cs_precedes e n_cs_precedes vengono interpretati secondo le regole seguenti (la regola di n_cs_precedes è tra parentesi):
0
Il simbolo di valuta segue il valore per il valore monetario formattato non negativo (negativo).1
Il simbolo di valuta precede il valore per il valore monetario formattato non negativo (negativo).
I valori per p_sep_by_space e n_sep_by_space vengono interpretati secondo le regole seguenti (la regola di n_sep_by_space è tra parentesi):
0
Il simbolo di valuta è separato dal valore tramite uno spazio per il valore monetario formattato non negativo (negativo).1
Non vi è separazione tramite spazio tra il simbolo di valuta ed il valore del valore monetario formattato non negativo (negativo).
I valori per p_sign_posn e n_sign_posn vengono interpretati secondo le regole seguenti:
0
Quantità e simbolo di valuta sono tra parentesi.1
La stringa del segno precede la quantità ed il simbolo di valuta.2
La stringa del segno segue la quantità ed il simbolo di valuta.3
La stringa del segno precede immediatamente il simbolo di valuta.4
La stringa del segno segue immediatamente il simbolo di valuta.
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
localeconv |
<locale.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'Introduzione.
Librerie
Tutte le versioni delle Librerie di runtime C.