description | title | ms.date | f1_keywords | helpviewer_keywords | no-loc | |||||
---|---|---|---|---|---|---|---|---|---|---|
Learn more about the setlocale pragma directive in Microsoft C/C++ |
setlocale pragma |
01/22/2021 |
|
|
|
Defines the locale, the country/region and language to use when translating wide-character constants and string literals.
#pragma setlocale( "
[ locale-string ]" )
Because the algorithm for converting multibyte characters to wide characters may vary by locale, or the compilation may take place in a different locale from where an executable file will be run, this pragma provides a way to specify the target locale at compile time. It guarantees wide-character strings are stored in the correct format.
The default locale-string is the empty string, specified by #pragma setlocale( "" )
.
The "C"
locale maps each character in the string to its value as a wchar_t
. Other valid values for setlocale
are the entries found in the Language strings list. For example, you could specify:
#pragma setlocale("dutch")
The ability to specify a language string depends on the code page and language ID support on your computer.