Name: ksC84122 Date: 09/17/99


The javadoc bug 4230291 was fixed in StringBuffer.java delta 1.50
and the javadoc was fixed to state:

"Throws: IndexOutOfBoundsException - if any of the following is true:
....
if srcBegin = srcEnd = </code> current length of StringBuffer"

I verified that.

However, the doc was brought back in StringBuffer.java delta 1.53 with the comment:
"Change related to 4230290 and 4230291: It should be legal to specify a zero
length block at the end of dst with an index of dst.length"

So, in JDK 1.3.0F this line does not exist in the javadoc.

This means that sb.getChars(sb.length(), sb.length(), dst, x) should
not throw an IndexOutOfBoundsException. If so (which can make sense
if this is meant to specify a zero length block at the end of this StringBuffer(not dst)),
then the implementation should be fixed to behave accordingly.

If not, and 4230291 was a valid doc bug, then the javadoc needs
to be brought in line with the implementation
and the line mentioned should be present in the javadoc.

Please note that a test example in 4230291 was not very accurate(sorry for that).
Below you will find a test example that was meant by 4230291 and this report as well.

Here is the example demonstrating the bug:
------------- test.java -------------------------
public class test48 {

   public static void main (String argv[]) {
    StringBuffer sb = new StringBuffer("sample string buffer");
    char dst[] = new char[30];
    
    try {
        sb.getChars(sb.length(), sb.length(), dst, 0);
        System.out.println("No exception thrown");
    } catch (IndexOutOfBoundsException iobe) { //OKAY
        System.out.println("IndexOutOfBoundsException thrown");
    }
    return;
  }

}
========= Sample run (JDK1.3 fcs) ==========
java test48
IndexOutOfBoundsException thrown

======================================================================