萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript String.prototype.charCodeAt() 完整指南:取得 UTF-16 代碼單元值

前言

charCodeAt(index) 回傳指定索引的 UTF-16 代碼單元值(0~65535)。對於增補字元(>U+FFFF),只能取得高代理項,完整碼點請用 codePointAt()。

語法

str.charCodeAt(index)

參數與回傳

  • index:0 到 length-1。省略預設 0。超出回傳 NaN。
  • 回傳:無號 16 位整數 (0~65535)。

基本範例

<script>
const str = 'ABC';

console.log(str.charCodeAt(0)); // 65 ('A')
console.log(str.charCodeAt(1)); // 66 ('B')
console.log(str.charCodeAt(2)); // 67 ('C')
console.log(str.charCodeAt(3)); // NaN

// 空白鍵
console.log(' '.charCodeAt(0)); // 32
</script>

增補字元問題

<script>
const emoji = '😀'; // U+1F600
console.log(emoji.length);           // 2
console.log(emoji.charCodeAt(0));    // 55357 (高代理項 0xD83D)
console.log(emoji.charCodeAt(1));    // 56832 (低代理項 0xDE00)

// 正確取得碼點
console.log(emoji.codePointAt(0));   // 128512 (0x1F600)
console.log(emoji.codePointAt(1));   // 56832 (低代理項)
</script>

實用應用:簡單加密/雜湊

function simpleHash(str) {
  let hash = 0;
  for (let i = 0; i < str.length; i++) {
    hash = ((hash << 5) - hash) + str.charCodeAt(i);
    hash |= 0; // 轉 32bit 整數
  }
  return hash;
}

console.log(simpleHash('hello')); // -123456789 (示例)

charCodeAt() vs codePointAt()

方法回傳值增補字元支援適用場景
charCodeAt()UTF-16 代碼單元 (0~65535)僅高代理項ASCII/BMP 字元、簡單雜湊、舊代碼相容
codePointAt()Unicode 碼點 (0~0x10FFFF)完整支援Emoji、罕用漢字、國際化處理

總結

charCodeAt() 為經典 UTF-16 代碼單元取得方法。處理現代 Unicode 字串(含 Emoji)時,務必改用 codePointAt() 並搭配 `for...of` 迭代,避免代理對拆分錯誤。

copyright © 萬盛學電腦網 all rights reserved