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
      */

Reply via email to