#### Stability: 2 - Stable
`Punycode.js`在`io.js` v1.0.0+ 和 `Node.js` v0.6.2+ 中被內置。通過`require('punycode')`來獲取它(若要在其他版本的`io.js`中使用它,需要先通過npm來安裝`punycode`模塊)。
#### punycode.decode(string)
轉換一個純ASCII符號 `Punycode`字符串為一個`Unicode`符號的字符串。
~~~
// decode domain name parts
punycode.decode('maana-pta'); // 'ma?ana'
punycode.decode('--dqo34k'); // '?-?'
~~~
#### punycode.encode(string)
轉換一個`Unicode`符號的字符串為一個純ASCII符號 `Punycode`字符串。
~~~
// encode domain name parts
punycode.encode('ma?ana'); // 'maana-pta'
punycode.encode('?-?'); // '--dqo34k'
~~~
#### punycode.toUnicode(domain)
轉換一個代表了一個域名的`Punycode`字符串為一個`Unicode`字符串。只有代表了域名的部分的`Punycode`字符串會被轉換。也就是說,如果你調用了一個已經被轉換為`Unicode`的字符串,也是沒有問題的。
~~~
// decode domain names
punycode.toUnicode('xn--maana-pta.com'); // 'ma?ana.com'
punycode.toUnicode('xn----dqo34k.com'); // '?-?.com'
~~~
#### punycode.toASCII(domain)
轉換一個代表了一個域名的`Unicode`字符串為一個`Unicode`字符串。只有代表了域名的部分的非ASCII字符串會被轉換。也就是說,如果你調用了一個已經被轉換為ASCII的字符串,也是沒有問題的。
~~~
// encode domain names
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`,這個函數會將一對代理部分(surrogate halves)(UCS-2暴露的單獨字符)轉換為一個單獨的編碼點 來匹配UTF-16。
~~~
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`版本號的數字。