add new API for arrays

Author: JavaSaBr

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

@@ -124,6 +124,15 @@ public interface Array<E> extends Collection<E>, Serializable, Reusable, Cloneab
         return ArrayFactory::newConcurrentStampedLockArray;
     }
 
+    /**
+     * Copy all elements from this array to a target array.
+     *
+     * @param target the target array.
+     */
+    default void copyTo(@NotNull Array<? super E> target) {
+        target.addAll(this);
+    }
+
     /**
      * Adds all elements from the array to this array.
      *
@@ -418,8 +427,7 @@ default int lastIndexOf(@NotNull Object object) {
     }
 
     /**
-     * Removes all of this target's elements that are also contained in the specified array (optional operation).  After
-     * this call returns, this array will contain no elements in common with the specified array.
+     * Removes all of this target's elements that are also contained in the specified array (optional operation).
      *
      * @param target array containing elements to be removed from this array.
      * @return true if this array changed as a result of the call.
@@ -432,15 +440,48 @@ default boolean removeAll(@NotNull Array<?> target) {
 
         int count = 0;
 
-        for (Object element : target.array()) {
+        for (var element : target.array()) {
             if (element == null) {
                 break;
             } else if (slowRemove(element)) {
                 count++;
             }
         }
 
-        return count == target.size();
+        return count > 0;
+    }
+
+    /**
+     * Removes all of this target's elements that are also contained in the specified array (optional operation)
+     * with reordering.
+     *
+     * @param target array containing elements to be removed from this array.
+     * @return true if this array changed as a result of the call.
+     */
+    default boolean fastRemoveAll(@NotNull Array<?> target) {
+
+        if (target.isEmpty()) {
+            return false;
+        }
+
+        var count = 0;
+        var array = array();
+
+        for (int i = 0, length = size(); i < length; i++) {
+
+            var element = array[i];
+
+            if (!target.contains(element)) {
+                continue;
+            }
+
+            fastRemove(i);
+            i--;
+            length--;
+            count++;
+        }
+
+        return count > 0;
     }
 
     @Override

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

@@ -424,6 +424,32 @@ void forEachTest() {
         Assertions.assertEquals(array.size(), counter.getAndSet(0));
     }
 
+    @Test
+    void fastRemoveAllTest() {
+
+        var array = ArrayFactory.asArray("First", "Second", "Third", "  ", "55", "66", "22", "22", "11");
+        var toRemove = ArrayFactory.asArray("First", "Third", "66", "22");
+        var result = ArrayFactory.asArray("Second", "  ", "55", "11");
+        result.sort(String::compareTo);
+
+        array.fastRemoveAll(toRemove);
+        array.sort(String::compareTo);
+
+        Assertions.assertEquals(result, array);
+    }
+
+    @Test
+    void copyToTest() {
+
+        var toCopy = ArrayFactory.asArray("123", "321", "555");
+        var toCombine = ArrayFactory.asArray("First", "Second");
+        var result = ArrayFactory.asArray("First", "Second", "123", "321", "555");
+
+        toCopy.copyTo(toCombine);
+
+        Assertions.assertEquals(result, toCombine);
+    }
+
     //FIXME OLD TESTS
 
     @Test