String.prototype.charCodeAt()

시도해 보기

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"

구문

charCodeAt(index)

매개변수

index

반환할 문자의 0 기반 인덱스. 정수로 변환되는 원칙에 따라 undefined은 0으로 변환됩니다.

반환 값

명시된 index에 있는 문자의 UTF-16 코드 단위 값를 표현하는 0 부터 65535사이의 정수입니다. 만약 index가 0부터 str.length - 1 사이의 범위를 벗어난다면 charCodeAt()은 NaN을 반환합니다.

설명

문자열의 문자는 왼쪽에서 오른쪽으로 색인됩니다. 첫 번째 문자의 인덱스는 0이고 str이라 불리는 문자열의 마지막 문자열의 인덱스는 str.length - 1입니다.

유니코드 코드 포인트 범위는 0에서 1114111(0x10FFFF)까지입니다. 더 높은 코드 포인트는 16비트 의사 문자의 서로게이트로 표현되기 때문에 charCodeAt()은 항상 65536보다 작은 값을 반환합니다. 따라서 65535보다 큰 값을 가진 전체 문자를 얻으려면 charCodeAt(i)뿐만 아니라 charCodeAt(i + 1)도 검색하거나(두 문자로 된 문자열을 조작하는 것처럼) codePointAt(i)를 대신 사용해야 합니다. 유니코드에 대해 정보를 더 알고 싶으시면 UTF-16 문자, 유니코드 코드 포인트 그리고 그래프 클러스터를 참고하시기 바랍니다.

예제

charCodeAt() 사용하기

다음 예제는 유니코드 값 A에 해당하는 65를 반환합니다.

"ABC".charCodeAt(0); // 65 반환

charCodeAt()은 유효한 유니코드 문자가 아닌 ë¡  서로게이트(lone surrogates)를 반환할 수 있습니다.

const str = "ð ®·ð ®¾";
console.log(str.charCodeAt(0)); // 유효한 유니코드 문자가 아닌 55362, 혹은 d842
console.log(str.charCodeAt(1)); // 유효한 유니코드 문자가 아닌 57271, 혹은 dfb7

주어진 인덱스의 온전한 유니코드 코드 포인트를 얻기 위해서는 String.prototype.codePointAt()를 사용하세요.

const str = "ð ®·ð ®¾";
console.log(str.codePointAt(0)); // 134071

아래는 유니코드 FAQ에서 발췌한 UTF-16 코드 단위 쌍을 유니코드 코드 포인트로 변환하는 가능한 알고리즘입니다.

// 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

명세서

브라우저 호환성

같이 보기

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