StringBuilderクラスにおいてのtoStringメソッドの意味

Question

市販のテキストを読んでいてこのようなコードを見つけたのですが、toStringメソッドでString型の変数strに代入する意味がよくわかりません。

StringBuilder sb = new StringBuilder();

for (int i = 0; i < 3; i++) {
    sb.append("Java");
}

String str = sb.toString(); // <= ???

仮にこのString str = sb.toString();を削除してSystem.out.println(sb);と記述しても結果的にはJavaJavaJavaと表示されると思うのですが。
ちなみにテキストでは「連結した文字列を取り出す」との説明です。

例えば下記のように...

   StringBuilder sb = new StringBuilder();

   for (int i = 0; i < 3; i++) {
      sb.append("Java");
   }

   String str1 = sb.toString();
   System.out.println(str1); // => JavaJavaJava

   sb.append("+hogehogehoge");
   String str2 = sb.toString();
   System.out.println(str2); // => JavaJavaJava+hogehogehoge

...ベースとなる変数sbの中身を維持した上で使い回す場合などを想定しtoStringメソッドを使うという考え方なのでしょうか？。

Answer 1

println は引数が文字列でなかったときに toString を呼び出します。

Comments

[n0rio]

回答いただきありがとうございました。

Answer 2

目的が「連結結果をコンソールへ表示する」ことだけならtoStringの必要はありません。

System.out.println(sb);

とすれば、printlnメソッドが引数に指定された任意のオブジェクトに対してString.valueOf -> sb.toStringを呼び出すうごきになるからです。

一方目的が「Stringとして結果を得る」ならtoStringを明示的に呼び出すべきです。

String result = sb.toString();

ならOKですが、

String result = sb;

は型が違うのでコンパイルエラーになりますよね？

Comments

[n0rio]

回答いただきありがとうございました。

Answer 3

参照型のnullでないインスタンスを出力する際は、内部的にtoStringが呼ばれます。
ですので、出力前にわざわざStringに直すのは処理的には無意味かと。

...その方が分かりやすいと思ったんじゃないですかね？著者が。

---

いちおう引用しておきます。

PrintStream#println(Object)

Objectを出力して、行を終了します。このメソッドは最初にString.valueOf(x)を呼び出して出力されるオブジェクトの文字列値を取得してから、print(String)、そしてprintln()を呼び出すのと同じように動作します。

String#valueOf(Object)

引数がnullの場合は"null"に等しい文字列。それ以外の場合はobj.toString()の値が返される。

Comments

[n0rio]

著者の意図がわからないと言うことでスルーして深く考えないことにしました。

[fuzzball]

著者の意図は「連結した文字列を取り出す」なんでしょ？