【JSリファレンス】String.prototype.at()

更新日:2024/06/14

初出:ECMAScript2022


String.prototype.at()は、Stringオブジェクト(Stringコンストラクターのインスタンス)プロトタイプチェーンに組み込まれるメソッドです。

コードユニット単位で指定された位置の文字を取得して、返します。
負数で、後方からの相対位置指定が可能です。
範囲外の位置を指定した場合、undefinedを返します。

同じような機能にString.prototype.charAt()があります。
こちらの関数は、負数での位置指定ができません。
また範囲外の位置を指定したとき、空文字("")を返します。

 

■構文

String.prototype.at ( index )
  1. index: 取得する文字の位置。

    省略時は0。
    負数を指定した場合は文字列の最後から相対位置とみます。
    具体的には、lengthプロパティにindexを加算した値が使用される。

取得した文字
指定位置が範囲外の場合は、undefined。

 

■使用例

const text = "あいう🐈";

console.log( text.at(0) ); // あ
console.log( text.at(1) ); // い
console.log( text.at(2) ); // う
console.log( text.at(3) ); // (文字化け)
console.log( text.at(4) ); // (文字化け)
console.log( text.at(3) + text.at(4) ); // 🐈

 // 後方からの参照
console.log( text.at(-4) ); // い

"🐈"は、二つのコードユニットで一文字を表すサロゲートペアの文字です。
上記のコードは、一方のコードユニットのみを取得しているため文字化けします。

 

関連ページ

更新日:2024/06/14

書いた人(管理人):けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない?」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。