NLS:国际化域名转换示例
本主题中介绍的示例应用程序演示了如何使用某些 NLS 函数将 国际化域名 (IDN) 转换。 此应用程序演示以下 NLS API 函数:
在示例输出中,请注意,对于西里尔文示例,“ExAmPlE.cOm”将转换为“русский.example.com”。
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
// IdnConversion.cpp
#include "stdafx.h"
#include "windows.h"
#include <stdio.h>
#include <tchar.h>
#define IDN_MAX_LENGTH 255
// Print out a string using code points for the non-ASCII values
void DumpString(LPCWSTR pInput)
{
while (*pInput != 0)
{
if (*pInput < 0x80)
wprintf(L"%c", *pInput);
else
wprintf(L"\\x%4.4x", *pInput);
pInput++;
}
wprintf(L"\n");
}
// Convert some IDN strings
void IdnConvert(LPCWSTR strInput)
{
// Show string we're converting
wprintf(L"Converting string: ");
DumpString(strInput);
// Convert it to IDN "Punycode" form. Note that IDN names have a maximum length,
// so we'll just use a hard coded buffer size.
WCHAR pPunycode[IDN_MAX_LENGTH];
if (IdnToAscii(0, strInput, -1, pPunycode, IDN_MAX_LENGTH) == 0)
{
wprintf(L"ERROR %d converting to Punycode\n", GetLastError());
}
else
{
// Output it, safe to just wprintf to console because it has to be ASCII
wprintf(L" Punycode value: %s\n", pPunycode);
// Convert it to IDN normalized Unicode
WCHAR pUnicode[IDN_MAX_LENGTH];
if (IdnToNameprepUnicode(0, strInput, -1, pUnicode, IDN_MAX_LENGTH) == 0)
{
wprintf(L"ERROR %d converting to nameprep Unicode\n", GetLastError());
}
else
{
wprintf(L" Nameprep value: ");
DumpString(pUnicode);
}
// Convert the punycode string back to Unicode
if (IdnToUnicode(0, pPunycode, -1, pUnicode, IDN_MAX_LENGTH) == 0)
{
wprintf(L"ERROR %d converting back to Unicode\n", GetLastError());
}
else
{
// Note that this round-trip value should be the same as the nameprep value above
wprintf(L" Unicode value: ");
DumpString(pUnicode);
}
}
wprintf(L"\n");
}
int __cdecl wmain(int argc, WCHAR* argv[])
{
// Non-IDN names do not change
IdnConvert(L"ExAmPlE.cOm");
// Show some idn conversions. Note that some characters change
IdnConvert(L"русский.ExAmPlE.cOm");
IdnConvert(L"日本語.example.com");
IdnConvert(L"Fullwidth。example。com。");
// Some characters are illegal in IDN names
IdnConvert(L"\x9fa5\x9fff\x00\x7f");
}
/* This code example produces the following output:
Converting string: ExAmPlE.cOm
Punycode value: ExAmPlE.cOm
Nameprep value: ExAmPlE.cOm
Unicode value: ExAmPlE.cOm
Converting string: \x0440\x0443\x0441\x0441\x043a\x0438\x0439.ExAmPlE.cOm
Punycode value: xn--h1acbxfam.example.com
Nameprep value: \x0440\x0443\x0441\x0441\x043a\x0438\x0439.example.com
Unicode value: \x0440\x0443\x0441\x0441\x043a\x0438\x0439.example.com
Converting string: \x65e5\x672c\x8a9e.example.com
Punycode value: xn--wgv71a119e.example.com
Nameprep value: \x65e5\x672c\x8a9e.example.com
Unicode value: \x65e5\x672c\x8a9e.example.com
Converting string: \xff26\xff55\xff4c\xff4c\xff57\xff49\xff44\xff54\xff48\x3002example\x3002com\x3002
Punycode value: fullwidth.example.com.
Nameprep value: fullwidth.example.com.
Unicode value: fullwidth.example.com.
Converting string: \x9fa5\x9fff
ERROR 123 converting to Punycode
*/