# 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 版本號的字符串。
