Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】RegExp::RegExp: lastIndexインスタンスデータプロパティの使い方

RegExp: lastIndexインスタンスデータプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

RegExp: lastIndexプロパティは、正規表現オブジェクトが文字列内で次に検索を開始する位置を保持するプロパティです。このプロパティは、正規表現にグローバルフラグ(g)が設定されている場合に特に重要な役割を果たします。グローバルフラグを持つ正規表現に対し、exec()メソッドやtest()メソッドが呼び出されると、lastIndexプロパティの値は自動的に更新されます。

具体的には、前回の正規表現のマッチが成功した場合、そのマッチの直後のインデックス(文字の位置)がlastIndexに設定されます。これにより、次回の検索は前回の終了位置から始まり、文字列全体から複数のマッチを順次見つけることが可能になります。もし検索で一致する部分が見つからなかった場合や、正規表現にグローバルフラグが設定されていない場合、lastIndexプロパティの値は0にリセットされるか、その時点の値から変更されません。

このプロパティは読み書き可能であり、開発者は手動でlastIndexの値を設定することで、次回の検索開始位置を明示的に制御できます。例えば、文字列の特定の位置から検索を強制的に開始したい場合に利用されます。正規表現を使用して文字列から複数のパターンを抽出したり、繰り返し検索を実行したりする際には、lastIndexプロパティの動作を正確に理解しておくことが、意図した結果を得るために不可欠です。

公式リファレンス: RegExp: lastIndex

構文(syntax)

1const regex = /foo/g;
2const str = "foo bar foo baz";
3
4console.log(regex.lastIndex);
5
6regex.exec(str);
7console.log(regex.lastIndex);
8
9regex.exec(str);
10console.log(regex.lastIndex);
11
12regex.lastIndex = 0;
13console.log(regex.lastIndex);

引数(parameters)

引数なし

引数はありません

戻り値(return)

number

RegExp.prototype.lastIndex プロパティは、次回のマッチング検索が開始されるインデックスを示す数値です。グローバル検索 (g フラグ) が設定されている場合に、exec() メソッドによって自動的に更新されます。

関連コンテンツ

関連プログラミング言語