Nomi delle impostazioni locali, lingue e stringhe relative a paesiLocale Names, Languages, and Country/Region Strings

L'argomento locale delle funzioni setlocale e _create_locale può essere impostato usando i nomi delle impostazioni locali, le lingue, i codici di paese/area geografica e le tabelle codici supportati dall'API NLS di Windows.The locale argument to the setlocale and _create_locale functions can be set by using the locale names, languages, country/region codes, and code pages that are supported by the Windows NLS API. L'argomento locale assume il formato seguente:The locale argument takes the following form:

locale :: "nome_impostazioni:locali"locale :: "locale_name"
    | "lingua[_paese-areageografica][.tabella_codici]]"    | "language[_country-region][.code_page]]"
    | ".tabella_codici"    | ".code_page"
    | "C"    | "C"
    | ""    | ""
    | NULL    | NULL

Il formato del nome delle impostazioni locali è preferenziale, ad esempio usare en-US per la lingua inglese (Stati Uniti) o bs-Cyrl-BA per la lingua bosniaca (Cirillico, Bosnia ed Erzegovina).The locale name form is preferred; for example, use en-US for English (United States) or bs-Cyrl-BA for Bosnian (Cyrillic, Bosnia and Herzegovina). Il set dei nomi delle impostazioni locali è descritto nell'articolo relativo ai nomi delle impostazioni locali.The set of locale names is described in Locale Names. 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).For a list of supported locale names by Windows operating system version, see the Culture Name column of the National Language Support (NLS) API Reference. Sono elencate le parti lingua, script e paese supportate dei nomi delle impostazioni locali.This resource lists the supported language, script, and region parts of the locale names. Per informazioni sui nomi delle impostazioni locali supportati che presentano ordinamenti non predefiniti, vedere la colonna dei nomi delle impostazioni locali nell'articolo relativo agli identificatori di ordinamento.For information about the supported locale names that have non-default sort orders, see the Locale name column in Sort Order Identifiers. Per informazioni sul supporto di lingue e impostazioni locali nel sistema operativo Windows in base alla versione, vedere Appendix A: Product Behavior (Appendice A: comportamento del prodotto) in "[MS-LCID]: Windows Language Code Identifier (LCID) Reference" (Informazioni di riferimento sugli identificatori di lingua (LCID) di Windows).For additional information about language and location support in the Windows operating system by version, see Appendix A: Product Behavior in [MS-LCID]: Windows Language Code Identifier (LCID) Reference. In Windows 10 o versioni successive, sono consentiti i nomi delle impostazioni locali che corrispondono a tag di lingua BCP-47 validi.Under Windows 10 or later, locale names that correspond to valid BCP-47 language tags are allowed. Ad esempio, jp-US è un tag BCP-47 valido, ma in effetti è solo US per le funzionalità delle impostazioni locali.For example, jp-US is a valid BCP-47 tag, but it is effectively only US for locale functionality.

Il formato language[_country_region[.code_page]] viene archiviato nell'impostazione delle impostazioni locali di una categoria quando si usa una stringa lingua, o una stringa lingua e una stringa paese/area geografica, per creare le impostazioni locali.The language[_country_region[.code_page]] form is stored in the locale setting for a category when a language string, or language string and country/region string, is used to create the locale. Il set delle stringhe lingua supportate è descritto in Language Strings, mentre l'elenco delle stringhe paese/area geografica supportate è riportato in Country/Region Strings.The set of supported language strings is described in Language Strings, and the list of supported country/region strings is listed in Country/Region Strings. Se la lingua specificata non è associata al paese specificato, nelle impostazioni locali viene archiviata la lingua predefinita del paese specificato.If the specified language is not associated with the specified country/region, the default language for the specified country/region is stored in the locale setting. 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.We do not recommend this form for locale strings embedded in code or serialized to storage, because these strings are more likely to be changed by an operating system update than the locale name form.

