{
  "source": "punycode.markdown",
  "modules": [
    {
      "textRaw": "punycode",
      "name": "punycode",
      "desc": "<pre><code>稳定度: 2 - 不稳定</code></pre>\n<p><a href=\"http://mths.be/punycode\">Punycode.js</a> is bundled with Node.js v0.6.2+. Use\n<code>require(&apos;punycode&apos;)</code> to access it. (To use it with other Node.js versions,\nuse npm to install the <code>punycode</code> module first.)\n\n</p>\n<p><a href=\"http://mths.be/punycode\">Punycode.js</a> 自 Node.js v0.6.2+ 开始被内置，通过 <code>require(&apos;punycode&apos;)</code> 引入。（要在其它 Node.js 版本中使用它，请先使用 npm 安装 <code>punycode</code> 模块。）\n\n</p>\n",
      "methods": [
        {
          "textRaw": "punycode.decode(string)",
          "type": "method",
          "name": "decode",
          "desc": "<p>Converts a Punycode string of ASCII-only symbols to a string of Unicode symbols.\n\n</p>\n<p>将一个纯 ASCII 符号的 Punycode 字符串转换为 Unicode 符号的字符串。\n\n</p>\n<pre><code>// 解码域名部分\npunycode.decode(&apos;maana-pta&apos;); // &apos;mañana&apos;\npunycode.decode(&apos;--dqo34k&apos;); // &apos;☃-⌘&apos;</code></pre>\n",
          "signatures": [
            {
              "params": [
                {
                  "name": "string"
                }
              ]
            }
          ]
        },
        {
          "textRaw": "punycode.encode(string)",
          "type": "method",
          "name": "encode",
          "desc": "<p>Converts a string of Unicode symbols to a Punycode string of ASCII-only symbols.\n\n</p>\n<p>将一个 Unicode 符号的字符串转换为纯 ASCII 符号的 Punycode 字符串。\n\n</p>\n<pre><code>// 编码域名部分\npunycode.encode(&apos;mañana&apos;); // &apos;maana-pta&apos;\npunycode.encode(&apos;☃-⌘&apos;); // &apos;--dqo34k&apos;</code></pre>\n",
          "signatures": [
            {
              "params": [
                {
                  "name": "string"
                }
              ]
            }
          ]
        },
        {
          "textRaw": "punycode.toUnicode(domain)",
          "type": "method",
          "name": "toUnicode",
          "desc": "<p>Converts a Punycode string representing a domain name to Unicode. Only the\nPunycoded parts of the domain name will be converted, i.e. it doesn&apos;t matter if\nyou call it on a string that has already been converted to Unicode.\n\n</p>\n<p>将一个表示域名的 Punycode 字符串转换为 Unicode。只有域名中的 Punycode 部分会转换，也就是说您在一个已经转换为 Unicode 的字符串上调用它也是没问题的。\n\n</p>\n<pre><code>// 解码域名\npunycode.toUnicode(&apos;xn--maana-pta.com&apos;); // &apos;mañana.com&apos;\npunycode.toUnicode(&apos;xn----dqo34k.com&apos;); // &apos;☃-⌘.com&apos;</code></pre>\n",
          "signatures": [
            {
              "params": [
                {
                  "name": "domain"
                }
              ]
            }
          ]
        },
        {
          "textRaw": "punycode.toASCII(domain)",
          "type": "method",
          "name": "toASCII",
          "desc": "<p>Converts a Unicode string representing a domain name to Punycode. Only the\nnon-ASCII parts of the domain name will be converted, i.e. it doesn&apos;t matter if\nyou call it with a domain that&apos;s already in ASCII.\n\n</p>\n<p>将一个表示域名的 Unicode 字符串转换为 Punycode。只有域名的非 ASCII 部分会被转换，也就是说您在一个已经是 ASCII 的域名上调用它也是没问题的。\n\n</p>\n<pre><code>// 编码域名\npunycode.toASCII(&apos;mañana.com&apos;); // &apos;xn--maana-pta.com&apos;\npunycode.toASCII(&apos;☃-⌘.com&apos;); // &apos;xn----dqo34k.com&apos;</code></pre>\n",
          "signatures": [
            {
              "params": [
                {
                  "name": "domain"
                }
              ]
            }
          ]
        }
      ],
      "properties": [
        {
          "textRaw": "punycode.ucs2",
          "name": "ucs2",
          "modules": [
            {
              "textRaw": "punycode.ucs2.decode(string)",
              "name": "punycode.ucs2.decode(string)",
              "desc": "<p>Creates an array containing the numeric code point values of each Unicode\nsymbol in the string. While <a href=\"http://mathiasbynens.be/notes/javascript-encoding\">JavaScript uses UCS-2\ninternally</a>, this function\nwill convert a pair of surrogate halves (each of which UCS-2 exposes as\nseparate characters) into a single code point, matching UTF-16.\n\n</p>\n<p>创建一个数组，包含字符串中每个 Unicode 符号的数字编码点。由于 <a href=\"http://mathiasbynens.be/notes/javascript-encoding\">JavaScript 在内部使用 UCS-2</a>，\n该函数会按照 UTF-16 将一对代半数（UCS-2 暴露的单独的字符）转换为单独一个编码点。\n\n</p>\n<pre><code>punycode.ucs2.decode(&apos;abc&apos;); // [0x61, 0x62, 0x63]\n// surrogate pair for U+1D306 tetragram for centre:\npunycode.ucs2.decode(&apos;\\uD834\\uDF06&apos;); // [0x1D306]</code></pre>\n",
              "type": "module",
              "displayName": "punycode.ucs2.decode(string)"
            },
            {
              "textRaw": "punycode.ucs2.encode(codePoints)",
              "name": "punycode.ucs2.encode(codepoints)",
              "desc": "<p>Creates a string based on an array of numeric code point values.\n\n</p>\n<p>以数字编码点的值的数组创建一个字符串。\n\n</p>\n<pre><code>punycode.ucs2.encode([0x61, 0x62, 0x63]); // &apos;abc&apos;\npunycode.ucs2.encode([0x1D306]); // &apos;\\uD834\\uDF06&apos;</code></pre>\n",
              "type": "module",
              "displayName": "punycode.ucs2.encode(codePoints)"
            }
          ]
        },
        {
          "textRaw": "punycode.version",
          "name": "version",
          "desc": "<p>A string representing the current Punycode.js version number.\n\n\n</p>\n<p>表示当前 Punycode.js 版本号的字符串。</p>\n"
        }
      ],
      "type": "module",
      "displayName": "punycode"
    }
  ]
}