Kathy Sierra and Bert Bates Book StringBuilder and BufferBuilder methods

[Imad Aydarooos]

Kathy Sierra and Bert Bates Book "Sun Certified Programmer for java 6 Study Guide" in Chapter 6: Strings, I/O, Formatting, and Parsing, in page 440 while they are tackling StringBuilder methods. below is a quote from the book:

public StringBuilder delete(int start, int end) This method returns a
StringBuilder object and updates the value of the StringBuilder object that invoked
the method call.

The above phrase is applied almost to all the StringBuffer and StringBuilder.
I think the correct phrase must be:
"this method returns a refrence to the StringBuilder object that invoke the method and updates the value of the StringBuilder object as well"
Regards

[Abimaran Kugathasan]

Why don't you check with the API

[Imad Aydarooos]

Abimaran Kugathasan wrote:Why don't you check with the API

Dear Abirman, I already checked the StringBuilder API before I wrote what I wrote and below is from the append method in the API check what in Bold:

public StringBuilder append(String str)Appends the specified string to this character sequence.
The characters of the String argument are appended, in order, increasing the length of this sequence by the length of the argument. If str is null, then the four characters "null" are appended.

Let n be the length of this character sequence just prior to execution of the append method. Then the character at index k in the new character sequence is equal to the character at index k in the old character sequence, if k is less than n; otherwise, it is equal to the character at index k-n in the argument str.


Parameters:
str - a string.
Returns:
a reference to this object.--------------------------------------------------------------------------------