add new methods to Array API

Author: JavaSaBr

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

@@ -1040,10 +1040,11 @@ default <T> boolean anyMatchR(@NotNull T argument, @NotNull NotNullBiPredicate<?
     }
 
     /**
-     * Search an element using the condition.
+     * Search a converted element to int using the condition.
      *
      * @param argument  the argument.
-     * @param filter the condition.
+     * @param converter the converter element to int.
+     * @param filter    the condition.
      * @return the found element or null.
      * @since 9.6.0
      */
@@ -1071,6 +1072,42 @@ default <T> boolean anyMatchR(@NotNull T argument, @NotNull NotNullBiPredicate<?
         return null;
     }
 
+    /**
+     * Search a converted element to int using the condition.
+     *
+     * @param argument        the argument.
+     * @param firstConverter  the converter element to T.
+     * @param secondConverter the converter element to int.
+     * @param filter          the condition.
+     * @param <T>             the first converted type.
+     * @return the found element or null.
+     * @since 9.7.0
+     */
+    default <T> @Nullable E findAnyConvertedToInt(
+        int argument,
+        @NotNull NotNullFunction<? super E, T> firstConverter,
+        @NotNull NotNullFunctionInt<T> secondConverter,
+        @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, secondConverter.apply(firstConverter.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

@@ -468,10 +468,11 @@ default void writeUnlock(long stamp) {
     }
 
     /**
-     * Search an element using the condition under {@link #readLock()} block.
+     * Search a converted element to int using the condition under {@link #readLock()} block.
      *
-     * @param argument the argument.
-     * @param filter   the condition.
+     * @param argument  the argument.
+     * @param converter the converter element to int.
+     * @param filter    the condition.
      * @return the found element or null.
      * @since 9.6.0
      */
@@ -492,6 +493,35 @@ default void writeUnlock(long stamp) {
         }
     }
 
+    /**
+     * Search a converted element to int using the condition under {@link #readLock()} block.
+     *
+     * @param argument        the argument.
+     * @param firstConverter  the converter element to T.
+     * @param secondConverter the converter element to int.
+     * @param filter          the condition.
+     * @param <T>             the first converted type.
+     * @return the found element or null.
+     * @since 9.7.0
+     */
+    default <T> @Nullable E findAnyConvertedToIntInReadLock(
+        int argument,
+        @NotNull NotNullFunction<? super E, T> firstConverter,
+        @NotNull NotNullFunctionInt<T> secondConverter,
+        @NotNull BiIntPredicate filter
+    ) {
+        if (isEmpty()) {
+            return null;
+        }
+
+        var stamp = readLock();
+        try {
+            return findAnyConvertedToInt(argument, firstConverter, secondConverter, filter);
+        } finally {
+            readUnlock(stamp);
+        }
+    }
+
     /**
      * Search an element by condition under {@link #readLock()} block.
      *

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

@@ -2,6 +2,7 @@
 
 import com.ss.rlib.common.concurrent.atomic.AtomicInteger;
 import com.ss.rlib.common.test.BaseTest;
+import com.ss.rlib.common.util.NumberUtils;
 import com.ss.rlib.common.util.array.*;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
@@ -225,7 +226,21 @@ void findAnyTest() {
         Assertions.assertNotNull(array.findAnyConvertedToInt(
             "First".hashCode(),
             String::hashCode,
-            (first, second) -> first == second
+            NumberUtils::equals
+        ));
+
+        Assertions.assertNotNull(array.findAnyConvertedToInt(
+            "MyValue".hashCode(),
+            object -> "MyValue",
+            String::hashCode,
+            NumberUtils::equals
+        ));
+
+        Assertions.assertNull(array.findAnyConvertedToInt(
+            "MyValue".hashCode(),
+            object -> "First",
+            String::hashCode,
+            NumberUtils::equals
         ));
 
         Assertions.assertNotNull(array.findAnyConverted(

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

@@ -7,6 +7,7 @@
 import com.ss.rlib.common.util.array.Array;
 import com.ss.rlib.common.util.array.ArrayFactory;
 import com.ss.rlib.common.util.array.ConcurrentArray;
+import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
 import java.util.Collections;
@@ -208,17 +209,31 @@ void findAnyInReadLockTest() {
         assertNotNull(array.findAnyInReadLock("Second".hashCode(), (val, string) -> val == string.hashCode()));
         assertNull(array.findAnyInReadLock("None".hashCode(), (val, string) -> val == string.hashCode()));
 
-        assertNotNull(array.findAnyConvertedToInt(
+        assertNotNull(array.findAnyConvertedToIntInReadLock(
             "First".hashCode(),
             String::hashCode,
             NumberUtils::equals
         ));
 
-        assertNotNull(array.findAnyConverted(
+        assertNotNull(array.findAnyConvertedInReadLock(
             "First".hashCode(),
             String::hashCode,
             Objects::equals
         ));
+
+        Assertions.assertNotNull(array.findAnyConvertedToIntInReadLock(
+            "MyValue".hashCode(),
+            object -> "MyValue",
+            String::hashCode,
+            NumberUtils::equals
+        ));
+
+        Assertions.assertNull(array.findAnyConvertedToIntInReadLock(
+            "MyValue".hashCode(),
+            object -> "First",
+            String::hashCode,
+            NumberUtils::equals
+        ));
     }
 
     @Test