infernap12/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2026-03-10 08:01:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

8377903: ArraysSupport::mismatch should document that they return the smallest index

Browse Source 
Reviewed-by: rriggs, vyazici
This commit is contained in:
Raffaello Giulietti 2026-03-03 16:57:09 +00:00
parent 364fd0e37e
commit 0ea7d890d9
1 changed files with 7 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
src/java.base/share/classes/jdk/internal/util/ArraysSupport.java
View File

@ -478,7 +478,7 @@ public class ArraysSupport {
// Bytes
/**
* Find the index of a mismatch between two arrays.
* Find the smallest index of a mismatch between two arrays.
*
* <p>This method does not perform bounds checks. It is the responsibility
* of the caller to perform such bounds checks before calling this method.
@ -486,9 +486,9 @@ public class ArraysSupport {
* @param a the first array to be tested for a mismatch
* @param b the second array to be tested for a mismatch
* @param length the number of bytes from each array to check
* @return the index of a mismatch between the two arrays, otherwise -1 if
* no mismatch. The index will be within the range of (inclusive) 0 to
* (exclusive) the smaller of the two array lengths.
* @return the smallest index of a mismatch between the two arrays,
* otherwise -1 if no mismatch. The index will be within the range of
* (inclusive) 0 to (exclusive) the smaller of the two array lengths.
*/
public static int mismatch(byte[] a,
byte[] b,
@ -520,8 +520,8 @@ public class ArraysSupport {
}
/**
* Find the relative index of a mismatch between two arrays starting from
* given indexes.
* Find the smallest relative index of a mismatch between two arrays
* starting from given indexes.
*
* <p>This method does not perform bounds checks. It is the responsibility
* of the caller to perform such bounds checks before calling this method.
@ -533,7 +533,7 @@ public class ArraysSupport {
* @param bFromIndex the index of the first element (inclusive) in the
* second array to be compared
* @param length the number of bytes from each array to check
* @return the relative index of a mismatch between the two arrays,
* @return the smallest relative index of a mismatch between the two arrays,
* otherwise -1 if no mismatch. The index will be within the range of
* (inclusive) 0 to (exclusive) the smaller of the two array bounds.
*/