# punycode
~~~
稳定度: 2 - 不稳定
~~~
[Punycode.js](http://mths.be/punycode) 自 Node.js v0.6.2+ 开始被内置，通过 `require('punycode')` 引入。（要在其它 Node.js 版本中使用它，请先使用 npm 安装 `punycode` 模块。）
### punycode.decode(string)
将一个纯 ASCII 符号的 Punycode 字符串转换为 Unicode 符号的字符串。
~~~
// 解码域名部分
punycode.decode('maana-pta'); // 'mañana'
punycode.decode('--dqo34k'); // '☃-⌘'
~~~
### punycode.encode(string)
将一个 Unicode 符号的字符串转换为纯 ASCII 符号的 Punycode 字符串。
~~~
// 编码域名部分
punycode.encode('mañana'); // 'maana-pta'
punycode.encode('☃-⌘'); // '--dqo34k'
~~~
### punycode.toUnicode(domain)
将一个表示域名的 Punycode 字符串转换为 Unicode。只有域名中的 Punycode 部分会转换，也就是说您在一个已经转换为 Unicode 的字符串上调用它也是没问题的。
~~~
// 解码域名
punycode.toUnicode('xn--maana-pta.com'); // 'mañana.com'
punycode.toUnicode('xn----dqo34k.com'); // '☃-⌘.com'
~~~
### punycode.toASCII(domain)
将一个表示域名的 Unicode 字符串转换为 Punycode。只有域名的非 ASCII 部分会被转换，也就是说您在一个已经是 ASCII 的域名上调用它也是没问题的。
~~~
// 编码域名
punycode.toASCII('mañana.com'); // 'xn--maana-pta.com'
punycode.toASCII('☃-⌘.com'); // 'xn----dqo34k.com'
~~~
### punycode.ucs2
### punycode.ucs2.decode(string)
创建一个数组，包含字符串中每个 Unicode 符号的数字编码点。由于 [JavaScript 在内部使用 UCS-2](http://mathiasbynens.be/notes/javascript-encoding)， 该函数会按照 UTF-16 将一对代半数（UCS-2 暴露的单独的字符）转换为单独一个编码点。
~~~
punycode.ucs2.decode('abc'); // [0x61, 0x62, 0x63]
// surrogate pair for U+1D306 tetragram for centre:
punycode.ucs2.decode('\uD834\uDF06'); // [0x1D306]
~~~
### punycode.ucs2.encode(codePoints)
以数字编码点的值的数组创建一个字符串。
~~~
punycode.ucs2.encode([0x61, 0x62, 0x63]); // 'abc'
punycode.ucs2.encode([0x1D306]); // '\uD834\uDF06'
~~~
### punycode.version
表示当前 Punycode.js 版本号的字符串。
