JavaScript String split() メソッド

定義と使用法

split() メソッドは文字列をサブストリングの配列に分割します。

split() メソッドは新しい配列を返しますが、元の文字列は変更されません。

空白文字（" ")が区切符として使用される場合、文字列は単語間で分割されます。

参照：

slice() メソッド

substr() メソッド

substring() メソッド

例

例 1

単語を分割します：

let text = "How are you doing today?";
const myArray = text.split(" ");

自分で試してみてください

例 2

単語を分割し、2番目の単語を返します：

let text = "How are you doing today?";
const myArray = text.split(" ");
let word = myArray[1];

自分で試してみてください

例 3

スペースを含む文字を分割します：

const myArray = text.split("");

自分で試してみてください

例 4

limit パラメータを使用して：

const myArray = text.split(" ", 3);

自分で試してみてください

例 5

文字列を文字に分割し、2番目の文字を返します：

const myArray = text.split("");

自分で試してみてください

例 6

アルファベットを使用して区切ります：

const myArray = text.split("o");

自分で試してみてください

例 7

separator パラメータを省略した場合、元の文字列を含む配列が返されます：

const myArray = text.split();

自分で試してみてください

文法

string.split(','}separator, limit)

パラメータ

パラメータ 説明
separator

オプションです。分割する文字列または正規表現として使用されます。

省略された場合、元の文字列を含む配列が返されます。
limit

オプション。分割数を制限する整数。

制限を超えた項目は除外されます。

返値

タイプ 説明
Array 分割された値を含む配列。

技術的な詳細

パラメータ separator

このパラメータは文字列または正規表現であり、このパラメータで指定された場所から分割されます。 string。

パラメータ limit

このオプションの整数は、返される配列の最大長さを指定します。このパラメータが設定されている場合、返される部分文字列はこのパラメータで指定された数字より多くは含まれません。パラメータが設定されていない場合、文字列全体が分割され、その長さに関係なく考慮されます。

返値

で返されます。 separator 配列を返します。この配列は、 string の指定された境界で文字列を分割 separator 自身で分割されます。返される配列の部分文字列には、指定された境界に一致する文字列が含まれません。

があれば、 separator が子表現式を含む正規表現である場合、返される配列にはこれらの子表現式に一致する文字列が含まれますが、全体の正規表現に一致するテキストは含まれません。

説明

split() メソッドは、指定された文字列を基に配列を作成し、返します。配列の要素は指定された文字列です。 string の部分文字列、最大で limit 個の。これらの部分文字列は、文字列を先頭から終わりまで検索して取得されます。 separator の文字列、最大で string 一致するテキスト、一致するテキストの前後で分割 limit 取得されます。返される部分文字列には区切り文字が含まれません（本節の最後に述べた場合を除きます）。区切り文字が文字列の先頭から一致する場合、返される配列の最初の要素は空文字列であり、区切り文字の前のテキストが表示されます。同様に、区切り文字が文字列の末尾に一致する場合、返される配列の最後の要素も空文字列です（仮定）。

矛盾はありません）。 separator指定されていない場合 string 、それが正しくない separator が空文字列または空文字列に一致する正規表現である場合、分割を実行し、返される配列には要素が1つだけあり、文字列は分割されません。 string の各文字間で分割されます。返される配列の長さは文字列の長さと同じです（仮定）。 limit の長さ以上（注意：これは特別な場合であり、最初の文字と最後の文字の前後の空文字列は一致しません）。

前述の通り、このメソッドで返される配列の部分文字列には、文字列を分割するための区切り文字が含まれませんが、 separator 子表現式を含む正規表現があれば、返される配列にはこれらの子表現式に一致する部分文字列が含まれますが、全体の正規表現に一致するテキストは含まれません。

注意：string.split() 実行される操作は Array.join() 逆の操作を実行します。

ブラウザのサポート

split() ECMAScript1（ES1）の機能です。

すべてのブラウザは完全にES1（JavaScript 1997）をサポートしています：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート サポート サポート サポート サポート サポート

関連ページ

JavaScript 文字列

JavaScript 文字列メソッド

JavaScript 文字列検索