指定した区切り文字で複数の文字列を連結し新しい文字列を作成する

String クラスで用意されている join メソッドは、複数の文字列を指定した区切り文字を間に挟んで連結していき、新しい文字列を作成します。ここでは Java で指定した区切り文字で複数の文字列を連結し新しい文字列を作成する方法について解説します。

(Last modified: 2023年01月30日)

String.joinメソッドの使い方

複数の文字列を区切り文字を使って連結し新しい文字列を作成するには String クラスの join メソッドを使います。 join メソッドはクラスメソッドです。書式は次のとおりです。

パラメータ:
delimiter - 各要素を区切る区切り文字
elements - 結合する要素

戻り値:
delimiterで区切られたelementsからなる新しいString

例外:
NullPointerException - delimiterまたはelementsがnullである場合

1 番目の引数に文字列の間に挟む区切り文字を指定します。 2 番目の引数以降に連結する文字列を必要なだけ指定します。戻り値として連結した新しい文字列を返します。

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

String str = String.join("-", "Apple", "Grape", "Melon");
System.out.println(str);  // Apple-Grape-Melon

区切り文字として "-" を指定しました。連結する文字列は 3 つ指定しています。この 3 つの文字列を区切り文字の "-" を間に挟んで連結し、連結した新しい文字列を戻り値として取得しました。

また join メソッドは 2 番目の引数にイテレータを指定するものも用意されています。書式は次のとおりです。

パラメータ:
delimiter - 結果となるString内のelementsのそれぞれを区切るために使用される文字シーケンス
elements - elementsが結合されるIterable

戻り値:
elements引数からなる新しいString

例外:
NullPointerException - delimiterまたはelementsがnullである場合

1 番目の引数に文字列の間に挟む区切り文字を指定します。 2 番目の引数にイテレータを指定します。戻り値として連結した新しい文字列を返します。

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

import java.util.List;

List<String> strings = List.of("One", "Two", "Three");
String str = String.join(" * ", strings);
System.out.println(str);  // One * Two * Three

区切り文字として " * " を指定しました。連結する文字列は 3 つの要素を含むリストを作成し、 join メソッドの 2 番目の引数に指定しています。この 3 つの文字列を区切り文字の " * " を間に挟んで連結し、連結した新しい文字列を戻り値として取得しました。

それでは簡単なサンプルプログラムを作って試してみます。テキストエディタで次のように記述したあと、 JSample17-1.java という名前で保存します。

import java.util.List;

class JSample17_1{
  public static void main(String[] args){
    String str1 = String.join("-", "Apple", "Grape", "Melon");
    System.out.println(str1);

    List<String> strings = List.of("One", "Two", "Three");
    String str2 = String.join(" * ", strings);
    System.out.println(str2);
  }
}

コンパイルを行います。

その後で、次のように実行してください。

複数の文字列を指定した区切り文字を使って連結して作成した新しい文字列を取得することができました。

-- --

Java で指定した区切り文字で複数の文字列を連結し新しい文字列を作成する方法について解説しました。

著者 / TATSUO IKURA

これから IT 関連の知識を学ばれる方を対象に、色々な言語でのプログラミング方法や関連する技術、開発環境構築などに関する解説サイトを運営しています。