UCRT-lokala namn, språk och land-/regionsträngar

Du kan ange locale argumentet till setlocalefunktionerna , _wsetlocale, _create_localeoch _wcreate_locale på flera sätt. Språkvarianten kan anges med hjälp av nationella namn, språk, lands-/regionkoder och kodsidor som stöds av Windows NLS-API:et. Argumentet locale har något av följande formulär:

locale :: "locale-name"
 | "language[_country-region[.code-page]]"
 | ". code-page"
 | "C"
 | ""
 | NOLL

Språknamnsformuläret är en kort, IETF-standardiserad sträng. till exempel en-US för engelska (USA) eller bs-Cyrl-BA för bosniska (kyrilliska, Bosnien och Hercegovina). De här formulären är att föredra. En lista över språknamn som stöds av Windows operativsystemversion finns i kolumnen Språktagg i tabellen i bilaga A: Produktbeteende i [MS-LCID]: Referens för Windows Language Code Identifier (LCID). Den här resursen visar språk, skript och regiondelar som stöds i språknamnen. Information om språknamn som stöds och som inte har standardsorteringsordningar finns i kolumnen Språknamn i Sorteringsordningsidentifierare. Under Windows 10 eller senare tillåts nationella namn som motsvarar giltiga BCP-47-språktaggar . Till exempel jp-US är en giltig BCP-47-tagg, men den är i själva verket endast US för språkfunktioner.

Språket[_country-region[.code-page]] formatet lagras i locale-inställningen för en kategori när en språksträng, eller språksträng och lands- eller regionsträng, används för att skapa locale. Uppsättningen med språksträngar som stöds beskrivs i Språksträngar och listan över lands- och regionsträngar som stöds visas i lands-/regionsträngar. Om det angivna språket inte är associerat med det angivna landet eller regionen lagras standardspråket för det angivna landet eller regionen i nationella inställningar. Vi rekommenderar inte detta format för lokala strängar som är inbäddade i kod eller serialiseras till lagring: Sådana strängar är mer benägna att ändras av en uppdatering av operativsystemet än lokala namnformatet.

Kodsidan är den ANSI-/ OEM-kodsida som är associerad med nationella inställningar. Kodsidan bestäms för dig när du anger en lokal genom språk eller genom både språk och land/region. Specialvärdet .ACP anger ANSI-kodsidan för landet/regionen. Specialvärdet .OCP anger OEM-kodsidan för landet/regionen. Om du till exempel anger "Greek_Greece.ACP" som språkvariant lagras språkvarianten som Greek_Greece.1253 (ANSI-kodsidan för grekiska) och om du anger "Greek_Greece.OCP" som språkvariant lagras den som Greek_Greece.737 (OEM-kodsidan för grekiska). Mer information om kodsidor finns i Kodsidor. En lista över kodsidor som stöds i Windows finns i Kodsideidentifierare.

Om du bara använder kodsidan för att ange nationella inställningar används användarens standardspråk och land/region enligt vad som rapporteras av GetUserDefaultLocaleName . Om du till exempel anger ".1254" (ANSI Turkish) som språkvariant för en användare som har konfigurerats för engelska (USA) är English_United States.1254språket som lagras . Vi rekommenderar inte det här formuläret eftersom det kan leda till inkonsekvent beteende.

Ett locale argumentvärde C för anger den minimala ANSI-överensstämmande miljön för C-översättning. Nationella C inställningar förutsätter att varje char datatyp är 1 byte och att dess värde alltid är mindre än 256. Om locale pekar på en tom sträng är landinställningen den implementeringsdefinierade inhemska miljön.

Du kan ange alla nationella kategorier samtidigt för funktionerna setlocale och _wsetlocale med hjälp av LC_ALL-kategorin. Kategorierna kan alla anges till samma lokala inställning, eller så kan du ange varje kategori individuellt med hjälp av ett lokalt inställningsargument som har det här formatet:

LC-ALL-specifier :: locale
 | [LC_COLLATE=][locale;LC_CTYPE=][locale;LC_MONETARY=][][locale;LC_NUMERIC=][locale;LC_TIME=]locale

Du kan ange flera kategorityper, avgränsade med semikolon. Kategorityper som inte har angetts använder den aktuella nationella inställningen. Det här kodfragmentet anger till exempel det aktuella språket för alla kategorier till de-DEoch anger sedan kategorierna LC_MONETARY till en-GB och LC_TIME till es-ES:

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

STÖD FÖR UTF-8

UTF-8-stöd kan aktiveras med hjälp av UTF-8-kodsidan i lokalsträngen. Mer information finns i supportavsnittet UTF-8 i setlocale.

Se även

Referens för C-körtidsbibliotek
_get_current_locale
setlocale, _wsetlocale
_create_locale, _wcreate_locale
Språksträngar
Länder-/regionsträngar