localeconv

  • Articolo

Ottiene informazioni dettagliate sulle impostazioni locali.

Sintassi

struct lconv *localeconv( void );

Valore restituito

localeconv restituisce un puntatore a un oggetto compilato di tipo struct lconv. I valori contenuti nell'oggetto vengono copiati dalle impostazioni locali nell'archiviazione locale del thread e possono essere sovrascritti dalle chiamate successive a localeconv. Le modifiche apportate ai valori in questo oggetto non modificano le impostazioni locali. Chiama a setlocale con category valori di LC_ALL, LC_MONETARYo LC_NUMERIC sovrascrive il contenuto della struttura.

Osservazioni:

La funzione localeconv ottiene informazioni dettagliate sulla formattazione numerica per le impostazioni locali correnti. Queste informazioni vengono archiviate in una struttura di tipo lconv. Struttura lconv , definita in IMPOSTAZIONI LOCALI. H contiene i membri seguenti:

Campo Significato
decimal_point,
_W_decimal_point		 Puntatore al carattere decimale per le quantità nonmonetary.
thousands_sep,
_W_thousands_sep		 Puntatore al carattere che separa i gruppi di cifre a sinistra del separatore decimale per le quantità nonmonetary.
grouping Puntatore a un charintero con dimensioni che contiene le dimensioni di ogni gruppo di cifre in quantità nonmonetary.
int_curr_symbol,
_W_int_curr_symbol		 Puntatore al 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 dei codici per la rappresentazione di valute e fondi. Il quarto carattere (carattere Null immediatamente precedente) separa il simbolo di valuta internazionale dalla quantità monetaria.
currency_symbol,
_W_currency_symbol		 Puntatore al simbolo di valuta locale per le impostazioni locali correnti.
mon_decimal_point,
_W_mon_decimal_point		 Puntatore a carattere decimale per le quantità monetarie.
mon_thousands_sep,
_W_mon_thousands_sep		 Puntatore al separatore per i gruppi di cifre a sinistra della posizione decimale nelle quantità monetarie.
mon_grouping Puntatore a un charnumero intero di dimensioni che contiene le dimensioni di ogni gruppo di cifre nelle quantità monetarie.
positive_sign,
_W_positive_sign		 Stringa del segno per le quantità monetarie non negative.
negative_sign,
_W_negative_sign		 Stringa del segno per le quantità monetarie negative.
int_frac_digits Numero di cifre a destra del separatore decimale in quantità monetarie con formattazione internazionale.
frac_digits Numero di cifre a destra del separatore decimale in quantità monetarie formattate.
p_cs_precedes Impostare su 1 se il simbolo di valuta precede il valore per la quantità monetaria formattata non negativa. Impostare su 0 se il simbolo segue il valore.
p_sep_by_space Impostare su 1 se il simbolo di valuta è separato con uno spazio dal valore per la quantità monetaria formattata non negativa. Impostare su 0 se non è presente alcuna separazione dello spazio.
n_cs_precedes Impostare su 1 se il simbolo di valuta precede il valore per la quantità monetaria formattata negativa. Impostare su 0 se il simbolo segue il valore.
n_sep_by_space Impostare su 1 se il simbolo di valuta è separato con uno spazio dal valore per la quantità monetaria formattata negativa. Impostare su 0 se non è presente alcuna separazione dello spazio.
p_sign_posn Nelle quantità monetarie non formattate non negativo, posizione del segno positivo.
n_sign_posn In quantità monetarie formattate negative, posizione del segno positivo.

Ad eccezione di quanto specificato, i membri della lconv struttura con char * versioni e wchar_t * sono puntatori alle stringhe. Qualsiasi membro uguale "" a (o L"" per wchar_t *) è di lunghezza zero o non è supportato nelle impostazioni locali correnti. Sia decimal_point che _W_decimal_point sono sempre supportati e hanno una lunghezza diversa da zero.

I char membri della struttura sono numeri piccoli non negativi, non caratteri. Qualsiasi membro uguale CHAR_MAX a non è supportato nelle impostazioni locali correnti.

I valori di grouping e mon_grouping vengono interpretati in base alle regole seguenti:

  • CHAR_MAX - Non eseguire ulteriori raggruppamenti.

  • 0 - Usare l'elemento precedente per ognuna delle cifre rimanenti.

  • n - Numero di cifre che costituiscono il gruppo corrente. Viene esaminato l'elemento successivo per determinare le dimensioni del gruppo successivo di cifre prima del gruppo corrente.

I valori per int_curr_symbol vengono interpretati in base alle regole seguenti:

  • I primi tre caratteri specificano il simbolo di valuta internazionale alfabetico come definito nello standard ISO 4217 dei codici per la rappresentazione di valute e fondi.

  • Il quarto carattere (carattere Null immediatamente precedente) separa il simbolo di valuta internazionale dalla quantità monetaria.

I valori per p_cs_precedes e n_cs_precedes vengono interpretati in base alle regole seguenti (la n_cs_precedes regola è racchiusa tra parentesi):

  • 0 - Il simbolo di valuta segue il valore per il valore monetario non negativo (negativo).

  • 1 - Il simbolo di valuta precede il valore per il valore monetario non negativo (negativo).

I valori per p_sep_by_space e n_sep_by_space vengono interpretati in base alle regole seguenti (la n_sep_by_space regola è racchiusa tra parentesi):

  • 0 - Il simbolo di valuta è separato dal valore in base al valore per il valore monetario non negativo (negativo).

  • 1 - Non esiste alcuna separazione dello spazio tra il simbolo di valuta e il valore per il valore monetario non negativo (negativo).

I valori per p_sign_posn e n_sign_posn vengono interpretati in base alle regole seguenti:

  • 0 - Le parentesi racchiudono quantità e simbolo di valuta.

  • 1 - La stringa di segno precede la quantità e il simbolo di valuta.

  • 2 - La stringa di segno segue la quantità e il simbolo di valuta.

  • 3 - Firma stringa precede immediatamente il simbolo di valuta.

  • 4 - Firma stringa immediatamente segue il simbolo di valuta.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo Intestazione obbligatoria
localeconv <locale.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Librerie

Tutte le versioni delle librerie di runtime C.

Vedi anche

impostazioni locali
setlocale
Funzioni strcoll
strftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l