String.prototype.charCodeAt()

Try it

const sentence = "The quick brown fox jumps over the lazy dog.";

const index = 4;

console.log(
  `Character code ${sentence.charCodeAt(index)} is equal to ${sentence.charAt(
    index,
  )}`,
);
// Expected output: "Character code 113 is equal to q"

Cú pháp

charCodeAt(index)

Tham số

index

Chỉ mục bắt đầu từ 0 của ký tự cần trả về. Được chuyển đổi thành số nguyên — undefined được chuyển đổi thành 0.

Giá trị trả về

Một số nguyên từ 0 đến 65535 biểu diễn giá trị đơn vị code UTF-16 của ký tự tại index được chỉ định. Nếu index nằm ngoài phạm vi 0 – str.length - 1, charCodeAt() trả về NaN.

Mô tả

Các ký tự trong một string được đánh chỉ mục từ trái sang phải. Chỉ mục của ký tự đầu tiên là 0, và chỉ mục của ký tự cuối cùng trong một string có tên str là str.length - 1.

Các code point Unicode có phạm vi từ 0 đến 1114111 (0x10FFFF). charCodeAt() luôn trả về một giá trị nhỏ hơn 65536, bởi vì các code point cao hơn được biểu diễn bởi một cặp pseudo-character surrogate 16-bit. Do đó, để lấy một ký tự đầy đủ có giá trị lớn hơn 65535, cần lấy không chỉ charCodeAt(i), mà còn charCodeAt(i + 1) (như thể đang xử lý một string có hai ký tự), hoặc sử dụng codePointAt(i) thay thế. Để biết thông tin về Unicode, xem UTF-16 characters, Unicode code points, and grapheme clusters.

Ví dụ

Sử dụng charCodeAt()

Ví dụ sau trả về 65, giá trị Unicode cho A.

"ABC".charCodeAt(0); // returns 65

charCodeAt() có thể trả về các surrogate đơn lẻ, không phải là các ký tự Unicode hợp lệ.

const str = "𠮷𠮾";
console.log(str.charCodeAt(0)); // 55362, or d842, which is not a valid Unicode character
console.log(str.charCodeAt(1)); // 57271, or dfb7, which is not a valid Unicode character

Để lấy toàn bộ code point Unicode tại chỉ mục đã cho, hãy sử dụng String.prototype.codePointAt().

const str = "𠮷𠮾";
console.log(str.codePointAt(0)); // 134071

Dưới đây là một thuật toán có thể để chuyển đổi một cặp đơn vị code UTF-16 thành một code point Unicode, được điều chỉnh từ Unicode FAQ:

// constants
const LEAD_OFFSET = 0xd800 - (0x10000 >> 10);
const SURROGATE_OFFSET = 0x10000 - (0xd800 << 10) - 0xdc00;

function utf16ToUnicode(lead, trail) {
  return (lead << 10) + trail + SURROGATE_OFFSET;
}
function unicodeToUTF16(codePoint) {
  const lead = LEAD_OFFSET + (codePoint >> 10);
  const trail = 0xdc00 + (codePoint & 0x3ff);
  return [lead, trail];
}

const str = "𠮷";
console.log(utf16ToUnicode(str.charCodeAt(0), str.charCodeAt(1))); // 134071
console.log(str.codePointAt(0)); // 134071

Đặc tả

Tương thích trình duyệt

Xem thêm

• String.fromCharCode()
• String.prototype.charAt()
• String.fromCodePoint()
• String.prototype.codePointAt()