【Node.js24.x】String::codePointAt()メソッドの使い方
codePointAtメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
codePointAtメソッドは、指定されたインデックス位置にある文字のUnicodeコードポイントを返すメソッドです。このメソッドは、引数として0から始まる文字列内のインデックス（位置）を受け取ります。戻り値は、指定されたインデックス位置の文字に対応するUnicodeコードポイント（非負の整数）です。もし指定されたインデックスが文字列の範囲外である場合や、無効な場合は、undefinedを返します。
JavaScriptの文字列は内部的にUTF-16形式で表現されており、一部の特殊な文字や絵文字などは、2つの16ビットコードユニット（サロゲートペア）を使って表現されます。従来のcharCodeAtメソッドは、これらのサロゲートペアを個別の16ビットコードユニットとして扱ってしまうため、完全な文字のコードポイントを正確に取得できない場合があります。
codePointAtメソッドは、この問題を解決し、サロゲートペアを正しく認識して、その文字全体を表す単一の完全なUnicodeコードポイントを返します。これにより、多言語対応のアプリケーション開発や、絵文字、特殊記号などの幅広い文字を正確に処理する必要がある場合に非常に有用です。例えば、ユーザーが入力した文字列中の特定の文字が絵文字であるかを判別したり、文字列の視覚的な長さを正しく計算したりする際に役立ちます。システムエンジニアを目指す上で、Unicode文字の正確な扱いは非常に重要であり、このメソッドはその基礎となる機能の一つです。
構文(syntax)
1const str = "example"; 2const codePoint = str.codePointAt(0);
引数(parameters)
pos
- pos: number: コードポイントを取得したい文字列中の位置（インデックス）を指定する数値
戻り値(return)
number
指定されたインデックス位置にあるコードポイントの数値（整数）を返します。