Name: nt126004 Date: 06/23/2003


A DESCRIPTION OF THE REQUEST :
The method with the interface described above does not exist.


JUSTIFICATION :
Juggling a huge number of strings is bad on performance if it is done with objects of type String. Consequently StringBuffer tends to be used in many performance critical applications. This use includes copying substrings from one StringBuffer to another. Currently it can only be done by
a) calling append(source.substring(...)), thereby creating an intermediate object
b) juggling with an intermediate char[] array.

While the latter needs only be reallocated when necessary, it is tedious to program and includes an additional round of copying: StringBuffer->char[]->StringBuffer.



EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
The method

StringBuffer.append(StringBuffer source, int offset, int len)

should copy characters in one step from the specified range of the source to the destination StringBuffer.

Don't forget to add .insert(StringBuffer source, int offset, int len) too.
(Review ID: 187823)
======================================================================