文字列に指定の文字列が含まれているか検索する(includes)

広告

String オブジェクトのインスタンスメソッドである includes は、対象の文字列に指定の文字列が含まれているか検索し true または false を返します。ここでは String オブジェクトの includes メソッドの使い方について解説します。

文字列を検索する(includes)

String オブジェクトの includes メソッドは、対象の文字列に指定した文字列が含まれるかどうかを検索し、見つかった場合は true を、見つからなかった場合は false を返します。書式は次のとおりです。

文字列.includes(検索文字列 [, 開始インデックス])

最初の引数に検索する文字列を指定します。検索は対象の文字列の先頭から開始しますが、 2 番目の引数で検索を開始するインデックスを指定することもできます。見つかれば true を返し、見つからなかった場合は false が返ります。

次のサンプルをみてください。

let str = 'Blue Red Yellow';

console.log(str.includes('Red'));
--> true

console.log(str.includes('Red', 7));
--> false

console.log(str.includes('Green'));
--> false

文字列を検索する(includes)(1)

対象の文字列には 'Red' は含まれているので true を返しますが、検索開始位置として 7 を指定した場合はそれ以降では 'Red' は見つからないため false が返されます。 'Green' は文字列に含まれていないので false が返されます。

文字列を検索する(includes)(2)

-- --

String オブジェクトの includes メソッドの使い方について解説しました。

( Written by Tatsuo Ikura )

関連記事 (一部広告含む)
Profile
profile_img

著者 / TATSUO IKURA

初心者~中級者の方を対象としたプログラミング方法や開発環境の構築の解説を行うサイトの運営を行っています。