This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-lang.git
The following commit(s) were added to refs/heads/master by this push: new 6b1da52c9 Javadoc 6b1da52c9 is described below commit 6b1da52c9a9abc798b3f45cc20198aba6fd555a3 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Oct 31 10:18:29 2024 -0400 Javadoc --- .../java/org/apache/commons/lang3/ArrayUtils.java | 48 +++++++++++++++++++++- 1 file changed, 46 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/apache/commons/lang3/ArrayUtils.java b/src/main/java/org/apache/commons/lang3/ArrayUtils.java index b2ca091e7..f55b4634d 100644 --- a/src/main/java/org/apache/commons/lang3/ArrayUtils.java +++ b/src/main/java/org/apache/commons/lang3/ArrayUtils.java @@ -1558,6 +1558,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1572,6 +1576,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1586,6 +1594,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1601,6 +1613,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1618,6 +1634,10 @@ public class ArrayUtils { * The method returns {@code false} if a {@code null} array * is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search * @param valueToFind the value to find @@ -1633,6 +1653,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1647,6 +1671,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1661,6 +1689,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1675,6 +1707,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param objectToFind the object to find @@ -1689,6 +1725,10 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * * @param array the array to search through * @param valueToFind the value to find @@ -1703,9 +1743,13 @@ public class ArrayUtils { * <p> * The method returns {@code false} if a {@code null} array is passed in. * </p> + * <p> + * If the {@code array} elements you are searching implement {@link Comparator}, consider whether it is worth using + * {@link Arrays#sort(Object[], Comparator)} and {@link Arrays#binarySearch(Object[], Object)}. + * </p> * - * @param array the array to search through - * @param objectsToFind any of the objects to find + * @param array the array to search through + * @param objectsToFind any of the objects to find * @return {@code true} if the array contains any of the objects * @since 3.13.0 */