La tabella codici è la tabella codici ANSI/OEM associata alle impostazioni locali.The code page is the ANSI/OEM code page that's associated with the locale. La tabella codici viene determinata automaticamente quando le impostazioni locali vengono specificate in base alla lingua o alla lingua e al paese.The code page is determined for you when you specify a locale by language or by language and country/region alone. Il valore speciale .ACP specifica la tabella codici ANSI per il paese/regione.The special value .ACP specifies the ANSI code page for the country/region. Il valore speciale .OCP specifica la tabella codici OEM per il paese/regione.The special value .OCP specifies the OEM code page for the country/region. Se ad esempio si specifica "Greek_Greece.ACP" come valore delle impostazioni locali, queste ultime vengono archiviate come Greek_Greece.1253 , vale a dire la tabella codici ANSI per la lingua greca. Se invece si specifica "Greek_Greece.OCP" , le impostazioni locali vengono archiviate come Greek_Greece.737 , vale a dire la tabella codici OEM per la lingua greca.For example, if you specify "Greek_Greece.ACP" as the locale, the locale is stored as Greek_Greece.1253 (the ANSI code page for Greek), and if you specify "Greek_Greece.OCP" as the locale, it is stored as Greek_Greece.737 (the OEM code page for Greek). Per altre informazioni sulle tabelle codici, vedere Code Pages.For more information about code pages, see Code Pages. Per un elenco delle tabelle codici supportate in Windows, vedere l'articolo relativo agli identificatori delle tabelle codici.For a list of supported code pages on Windows, see Code Page Identifiers.

Se si utilizza esclusivamente la tabella codici per specificare le impostazioni locali, vengono utilizzati il paese e la lingua predefinita del sistema.If you use only the code page to specify the locale, the system default language and country/region are used. Se ad esempio si specifica ".1254" (ANSI - Turco) come valore delle impostazioni locali in un sistema configurato per la lingua Inglese (Stati Uniti), le impostazioni locali vengono archiviate come English_United States.1254.For example, if you specify ".1254" (ANSI Turkish) as the locale on a system that's configured for English (United States), the locale that's stored is English_United States.1254. Questo formato non è consigliabile perché potrebbe generare un comportamento non coerente.We do not recommend this form, because it could lead to inconsistent behavior.

Il valore C per l'argomento locale specifica l'ambiente ANSI minimo per la conversione C.A locale argument value of C specifies the minimal ANSI conforming environment for C translation. Le impostazioni locali di C presuppongono che ogni tipo di dati char sia 1 byte e il relativo valore sia sempre minore di 256.The C locale assumes that every char data type is 1 byte and its value is always less than 256. Se locale punta a una stringa vuota, le impostazioni locali corrispondono all'ambiente nativo definito in fase di implementazione.If locale points to an empty string, the locale is the implementation-defined native environment.

È possibile specificare contemporaneamente tutte le categorie di impostazioni locali per le funzioni setlocale e _wsetlocale utilizzando la categoria LC_ALL .You can specify all of the locale categories at the same time for the setlocale and _wsetlocale functions by using the LC_ALL category. È possibile impostare le categorie sulle stesse impostazioni locali oppure impostare singolarmente ogni categoria utilizzando un argomento delle impostazioni locali con il formato seguente:The categories can all be set to the same locale, or you can set each category individually by using a locale argument that has this form:

LC_ALL_specifier :: localeLC_ALL_specifier :: locale
    | [LC_COLLATE=locale][;LC_CTYPE=locale][;LC_MONETARY=locale][;LC_NUMERIC=locale][;LC_TIME=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.You can specify multiple category types, separated by semicolons. I tipi di categoria non specificati utilizzano le impostazioni locali correnti.Category types that are not specified use the current locale setting. Questo frammento di codice, ad esempio, imposta su de-DE le impostazioni locali correnti di tutte le categorie, quindi imposta le categorie LC_MONETARY su en-GB e le categorie LC_TIME su es-ES:For example, this code snippet sets the current locale for all categories to de-DE, and then sets the categories LC_MONETARY to en-GB and LC_TIME to es-ES:

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

Vedere ancheSee Also

Riferimenti della libreria di runtime C C Run-Time Library Reference
_get_current_locale _get_current_locale
setlocale, _wsetlocale setlocale, _wsetlocale
_create_locale, _wcreate_locale _create_locale, _wcreate_locale
Stringhe relative a lingue Language Strings
Stringhe relative a paesi/aree geograficheCountry/Region Strings