add new findAny methods to arrays

Author: JavaSaBr

rlib-common/src/main/java/com/ss/rlib/common/function/BiIntPredicate.java

@@ -0,0 +1,10 @@
+package com.ss.rlib.common.function;
+
+/**
+ * @author JavaSaBr
+ */
+@FunctionalInterface
+public interface BiIntPredicate {
+
+    boolean test(int first, int second);
+}

rlib-common/src/main/java/com/ss/rlib/common/function/NotNullFunctionInt.java

@@ -0,0 +1,9 @@
+package com.ss.rlib.common.function;
+
+import org.jetbrains.annotations.NotNull;
+
+@FunctionalInterface
+public interface NotNullFunctionInt<T> extends FunctionInt<T> {
+
+    int apply(@NotNull T object);
+}

rlib-common/src/main/java/com/ss/rlib/common/util/array/Array.java

@@ -731,6 +731,7 @@ default <A, B> boolean removeIf(
      * @param <A>       the argument's type.
      * @param <B>       the element converted type.
      * @return {@code true} if any elements were removed.
+     * @since 9.6.0
      */
     default <A, B> boolean removeConvertedIf(
         @NotNull A argument,
@@ -962,6 +963,38 @@ default <T> boolean anyMatchR(@NotNull T argument, @NotNull NotNullBiPredicate<?
         return null;
     }
 
+    /**
+     * Search an element using the condition.
+     *
+     * @param argument  the argument.
+     * @param filter the condition.
+     * @return the found element or null.
+     * @since 9.6.0
+     */
+    default @Nullable E findAnyConvertedToInt(
+        int argument,
+        @NotNull NotNullFunctionInt<? super E> converter,
+        @NotNull BiIntPredicate filter
+    ) {
+
+        if (isEmpty()) {
+            return null;
+        }
+
+        var array = array();
+
+        for (int i = 0, length = size(); i < length; i++) {
+
+            var element = array[i];
+
+            if (filter.test(argument, converter.apply(element))) {
+                return element;
+            }
+        }
+
+        return null;
+    }
+
     /**
      * Calculate a count of matched elements.
      *

rlib-common/src/main/java/com/ss/rlib/common/util/array/ConcurrentArray.java

@@ -6,7 +6,6 @@
 import org.jetbrains.annotations.Nullable;
 
 import java.util.function.Function;
-import java.util.function.Supplier;
 
 /**
  * The interface with methods to manage thread-safe access with arrays.
@@ -416,6 +415,31 @@ default void writeUnlock(long stamp) {
         }
     }
 
+    /**
+     * Search an element using the condition under {@link #readLock()} block.
+     *
+     * @param argument the argument.
+     * @param filter   the condition.
+     * @return the found element or null.
+     * @since 9.6.0
+     */
+    default @Nullable E findAnyConvertedToIntInReadLock(
+        int argument,
+        @NotNull NotNullFunctionInt<? super E> converter,
+        @NotNull BiIntPredicate filter
+    ) {
+        if (isEmpty()) {
+            return null;
+        }
+
+        var stamp = readLock();
+        try {
+            return findAnyConvertedToInt(argument, converter, filter);
+        } finally {
+            readUnlock(stamp);
+        }
+    }
+
     /**
      * Search an element by condition under {@link #readLock()} block.
      *
@@ -523,6 +547,7 @@ default <A, B> boolean removeIfInWriteLock(
      * @param <A>       the argument's type.
      * @param <B>       the element converted type.
      * @return {@code true} if any elements were removed.
+     * @since 9.6.0
      */
     default <A, B> boolean removeConvertedIfInWriteLock(
         @NotNull A argument,

rlib-common/src/test/java/com/ss/rlib/common/test/util/array/ArrayTest.java

@@ -224,6 +224,12 @@ void findAnyTest() {
         }));
 
         Assertions.assertNotNull(array.findAnyL("First".hashCode(), (num, element) -> num == element.hashCode()));
+
+        Assertions.assertNotNull(array.findAnyConvertedToInt(
+            "First".hashCode(),
+            String::hashCode,
+            (first, second) -> first == second
+        ));
     }
 
     @Test

rlib-common/src/test/java/com/ss/rlib/common/test/util/array/ConcurrentArrayTest.java

@@ -102,6 +102,12 @@ void findAnyInReadLockTest() {
 
         Assertions.assertNotNull(array.findAnyInReadLock("Second".hashCode(), (val, string) -> val == string.hashCode()));
         Assertions.assertNull(array.findAnyInReadLock("None".hashCode(), (val, string) -> val == string.hashCode()));
+
+        Assertions.assertNotNull(array.findAnyConvertedToInt(
+            "First".hashCode(),
+            String::hashCode,
+            (first, second) -> first == second
+        ));
     }
 
     @Test