Skip to content

Commit 03e88a2

Browse files
TrishaMcTrishaMc
authored
Merge pull request #1198 from corob-msft/cr-nls-api-fix
Fix missing links to NLS API docs.
2 parents 1b0f246 + ac0e8fe commit 03e88a2

File tree

3 files changed

+153
-143
lines changed

3 files changed

+153
-143
lines changed

‎docs/c-runtime-library/country-region-strings.md

+39-35
Original file line numberDiff line numberDiff line change
@@ -13,38 +13,42 @@ ms.author: "corob"
1313
ms.workload: ["cplusplus"]
1414
---
1515
# Country/Region Strings
16-
Country and region strings can be combined with a language string to create a locale specification for the `setlocale`, `_wsetlocale`, `_create_locale`, and `_wcreate_locale` functions. For lists of country/region names that are supported by various Windows operating system versions, see [National Language Support (NLS) API Reference](https://www.microsoft.com/resources/msdn/goglobal/default.mspx). In the lists, the country/region string can be any of the country values in the **Locale - Language Country/Region** column, or any of the abbreviations in the **Country or Region name abbreviation** column. For additional language support information in Windows operating systems by version, see [Appendix A: Product Behavior](http://msdn.microsoft.com/goglobal/bb896001.aspx) in [MS-LCID]: Windows Language Code Identifier (LCID) Reference.
17-
18-
The C run-time library implementation also supports the following additional country/region strings and abbreviations:
19-
20-
|Country/region string|Abbreviation|Equivalent locale name|
21-
|----------------------------|------------------|----------------------------|
22-
|america|USA|en-US|
23-
|britain|GBR|en-GB|
24-
|china|CHN|zh-CN|
25-
|czech|CZE|cs-CZ|
26-
|england|GBR|en-GB|
27-
|great britain|GBR|en-GB|
28-
|holland|NLD|nl-NL|
29-
|hong-kong|HKG|zh-HK|
30-
|new-zealand|NZL|en-NZ|
31-
|nz|NZL|en-NZ|
32-
|pr china|CHN|zh-CN|
33-
|pr-china|CHN|zh-CN|
34-
|puerto-rico|PRI|es-PR|
35-
|slovak|SVK|sk-SK|
36-
|south africa|ZAF|af-ZA|
37-
|south korea|KOR|ko-KR|
38-
|south-africa|ZAF|af-ZA|
39-
|south-korea|KOR|ko-KR|
40-
|trinidad & tobago|TTO|en-TT|
41-
|uk|GBR|en-GB|
42-
|united-kingdom|GBR|en-GB|
43-
|united-states|USA|en-US|
44-
|us|USA|en-US|
45-
46-
## See Also
47-
[Locale Names, Languages, and Country/Region Strings](../c-runtime-library/locale-names-languages-and-country-region-strings.md)
48-
[Language Strings](../c-runtime-library/language-strings.md)
49-
[setlocale, _wsetlocale](../c-runtime-library/reference/setlocale-wsetlocale.md)
50-
[_create_locale, _wcreate_locale](../c-runtime-library/reference/create-locale-wcreate-locale.md)
16+
17+
Country and region strings can be combined with a language string to create a locale specification for the `setlocale`, `_wsetlocale`, `_create_locale`, and `_wcreate_locale` functions. For lists of country and region names that are supported by various Windows operating system versions, see the **Language**, **Location**, and **Language tag** columns of the table in [Appendix A: Product Behavior](https://msdn.microsoft.com/library/cc233982.aspx) in [MS-LCID]: Windows Language Code Identifier (LCID) Reference. For an example of code that enumerates available locale names and related values, see [NLS: Name-based APIs Sample](/windows/desktop/intl/nls--name-based-apis-sample).
18+
19+
## Additional supported country and region strings
20+
21+
The Microsoft C run-time library implementation also supports the following additional country/region strings and abbreviations:
22+
23+
|Country/region string|Abbreviation|Equivalent locale name|
24+
|----------------------------|------------------|----------------------------|
25+
|america|USA|en-US|
26+
|britain|GBR|en-GB|
27+
|china|CHN|zh-CN|
28+
|czech|CZE|cs-CZ|
29+
|england|GBR|en-GB|
30+
|great britain|GBR|en-GB|
31+
|holland|NLD|nl-NL|
32+
|hong-kong|HKG|zh-HK|
33+
|new-zealand|NZL|en-NZ|
34+
|nz|NZL|en-NZ|
35+
|pr china|CHN|zh-CN|
36+
|pr-china|CHN|zh-CN|
37+
|puerto-rico|PRI|es-PR|
38+
|slovak|SVK|sk-SK|
39+
|south africa|ZAF|af-ZA|
40+
|south korea|KOR|ko-KR|
41+
|south-africa|ZAF|af-ZA|
42+
|south-korea|KOR|ko-KR|
43+
|trinidad & tobago|TTO|en-TT|
44+
|uk|GBR|en-GB|
45+
|united-kingdom|GBR|en-GB|
46+
|united-states|USA|en-US|
47+
|us|USA|en-US|
48+
49+
## See also
50+
51+
[Locale Names, Languages, and Country/Region Strings](../c-runtime-library/locale-names-languages-and-country-region-strings.md)
52+
[Language Strings](../c-runtime-library/language-strings.md)
53+
[setlocale, _wsetlocale](../c-runtime-library/reference/setlocale-wsetlocale.md)
54+
[_create_locale, _wcreate_locale](../c-runtime-library/reference/create-locale-wcreate-locale.md)

‎docs/c-runtime-library/language-strings.md

+81-77
Original file line numberDiff line numberDiff line change
@@ -13,80 +13,84 @@ ms.author: "corob"
1313
ms.workload: ["cplusplus"]
1414
---
1515
# Language Strings
16-
The `setlocale` and `_create_locale` functions can use the Windows NLS API supported languages on operating systems that do not use the Unicode code page. For a list of supported languages by operating system version, see [National Language Support (NLS) API Reference](https://www.microsoft.com/resources/msdn/goglobal/default.mspx). The language string can be any of the values in the **Language** and **Language name abbreviation** columns of the list of supported languages. For additional information on language support by operating system version, see [Appendix A: Product Behavior](http://msdn.microsoft.com/goglobal/bb896001.aspx) in [MS-LCID]: Windows Language Code Identifier (LCID) Reference.
17-
18-
The C run-time library implementation also supports these language strings:
19-
20-
|Language string|Equivalent Locale Name|
21-
|---------------------|----------------------------|
22-
|american|en-US|
23-
|american english|en-US|
24-
|american-english|en-US|
25-
|australian|en-AU|
26-
|belgian|nl-BE|
27-
|canadian|en-CA|
28-
|chh|zh-HK|
29-
|chi|zh-SG|
30-
|chinese|zh|
31-
|chinese-hongkong|zh-HK|
32-
|chinese-simplified|zh-CN|
33-
|chinese-singapore|zh-SG|
34-
|chinese-traditional|zh-TW|
35-
|dutch-belgian|nl-BE|
36-
|english-american|en-US|
37-
|english-aus|en-AU|
38-
|english-belize|en-BZ|
39-
|english-can|en-CA|
40-
|english-caribbean|en-029|
41-
|english-ire|en-IE|
42-
|english-jamaica|en-JM|
43-
|english-nz|en-NZ|
44-
|english-south africa|en-ZA|
45-
|english-trinidad y tobago|en-TT|
46-
|english-uk|en-GB|
47-
|english-us|en-US|
48-
|english-usa|en-US|
49-
|french-belgian|fr-BE|
50-
|french-canadian|fr-CA|
51-
|french-luxembourg|fr-LU|
52-
|french-swiss|fr-CH|
53-
|german-austrian|de-AT|
54-
|german-lichtenstein|de-LI|
55-
|german-luxembourg|de-LU|
56-
|german-swiss|de-CH|
57-
|irish-english|en-IE|
58-
|italian-swiss|it-CH|
59-
|norwegian|no|
60-
|norwegian-bokmal|nb-NO|
61-
|norwegian-nynorsk|nn-NO|
62-
|portuguese-brazilian|pt-BR|
63-
|spanish-argentina|es-AR|
64-
|spanish-bolivia|es-BO|
65-
|spanish-chile|es-CL|
66-
|spanish-colombia|es-CO|
67-
|spanish-costa rica|es-CR|
68-
|spanish-dominican republic|es-DO|
69-
|spanish-ecuador|es-EC|
70-
|spanish-el salvador|es-SV|
71-
|spanish-guatemala|es-GT|
72-
|spanish-honduras|es-HN|
73-
|spanish-mexican|es-MX|
74-
|spanish-modern|es-ES|
75-
|spanish-nicaragua|es-NI|
76-
|spanish-panama|es-PA|
77-
|spanish-paraguay|es-PY|
78-
|spanish-peru|es-PE|
79-
|spanish-puerto rico|es-PR|
80-
|spanish-uruguay|es-UY|
81-
|spanish-venezuela|es-VE|
82-
|swedish-finland|sv-FI|
83-
|swiss|de-CH|
84-
|uk|en-GB|
85-
|us|en-US|
86-
|usa|en-US|
87-
88-
## See Also
89-
[Locale Names, Languages, and Country/Region Strings](../c-runtime-library/locale-names-languages-and-country-region-strings.md)
90-
[Country/Region Strings](../c-runtime-library/country-region-strings.md)
91-
[setlocale, _wsetlocale](../c-runtime-library/reference/setlocale-wsetlocale.md)
92-
[_create_locale, _wcreate_locale](../c-runtime-library/reference/create-locale-wcreate-locale.md)
16+
17+
The [setlocale](../c-runtime-library/reference/setlocale-wsetlocale.md) and [_create_locale](../c-runtime-library/reference/create-locale-wcreate-locale.md) functions can use the Windows NLS API supported languages on operating systems that do not use the Unicode code page. For a list of supported languages by operating system version, see [Appendix A: Product Behavior](https://msdn.microsoft.com/library/cc233982.aspx) in [MS-LCID]: Windows Language Code Identifier (LCID) Reference. The language string can be any of the values in the **Language** and **Language tag** columns of the list of supported languages. For an example of code that enumerates available locale names and related values, see [NLS: Name-based APIs Sample](/windows/desktop/intl/nls--name-based-apis-sample).
18+
19+
## Additional supported language strings
20+
21+
The Microsoft C run-time library implementation also supports these language strings:
22+
23+
|Language string|Equivalent Locale Name|
24+
|---------------------|----------------------------|
25+
|american|en-US|
26+
|american english|en-US|
27+
|american-english|en-US|
28+
|australian|en-AU|
29+
|belgian|nl-BE|
30+
|canadian|en-CA|
31+
|chh|zh-HK|
32+
|chi|zh-SG|
33+
|chinese|zh|
34+
|chinese-hongkong|zh-HK|
35+
|chinese-simplified|zh-CN|
36+
|chinese-singapore|zh-SG|
37+
|chinese-traditional|zh-TW|
38+
|dutch-belgian|nl-BE|
39+
|english-american|en-US|
40+
|english-aus|en-AU|
41+
|english-belize|en-BZ|
42+
|english-can|en-CA|
43+
|english-caribbean|en-029|
44+
|english-ire|en-IE|
45+
|english-jamaica|en-JM|
46+
|english-nz|en-NZ|
47+
|english-south africa|en-ZA|
48+
|english-trinidad y tobago|en-TT|
49+
|english-uk|en-GB|
50+
|english-us|en-US|
51+
|english-usa|en-US|
52+
|french-belgian|fr-BE|
53+
|french-canadian|fr-CA|
54+
|french-luxembourg|fr-LU|
55+
|french-swiss|fr-CH|
56+
|german-austrian|de-AT|
57+
|german-lichtenstein|de-LI|
58+
|german-luxembourg|de-LU|
59+
|german-swiss|de-CH|
60+
|irish-english|en-IE|
61+
|italian-swiss|it-CH|
62+
|norwegian|no|
63+
|norwegian-bokmal|nb-NO|
64+
|norwegian-nynorsk|nn-NO|
65+
|portuguese-brazilian|pt-BR|
66+
|spanish-argentina|es-AR|
67+
|spanish-bolivia|es-BO|
68+
|spanish-chile|es-CL|
69+
|spanish-colombia|es-CO|
70+
|spanish-costa rica|es-CR|
71+
|spanish-dominican republic|es-DO|
72+
|spanish-ecuador|es-EC|
73+
|spanish-el salvador|es-SV|
74+
|spanish-guatemala|es-GT|
75+
|spanish-honduras|es-HN|
76+
|spanish-mexican|es-MX|
77+
|spanish-modern|es-ES|
78+
|spanish-nicaragua|es-NI|
79+
|spanish-panama|es-PA|
80+
|spanish-paraguay|es-PY|
81+
|spanish-peru|es-PE|
82+
|spanish-puerto rico|es-PR|
83+
|spanish-uruguay|es-UY|
84+
|spanish-venezuela|es-VE|
85+
|swedish-finland|sv-FI|
86+
|swiss|de-CH|
87+
|uk|en-GB|
88+
|us|en-US|
89+
|usa|en-US|
90+
91+
## See also
92+
93+
[Locale Names, Languages, and Country/Region Strings](../c-runtime-library/locale-names-languages-and-country-region-strings.md)
94+
[Country/Region Strings](../c-runtime-library/country-region-strings.md)
95+
[setlocale, _wsetlocale](../c-runtime-library/reference/setlocale-wsetlocale.md)
96+
[_create_locale, _wcreate_locale](../c-runtime-library/reference/create-locale-wcreate-locale.md)

0 commit comments

Comments
 (0)