CODEWITHSUNDEEP
java
whales
whales

Reputation: 827

Return or Print StringBuilder? Java

I am a bit confused about the StringBuilder. It seems that when I print a StringBuilder, there it no need to add .toString() because it will automatically give me a string representation. However, when I return a StringBuilder object, I have to add the .toString(). Is that true? and why?

Also, I am bit confused about the following code: 

package com.tutorialspoint;
import java.lang.*;
public class StringBuilderDemo {
    public static void main(String[] args) {

        StringBuilder str = new StringBuilder("India ");
        System.out.println("string = " + str);

        // append character to the StringBuilder
        str.append('!');
        // convert to string object and print it
        System.out.println("After append = " + str.toString());

        str = new StringBuilder("Hi "); 
        System.out.println("string = " + str);
        // append integer to the StringBuilder
        str.append(123);
        // convert to string object and print it
        System.out.println("After append = " + str.toString());
    }
}

For the different println, sometimes this code use toString and some other times it didn't. Why? I tried deleting the toString and the results are the same. Is it still necessary to use toString in println?

Thanks so much for helping a newbie out!

Upvotes: 7

Views: 28256

Answers (4)

nick wouters
nick wouters

Reputation: 96

The first thing you should know about Java is that we work with objects and that all objects inherit methods from the class Object: http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html

This class has a toString() method and since every object inherits this method it can always be called on every object. When you do not override it, it usually returns the physical address of the object.

Like stated in other answers, whenever a string is expected in println for instance and you pass an object it automatically calls the method which requires an Object (note the capital, we are talking about the class Object here), it will then use the toString method on the object passed along as parameter. The reason you get the string you want is because StringBuilder overrides the toString() method for you.

When you in your own code want to pass the string in your StringBuilder you have two options. You can either pass StringBuilder.toString() or change the return type to Object or StringBuilder and call toString() when you actually need it.

Hope this clarifies why you can just pass the object instead of the string.

Upvotes: 1

Mena
Mena

Reputation: 48404

When you print an object to a print stream, the String representation of that object will be printed, hence toString is invoked.

Some classes override Object#toString, amongst which StringBuilder does.

Hence explicitly invoking toString for StringBuilder is unnecessary.

On the other hand, other objects don't override toString. For instance, arrays.

When you print an array, unless using a utility such as Arrays.toString, you're getting the array's class type @ its hash code, as opposed to a human-readable representation of its contents.

Upvotes: 11

dguay
dguay

Reputation: 1683

From the documentation:

Note that println() prints a string builder, as in:

System.out.println(sb);

because sb.toString() is called implicitly, as it is with any other object in a println() invocation.

Upvotes: 7

libik
libik

Reputation: 23029

If you try to append an object to a string like this : "string = " + str, the toString() method is implicitly called.

So no, it does not matter, if you specify it.

Also the toString() method itself (even when you are not append it to string) calls the toString() method.

Therefore System.out.println(str) and System.out.println(str.toString()) gives same result.

Upvotes: 3

Related Questions