关于StringBuilder indexOf的误导性javadoc评论？

Question

我试图理解StringBuilder类的indexOf（String str， int fromIndex）方法的javadoc中的以下注释。

它说：

返回此字符串中指定子字符串第一次出现的索引，从指定索引开始。返回的整数是最小值k：

    k >= Math.min(fromIndex, str.length()) &&
                  this.toString().startsWith(str, k)

如果不存在这样的k值，则返回-1。

现在，我看不出在数学中使用str.length（）的原因。min（fromIndex，str.length（）），因为它允许在索引上找到字符串

编辑：如下所示，这是来自Java7 javadoc的评论；java 6有正确的评论。

Answer 1

不，条件基本上归结为第一个k，使得k至少是来自索引的，并且小于或等于str.length（），其中字符串包含所需的子字符串。

如果str.length

Answer 2

这是一个错误。应该是这样的。length（）而不是str.length（）。

这允许fromIndex在str为空的情况下大于this.length（）。

例子：

StringBuilder sb = new StringBuilder("Example");
System.out.println(sb.indexOf("", 1234)); //Outputs sb.length(), which is 7.

注意：String#indexOf（String，int）的行为方式相同。