String.prototype.concat()

concat() メソッドは、文字列に別の文字列を連結して、新しい文字列として返します。

このインタラクティブなサンプルのソースは GitHub リポジトリに保存されています。インタラクティブなサンプルプロジェクトに貢献したい場合は https://github.com/mdn/interactive-examples をクローンして、プルリクエストを送信してください。

構文

str.concat(string2[, string3, ..., stringN])

引数

string2...stringN

Strings と連結する文字列。

戻り値

提供された文字列を組み合わせたテキストを含む新しい文字列。

説明

concat() 関数は文字列引数を呼び出し文字列に連結し、新しい文字列を返します。元の文字列または返された文字列の変更は、他の文字列には影響しません。引数が文字列型でない場合は、連結前に文字列値に変換されます。

例

例: concat の使用

複数の文字列を連結してコンソールに表示する例を以下に示します。

var hello = 'こんにちは、';
console.log(hello.concat('鈴木さん', '。よい1日を。'));
/* こんにちは、鈴木さん。よい1日を。*/

var greetList = ['こんにちは', ' ', '佐藤さん', '!'];
"".concat(...greetList); // "こんにちは 佐藤さん!"

"".concat({}); // [object Object]
"".concat([]); // ""
"".concat(null); // "null"
"".concat(true); // "true"
"".concat(4, 5); // "45"

パフォーマンス

パフォーマンス上の理由により、このメソッドは用いず、代わりに assignment operators   (+ または +=) を使用する事を強くお勧めします。

仕様

ブラウザ実装状況

このページの互換表は構造化データから生成されます。データに貢献したい場合は https://github.com/mdn/browser-compat-data をチェックし、プルリクエストを送信してください。

関連項目

• Array.prototype.concat()
• Assignment operators