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

【JavaScript ECMAScript】TypedArray::TypedArray.prototype.joinインスタンスメソッドの使い方

TypedArray.prototype.join()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

TypedArray.prototype.join()メソッドは、TypedArrayオブジェクトの全ての要素を文字列として結合し、新しい一つの文字列を生成して返すメソッドです。このメソッドは、TypedArrayに格納されている各要素を文字列に変換した後、引数で指定された区切り文字(セパレーター)を間に挟んで結合します。

TypedArrayは、JavaScriptにおいて固定長のバイナリ生データを効率的に扱うためのオブジェクトであり、例えばInt8ArrayやFloat32Arrayなどがこれに該当します。これらは数値データを格納し、特定の目的で使用されます。

join()メソッドには、オプションとしてseparator引数を指定できます。このseparatorは、配列の要素と要素の間に挿入される文字列です。もしseparatorが省略された場合、デフォルトではコンマ (,) が区切り文字として使用されます。また、separatorとして空文字列 ('') を指定すると、要素が区切り文字なしで直接結合されます。

このメソッドの振る舞いは、一般的なJavaScriptの配列(Array)が持つArray.prototype.join()メソッドと非常に似ており、TypedArrayの要素を可読性のある文字列形式で表現したい場合や、特定のフォーマットで出力したい場合などに役立ちます。例えば、デバッグ目的でTypedArrayの内容をログに出力したり、データを特定の区切り文字で結合して表示したりする際に利用することができます。生成される文字列は、TypedArrayの元の要素の順番を保って結合されます。

公式リファレンス: TypedArray.prototype.join()

構文(syntax)

1const typedArray = new Uint8Array([10, 20, 30]);
2const result = typedArray.join('-');

引数(parameters)

separator = ','

  • separator: string = ',': 配列の要素を連結する際に、要素間に挿入される文字列。デフォルトはカンマ。

戻り値(return)

文字列

TypedArray.prototype.join() メソッドは、配列の全要素を連結した文字列を返します。要素は指定された区切り文字(デフォルトはカンマ)で区切られます。

関連コンテンツ

関連プログラミング言語