Nomi delle impostazioni locali, lingue e stringhe relative a paesi

Articolo
06/09/2015

L'argomento locale delle funzioni _create_locale e setlocale può essere impostato utilizzando i nomi delle impostazioni locali, le lingue, i codici paese e le tabelle codici supportati dall'API NLS di Windows. L'argomento locale assume il formato seguente:

locale :: "locale_name"
        | "language[_country_region[.code_page]]"
        | ".code_page"
        | "C"
        | ""
        | NULL

Il formato del nome delle impostazioni locali, ad esempio en-US per la lingua inglese (Stati Uniti) o bs-Cyrl-BA per la lingua bosniaca (Cirillico, Bosnia Erzegovina), è preferito. Il set dei nomi delle impostazioni locali è descritto in Nomi delle impostazioni locali. Per un elenco dei nomi delle impostazioni locali supportati dalla versione del sistema operativo Windows, vedere la colonna dei nomi delle impostazioni cultura del Riferimento all'API NLS (National Language Support). Sono elencate le parti lingua, script e paese supportate dei nomi delle impostazioni locali. Per informazioni sui nomi delle impostazioni locali supportati che presentano ordinamenti non predefiniti, vedere la colonna dei nomi delle impostazioni locali in Identificatori di ordinamento.

Il formato language[_country_region[.code_page]] viene archiviato nell'impostazione delle impostazioni locali di una categoria quando si utilizza una stringa lingua, o una stringa lingua e una stringa paese, per creare le impostazioni locali. Il set delle stringhe lingua supportate è descritto in Stringhe relative a lingue, mentre l'elenco delle stringhe paese supportate è riportato in Stringhe relative a paesi. Se la lingua specificata non è associata al paese specificato, nelle impostazioni locali viene archiviata la lingua predefinita del paese specificato. Questo formato non è consigliabile per le stringhe delle impostazioni locali incorporate nel codice o serializzate nell'archiviazione perché tali stringhe hanno molte più probabilità di subire modifiche in seguito a un aggiornamento del sistema operativo rispetto al formato del nome delle impostazioni locali.

La tabella codici è la tabella codici ANSI/OEM associata alle impostazioni locali. La tabella codici viene determinata automaticamente quando le impostazioni locali vengono specificate in base alla lingua o alla lingua e al paese. Il valore speciale .ACP specifica la tabella codici ANSI per il paese/regione. Il valore speciale .OCP specifica la tabella codici OEM per il paese/regione. Se ad esempio si specifica "Greek_Greece.ACP" come valore delle impostazioni locali, queste ultime vengono archiviate come Greek_Greece.1253 (la tabella codici ANSI per la lingua greca). Se invece si specifica "Greek_Greece.OCP", le impostazioni locali vengono archiviate come Greek_Greece.737 (la tabella codici OEM per la lingua greca). Per ulteriori informazioni sulle tabelle codici, vedere Tabelle codici. Per un elenco delle tabelle codici supportate in Windows, vedere Identificatori delle tabelle codici.

Se si utilizza esclusivamente la tabella codici per specificare le impostazioni locali, vengono utilizzati il paese e la lingua predefinita del sistema. Se ad esempio si specifica ".1254" (ANSI Turco) come impostazioni locali in un sistema configurato per la lingua Inglese (Stati Uniti), le impostazioni locali vengono archiviate come English_United States.1254. Questo formato non è consigliabile perché potrebbe generare un comportamento non coerente.

Il valore locale di C specifica l'ambiente ANSI minimo per la conversione C. Le impostazioni locali di C presuppongono che ogni tipo di dati char sia 1 byte e il relativo valore sia sempre minore di 256. Se locale punta a una stringa vuota, le impostazioni locali corrispondono all'ambiente nativo definito in fase di implementazione.

È possibile specificare contemporaneamente tutte le categorie di impostazioni locali per le funzioni _wsetlocale e setlocale utilizzando la categoria LC_ALL. È possibile impostare le categorie sulle stesse impostazioni locali oppure impostare singolarmente ogni categoria utilizzando un argomento delle impostazioni locali con il formato seguente:

LC_ALL_specifier :: locale
        | [LC_COLLATE=locale][;LC_CTYPE=locale][;LC_MONETARY=locale][;LC_NUMERIC=locale][;LC_TIME=locale]

È possibile specificare più tipi di categoria, separati da punti e virgola. I tipi di categoria non specificati utilizzano le impostazioni locali correnti. In questo codice, ad esempio, le impostazioni locali correnti di tutte le categorie sono impostate su de-DE, le categorie LC_MONETARY sono impostate su En-gb e le categorie LC_TIME su Es-es:

_wsetlocale(LC_ALL, L"de-DE");

_wsetlocale(LC_ALL, L"LC_MONETARY=en-GB;LC_TIME=es-ES");