Name: ksC84122 Date: 04/16/99


The javadoc for JDK 1.2.2 java.lang.StringBuffer.getChars(int srcBegin, int srcEnd,
char[] dst, int dstBegin) states:
----
Throws:
         IndexOutOfBoundsException - if any of the following is true:
              srcBegin is negative
              the srcBegin argument is greater than the srcEnd argument.
              srcEnd is greater than this.length(), the current length of this
              string buffer.
              dstBegin+srcEnd-srcBegin is greater than dst.length
----

The javadoc does not specify behavior in case when
srcBegin = srcEnd and dstBegin is negative.

In fact, the IndexOutOfBoundsException is not
thrown, however it is inconsistent with the following case:
srcBegin = srcEnd and dstBegin >= dst.length (IndexOutOfBoundsException should be thrown
according to the javadoc, but not thrown - see bug ID 4230290)

A test example which demonstrates this problem.
===== test47.java ========
public class test47 {

   public static void main (String argv[]) {

    StringBuffer sb = new StringBuffer("sample string buffer");
    char dst[] = new char[30];
    boolean failed = false;
    
    int a[][] = { {0, 0, -1},
                  {0, 0, dst.length},
                  {0, 0, dst.length + 1},
                  {0, 0, dst.length + 20},
                  {5, 5, -1},
                  {5, 5, dst.length},
                  {5, 5, dst.length + 1},
                  {5, 5, dst.length + 20}
    };
    
    for (int i = 0; i < a.length; i++) {
        try {
            sb.getChars(a[i][0], a[i][1], dst, a[i][2]);
            failed = true;
            System.out.println("failed for:" + a[i][0] + " " + a[i][1] + " " + a[i][2] );
        } catch (IndexOutOfBoundsException iobe) { //OKAY
        }
    }
    if (!failed) {
        System.out.println("PASSED: OK.");
    }
    return;
  }
}


========= Sample run (JDK1.2.2) ==========
#>java test47
failed for:0 0 -1
failed for:0 0 30
failed for:0 0 31
failed for:0 0 50
failed for:5 5 -1
failed for:5 5 30
failed for:5 5 31
failed for:5 5 50

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