/*
 *  Licensed to the Apache Software Foundation (ASF) under one
 *  or more contributor license agreements.  See the NOTICE file
 *  distributed with this work for additional information
 *  regarding copyright ownership.  The ASF licenses this file
 *  to you under the Apache License, Version 2.0 (the
 *  "License"); you may not use this file except in compliance
 *  with the License.  You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing,
 *  software distributed under the License is distributed on an
 *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 *  KIND, either express or implied.  See the License for the
 *  specific language governing permissions and limitations
 *  under the License.
 */
package org.codehaus.groovy.runtime;

import groovy.lang.Closure;
import groovy.lang.EmptyRange;
import groovy.lang.GroovyRuntimeException;
import groovy.lang.IntRange;
import groovy.lang.MetaClass;
import groovy.lang.ObjectRange;
import groovy.lang.Range;
import groovy.lang.SpreadMap;
import groovy.lang.Tuple2;
import groovy.transform.stc.ClosureParams;
import groovy.transform.stc.FirstParam;
import groovy.transform.stc.FromString;
import groovy.util.ClosureComparator;
import groovy.util.OrderBy;
import groovy.util.function.DoubleComparator;
import groovy.util.function.FloatComparator;
import groovy.util.function.FloatUnaryOperator;
import groovy.util.function.IntComparator;
import groovy.util.function.LongComparator;
import org.apache.groovy.lang.annotation.Incubating;
import org.codehaus.groovy.runtime.dgmimpl.NumberNumberDiv;
import org.codehaus.groovy.runtime.typehandling.DefaultTypeTransformation;
import org.codehaus.groovy.util.ArrayIterable;
import org.codehaus.groovy.util.ArrayIterator;
import org.codehaus.groovy.util.BooleanArrayIterator;
import org.codehaus.groovy.util.ByteArrayIterator;
import org.codehaus.groovy.util.CharArrayIterator;
import org.codehaus.groovy.util.DoubleArrayIterable;
import org.codehaus.groovy.util.DoubleArrayIterator;
import org.codehaus.groovy.util.DoubleDoubleArrayColumnIterator;
import org.codehaus.groovy.util.FloatArrayIterable;
import org.codehaus.groovy.util.FloatArrayIterator;
import org.codehaus.groovy.util.FloatFloatArrayColumnIterator;
import org.codehaus.groovy.util.IntArrayIterable;
import org.codehaus.groovy.util.IntArrayIterator;
import org.codehaus.groovy.util.IntIntArrayColumnIterator;
import org.codehaus.groovy.util.LongArrayIterable;
import org.codehaus.groovy.util.LongArrayIterator;
import org.codehaus.groovy.util.LongLongArrayColumnIterator;
import org.codehaus.groovy.util.ShortArrayIterator;

import java.lang.reflect.Array;
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashSet;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.NoSuchElementException;
import java.util.Objects;
import java.util.Random;
import java.util.Set;
import java.util.SortedSet;
import java.util.TreeSet;
import java.util.function.BiFunction;
import java.util.function.BiPredicate;
import java.util.function.BinaryOperator;
import java.util.function.Consumer;
import java.util.function.DoubleConsumer;
import java.util.function.DoublePredicate;
import java.util.function.DoubleUnaryOperator;
import java.util.function.Function;
import java.util.function.IntConsumer;
import java.util.function.IntPredicate;
import java.util.function.IntUnaryOperator;
import java.util.function.LongConsumer;
import java.util.function.LongPredicate;
import java.util.function.LongUnaryOperator;
import java.util.function.ObjIntConsumer;
import java.util.function.Predicate;

/**
 * Defines new groovy methods which appear on arrays inside the Groovy environment.
 * Static methods are used with the first parameter being the destination class,
 * i.e. <code>public static int[] each(int[] self, Closure closure)</code>
 * provides an <code>each({i -> })</code> method for <code>int[]</code>.
 * <p>
 * NOTE: While this class contains many 'public' static methods, it is
 * primarily regarded as an internal class (its internal package name
 * suggests this also). We value backwards compatibility of these
 * methods when used within Groovy but value less backwards compatibility
 * at the Java method call level. I.e. future versions of Groovy may
 * remove or move a method call in this file but would normally
 * aim to keep the method available from within Groovy.
 */
public class ArrayGroovyMethods extends DefaultGroovyMethodsSupport {

    private ArrayGroovyMethods() {}

    /* Arrangement of each method (skip any inapplicable types for the methods):
     * 1. boolean[]
     * 2. byte[]
     * 3. char[]
     * 4. short[]
     * 5. int[]
     * 6. long[]
     * 7. float[]
     * 8. double[]
     * 9. Object[]
     */

    //--------------------------------------------------------------------------
    // any

    /**
     * Iterates over the contents of a boolean Array, and checks whether
     * any element is true.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array1 = [false, true]
     * assert array1.any()
     * boolean[] array2 = [false]
     * assert !array2.any()
     * </pre>
     *
     * @param self the boolean array over which we iterate
     * @return true if any boolean is true
     * @since 5.0.0
     */
    public static boolean any(boolean[] self) {
        Objects.requireNonNull(self);
        for (boolean item : self) {
            if (item) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a boolean Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true]
     * assert array.any{ it }
     * assert !array.any{ !it }
     * </pre>
     *
     * @param self      the boolean array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the booleans matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(boolean[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (boolean item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a byte Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1, 2]
     * assert array.any{ it > 1 }
     * assert !array.any{ it > 3 }
     * </pre>
     *
     * @param self      the byte array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the bytes matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(byte[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (byte item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a char Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a', 'b', 'c']
     * assert array.any{ it &lt;= 'a' }
     * assert !array.any{ it &lt; 'a' }
     * </pre>
     *
     * @param self      the char array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the chars matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(char[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (char item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a short Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1, 2]
     * assert array.any{ it > 1 }
     * assert !array.any{ it > 3 }
     * </pre>
     *
     * @param self      the char array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the shorts matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(short[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (short item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of an int Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1, 2]
     * assert array.any{ it > 1 }
     * assert !array.any{ it > 3 }
     * </pre>
     *
     * @param self      the int array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the ints matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(int[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (int item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Returns true if any element of the int array matches the given predicate.
     * A "fat-free" variant of {@link #any(int[], Closure)} accepting an {@link IntPredicate}.
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [1, 2, 3]
     * assert nums.any(n -&gt; n &gt; 2)
     * </pre>
     *
     * @param self      an int array
     * @param predicate the predicate evaluated against each element
     * @return true if any element satisfies the predicate
     * @since 6.0.0
     */
    public static boolean any(int[] self, IntPredicate predicate) {
        Objects.requireNonNull(self);
        for (int item : self) {
            if (predicate.test(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a long Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 1L, 2L]
     * assert array.any{ it > 1L }
     * assert !array.any{ it > 3L }
     * </pre>
     *
     * @param self      the long array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the longs matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(long[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (long item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Returns true if any element of the long array matches the given predicate.
     * A "fat-free" variant of {@link #any(long[], Closure)} accepting a {@link LongPredicate}.
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [1L, 2L, 3L]
     * assert nums.any(n -&gt; n &gt; 2)
     * </pre>
     *
     * @param self      a long array
     * @param predicate the predicate evaluated against each element
     * @return true if any element satisfies the predicate
     * @since 6.0.0
     */
    public static boolean any(long[] self, LongPredicate predicate) {
        Objects.requireNonNull(self);
        for (long item : self) {
            if (predicate.test(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a float Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 1.0f, 2.0f]
     * assert array.any{ it > 1.5f }
     * assert !array.any{ it > 2.5f }
     * </pre>
     *
     * @param self      the float array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the floats matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(float[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (float item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of a double Array, and checks whether a
     * predicate is valid for at least one element.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 1.0d, 2.0d]
     * assert array.any{ it > 1.5d }
     * assert !array.any{ it > 2.5d }
     * </pre>
     *
     * @param self      the double array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the doubles matches the closure predicate
     * @since 5.0.0
     */
    public static boolean any(double[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (double item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Returns true if any element of the double array matches the given predicate.
     * A "fat-free" variant of {@link #any(double[], Closure)} accepting a {@link DoublePredicate}.
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [1.0d, 2.0d, 3.0d]
     * assert nums.any(n -&gt; n &gt; 2)
     * </pre>
     *
     * @param self      a double array
     * @param predicate the predicate evaluated against each element
     * @return true if any element satisfies the predicate
     * @since 6.0.0
     */
    public static boolean any(double[] self, DoublePredicate predicate) {
        Objects.requireNonNull(self);
        for (double item : self) {
            if (predicate.test(item)) return true;
        }
        return false;
    }

    /**
     * Iterates over the contents of an Array, and checks whether a
     * predicate is valid for at least one element.
     *
     * @param self      the array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if any iteration for the object matches the closure predicate
     * @since 2.5.0
     */
    public static <T> boolean any(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (T item : self) {
            if (bcw.call(item)) return true;
        }
        return false;
    }

    /**
     * Returns true if any element of the array matches the given predicate.
     * A "fat-free" variant of {@link #any(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3]
     * assert nums.any(n -&gt; n &gt; 2)
     * assert !nums.any(n -&gt; n &gt; 5)
     * </pre>
     *
     * @param self      an array
     * @param predicate the predicate evaluated against each element
     * @return true if any element satisfies the predicate
     * @since 6.0.0
     */
    public static <T> boolean any(T[] self, Predicate<? super T> predicate) {
        Objects.requireNonNull(self);
        for (T item : self) {
            if (predicate.test(item)) return true;
        }
        return false;
    }

    //--------------------------------------------------------------------------
    // asBoolean

    /**
     * Coerces a boolean array to a boolean value.
     * A boolean array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(boolean[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces a byte array to a boolean value.
     * A byte array is false if the array is null or of length 0,
     * and true otherwise.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array1 = []
     * assert !array1
     * byte[] array2 = [0]
     * assert array2
     * </pre>
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(byte[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces a char array to a boolean value.
     * A char array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(char[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces a short array to a boolean value.
     * A short array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(short[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces an int array to a boolean value.
     * An int array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(int[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces a long array to a boolean value.
     * A long array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(long[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces a float array to a boolean value.
     * A float array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(float[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces a double array to a boolean value.
     * A double array is false if the array is of length 0,
     * and true otherwise.
     *
     * @param self an array
     * @return the array's boolean value
     * @since 1.7.4
     */
    public static boolean asBoolean(double[] self) {
        return self != null && self.length > 0;
    }

    /**
     * Coerces an object array to a boolean value.
     * An Object array is false if the array is of length 0.
     * and to true otherwise
     *
     * @param self the array
     * @return the boolean value
     * @since 1.7.0
     */
    public static boolean asBoolean(Object[] self) {
        return self != null && self.length > 0;
    }

    //--------------------------------------------------------------------------
    // asType

    /**
     * Converts the given array to either a List, Set, or SortedSet. If the given class is
     * something else, the call is deferred to {@link DefaultGroovyMethods#asType(Object,Class)}.
     *
     * @param self an array
     * @param type the desired class
     * @return the object resulting from this type conversion
     * @since 1.5.1
     */
    @SuppressWarnings("unchecked")
    public static <T> T asType(Object[] self, Class<T> type) {
        if (type == List.class) {
            return (T) new ArrayList<>(Arrays.asList(self));
        }
        if (type == Set.class) {
            return (T) new HashSet<>(Arrays.asList(self));
        }
        if (type == SortedSet.class) {
            return (T) new TreeSet<>(Arrays.asList(self));
        }
        return DefaultGroovyMethods.asType((Object) self, type);
    }

    //--------------------------------------------------------------------------
    // average

    /**
     * Calculates the average of the bytes in the array.
     * <pre class="language-groovy groovyTestCase">assert 5.0G == ([2,4,6,8] as byte[]).average()</pre>
     *
     * @param self The array of values to calculate the average of
     * @return The average of the items
     * @since 3.0.0
     */
    public static BigDecimal average(byte[] self) {
        Objects.requireNonNull(self);
        long s = 0;
        for (byte v : self) {
            s += v;
        }
        return (BigDecimal) NumberNumberDiv.div(BigDecimal.valueOf(s), self.length);
    }

    /**
     * Calculates the average of the shorts in the array.
     * <pre class="language-groovy groovyTestCase">assert 5.0G == ([2,4,6,8] as short[]).average()</pre>
     *
     * @param self The array of values to calculate the average of
     * @return The average of the items
     * @since 3.0.0
     */
    public static BigDecimal average(short[] self) {
        Objects.requireNonNull(self);
        long s = 0;
        for (short v : self) {
            s += v;
        }
        return (BigDecimal) NumberNumberDiv.div(BigDecimal.valueOf(s), self.length);
    }

    /**
     * Calculates the average of the ints in the array.
     * <pre class="language-groovy groovyTestCase">assert 5.0G == ([2,4,6,8] as int[]).average()</pre>
     *
     * @param self The array of values to calculate the average of
     * @return The average of the items
     * @since 3.0.0
     */
    public static BigDecimal average(int[] self) {
        Objects.requireNonNull(self);
        long s = 0;
        for (int v : self) {
            s += v;
        }
        return (BigDecimal) NumberNumberDiv.div(BigDecimal.valueOf(s), self.length);
    }

    /**
     * Calculates the average of the longs in the array.
     * <pre class="language-groovy groovyTestCase">assert 5.0G == ([2,4,6,8] as long[]).average()</pre>
     *
     * @param self The array of values to calculate the average of
     * @return The average of the items
     * @since 3.0.0
     */
    public static BigDecimal average(long[] self) {
        Objects.requireNonNull(self);
        long s = 0;
        for (long v : self) {
            s += v;
        }
        return (BigDecimal) NumberNumberDiv.div(BigDecimal.valueOf(s), self.length);
    }

    /**
     * Calculates the average of the floats in the array.
     * <pre class="language-groovy groovyTestCase">assert 5.0d == ([2,4,6,8] as float[]).average()</pre>
     *
     * @param self The array of values to calculate the average of
     * @return The average of the items
     * @since 3.0.0
     */
    public static double average(float[] self) {
        Objects.requireNonNull(self);
        double s = 0.0d;
        for (float v : self) {
            s += v;
        }
        return s / self.length;
    }

    /**
     * Calculates the average of the doubles in the array.
     * <pre class="language-groovy groovyTestCase">assert 5.0d == ([2,4,6,8] as double[]).average()</pre>
     *
     * @param self The array of values to calculate the average of
     * @return The average of the items
     * @since 3.0.0
     */
    public static double average(double[] self) {
        Objects.requireNonNull(self);
        double s = 0.0d;
        for (double v : self) {
            s += v;
        }
        return s / self.length;
    }

    /**
     * Averages the items in an array. This is equivalent to invoking the
     * "plus" method on all items in the array and then dividing by the
     * total count using the "div" method for the resulting sum.
     * <pre class="language-groovy groovyTestCase">
     * assert 3 == ([1, 2, 6] as Integer[]).average()
     * </pre>
     *
     * @param self The array of values to average
     * @return The average of all the items
     * @see #sum(java.lang.Object[])
     * @since 3.0.0
     */
    public static Object average(Object[] self) {
        Object result = sum(self);
        MetaClass metaClass = InvokerHelper.getMetaClass(result);
        result = metaClass.invokeMethod(result, "div", self.length);
        return result;
    }

    /**
     * Averages the result of applying a closure to each item of an array.
     * <code>array.average(closure)</code> is equivalent to:
     * <code>array.collect(closure).average()</code>.
     * <pre class="language-groovy groovyTestCase">
     * def (nums, strings) = [[1, 3] as Integer[], ['to', 'from'] as String[]]
     * assert 20 == nums.average { it * 10 }
     * assert 3 == strings.average { it.size() }
     * assert 3 == strings.average (String::size)
     * </pre>
     *
     * @param self    An array
     * @param closure a single parameter closure that returns a (typically) numeric value.
     * @return The average of the values returned by applying the closure to each
     *         item of the array.
     * @since 3.0.0
     */
    public static <T> Object average(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        return DefaultGroovyMethods.average(new ArrayIterator<>(self), closure);
    }

    //--------------------------------------------------------------------------
    // chop

    /**
     * Chops the boolean array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, false]
     * assert array.chop(1, 2) == [[false], [true, false]]
     * </pre>
     *
     * @param self      a boolean Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Boolean>> chop(boolean[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new BooleanArrayIterator(self), chopSizes));
    }

    /**
     * Chops the byte array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      a byte Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Byte>> chop(byte[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new ByteArrayIterator(self), chopSizes));
    }

    /**
     * Chops the char array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      a char Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Character>> chop(char[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new CharArrayIterator(self), chopSizes));
    }

    /**
     * Chops the short array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      a short Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Short>> chop(short[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new ShortArrayIterator(self), chopSizes));
    }

    /**
     * Chops the int array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      an int Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Integer>> chop(int[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new IntArrayIterator(self), chopSizes));
    }

    /**
     * Chops the long array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      a long Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Long>> chop(long[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new LongArrayIterator(self), chopSizes));
    }

    /**
     * Chops the float array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      a float Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Float>> chop(float[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new FloatArrayIterator(self), chopSizes));
    }

    /**
     * Chops the double array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0, 1, 2]
     * assert array.chop(1, 2) == [[0], [1, 2]]
     * </pre>
     *
     * @param self      a double Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see ArrayGroovyMethods#collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 5.0.0
     */
    public static List<List<Double>> chop(double[] self, int... chopSizes) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.chop(new DoubleArrayIterator(self), chopSizes));
    }

    /**
     * Chops the array into pieces, returning lists with sizes corresponding to the supplied chop sizes.
     * If the array isn't large enough, truncated (possibly empty) pieces are returned.
     * Using a chop size of -1 will cause that piece to contain all remaining items from the array.
     *
     * @param self      an Array to be chopped
     * @param chopSizes the sizes for the returned pieces
     * @return a list of lists chopping the original array elements into pieces determined by chopSizes
     * @see #collate(Object[], int) to chop a list into pieces of a fixed size
     * @since 2.5.2
     */
    public static <T> List<List<T>> chop(T[] self, int... chopSizes) {
        return DefaultGroovyMethods.chop(Arrays.asList(self), chopSizes);
    }

    //--------------------------------------------------------------------------
    // collate

    /**
     * Collates an array.
     *
     * @param self          an array
     * @param size          the length of each sub-list in the returned list
     * @return a List containing the array values collated into sub-lists
     * @see DefaultGroovyMethods#collate(Iterable, int)
     * @since 2.5.0
     */
    public static <T> List<List<T>> collate(T[] self, int size) {
        return collate(self, size, true);
    }

    /**
     * Collates an array into sub-lists.
     *
     * @param self          an array
     * @param size          the length of each sub-list in the returned list
     * @param step          the number of elements to step through for each sub-list
     * @return a List containing the array elements collated into sub-lists
     * @see DefaultGroovyMethods#collate(Iterable, int, int)
     * @since 2.5.0
     */
    public static <T> List<List<T>> collate(T[] self, int size, int step) {
        return collate(self, size, step, true);
    }

    /**
     * Collates this array into sub-lists.
     *
     * @param self          an array
     * @param size          the length of each sub-list in the returned list
     * @param keepRemainder if true, any remaining elements are returned as sub-lists; otherwise, they are discarded
     * @return a List containing the array elements collated into sub-lists
     * @see DefaultGroovyMethods#collate(Iterable, int, boolean)
     * @since 2.5.0
     */
    public static <T> List<List<T>> collate(T[] self, int size, boolean keepRemainder) {
        return collate(self, size, size, keepRemainder);
    }

    /**
     * Collates this array into sub-lists.
     *
     * @param self          an array
     * @param size          the length of each sub-list in the returned list
     * @param step          the number of elements to step through for each sub-list
     * @param keepRemainder if true, any remaining elements are returned as sub-lists; otherwise, they are discarded
     * @return a List containing the array elements collated into sub-lists
     * @since 2.5.0
     */
    public static <T> List<List<T>> collate(T[] self, int size, int step, boolean keepRemainder) {
        return DefaultGroovyMethods.collate(new ArrayIterable<>(self), size, step, keepRemainder);
    }

    //--------------------------------------------------------------------------
    // collect

    /**
     * Iterates through this Array transforming each item into a new value using the
     * <code>transform</code> closure, returning a list of transformed values.
     *
     * @param self      an array
     * @param transform the closure used to transform each item of the Array
     * @return A list of the transformed values.
     * @since 2.5.0
     */
    public static <E, T> List<T> collect(E[] self, @ClosureParams(FirstParam.Component.class) Closure<T> transform) {
        return DefaultGroovyMethods.collect(new ArrayIterator<>(self), transform);
    }

    /**
     * Iterates through an array transforming each element using the transform function.
     * A "fat-free" variant of {@link #collect(Object[], Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3]
     * assert nums.collect(n -&gt; n * 2) == [2, 4, 6]
     * </pre>
     *
     * @param self      an array
     * @param transform the transform function applied to each element
     * @return a List of the transformed values
     * @since 6.0.0
     */
    public static <E, T> List<T> collect(E[] self, Function<? super E, ? extends T> transform) {
        return DefaultGroovyMethods.collect(new ArrayIterator<>(self), transform);
    }

    /**
     * Iterates through this Array transforming each item into a new value using the <code>transform</code> closure
     * and adding it to the supplied <code>collector</code>.
     *
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1,2,3]
     * List<Integer> answer = []
     * nums.collect(answer) { it * 2 }
     * assert answer == [2,4,6]
     * </pre>
     *
     * @param self      an array
     * @param collector the Collection to which the transformed values are added
     * @param transform the closure used to transform each item
     * @return The collector with all transformed values added to it.
     * @since 2.5.0
     */
    public static <E, T, C extends Collection<T>> C collect(E[] self, C collector, @ClosureParams(FirstParam.Component.class) Closure<? extends T> transform) {
        return DefaultGroovyMethods.collect(new ArrayIterator<>(self), collector, transform);
    }

    /**
     * Iterates through an array transforming each element using the transform function
     * and adding it to the collector. A "fat-free" variant of
     * {@link #collect(Object[], Collection, Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3]
     * assert nums.collect(['x'], n -&gt; n * 2) == ['x', 2, 4, 6]
     * </pre>
     *
     * @param self      an array
     * @param collector an initial collection to add the transformed values to
     * @param transform the transform function applied to each element
     * @return the collector with the transformed values added to it
     * @since 6.0.0
     */
    public static <E, T, C extends Collection<T>> C collect(E[] self, C collector, Function<? super E, ? extends T> transform) {
        return DefaultGroovyMethods.collect(new ArrayIterable<>(self), collector, transform);
    }

    //--------------------------------------------------------------------------
    // collectEntries

    /**
     * A variant of collectEntries using the identity closure as the transform.
     *
     * @param self      an array
     * @return the collector with all transformed values added to it
     * @see #collectEntries(Object[], Closure)
     * @since 1.8.5
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self) {
        return collectEntries(self, Closure.IDENTITY);
    }

    /**
     * A variant of collectEntries using the identity closure as the transform.
     *
     * @param self      an array
     * @param collector the Map into which the transformed entries are put
     * @return the collector with all transformed values added to it
     * @see #collectEntries(Object[], Map, Closure)
     * @since 1.8.5
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, Map<K, V> collector) {
        return collectEntries(self, collector, Closure.IDENTITY);
    }

    /**
     * Iterates through this array transforming each item using the <code>transform</code> closure
     * and returning a map of the resulting transformed entries.
     *
     * <pre class="language-groovy groovyTestCase">
     * def letters = "abc"
     * def nums = [0, 1, 2] as Integer[]
     * // collect letters with index using list style
     * assert nums.collectEntries { index -&gt; [index, letters[index]] } == [0:'a', 1:'b', 2:'c']
     * // collect letters with index using map style
     * assert nums.collectEntries { index -&gt; [(index): letters[index]] } == [0:'a', 1:'b', 2:'c']
     * </pre>
     *
     * Note: When using the list-style of result, the behavior is '<code>def (key, value) = listResultFromClosure</code>'.
     * While we strongly discourage using a list of size other than 2, Groovy's normal semantics apply in this case;
     * throwing away elements after the second one and using null for the key or value for the case of a shortened list.
     *
     * @param self      a Collection
     * @param transform the closure used for transforming, which has an item from self as the parameter and
     *                  should return a Map.Entry, a Map or a two-element list containing the resulting key and value
     * @return a Map of the transformed entries
     * @see DefaultGroovyMethods#collectEntries(Iterator, Map, Closure)
     * @since 1.7.9
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, @ClosureParams(FirstParam.Component.class) Closure<?> transform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterator<>(self), new LinkedHashMap<>(), transform);
    }

    /**
     * Iterates through an array transforming each element into a map entry using the
     * transform function. A "fat-free" variant of {@link #collectEntries(Object[], Closure)}
     * accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * String[] words = ['a', 'bb', 'ccc']
     * assert words.collectEntries(w -&gt; new MapEntry(w, w.size())) == [a: 1, bb: 2, ccc: 3]
     * </pre>
     *
     * @param self      an array
     * @param transform the transform function applied to each element, returning a map entry
     * @return a Map of the collected entries
     * @since 6.0.0
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, Function<? super E, ? extends Map.Entry<K, V>> transform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterable<>(self), transform);
    }

    /**
     * Iterates through this array transforming each item using the <code>transform</code> closure
     * and returning a map of the resulting transformed entries.
     *
     * <pre class="language-groovy groovyTestCase">
     * def letters = "abc"
     * def nums = [0, 1, 2] as Integer[]
     * // collect letters with index
     * assert nums.collectEntries( [:] ) { index -&gt; [index, letters[index]] } == [0:'a', 1:'b', 2:'c']
     * assert nums.collectEntries( [4:'d'] ) { index -&gt; [(index+1): letters[index]] } == [1:'a', 2:'b', 3:'c', 4:'d']
     * </pre>
     *
     * Note: When using the list-style of result, the behavior is '<code>def (key, value) = listResultFromClosure</code>'.
     * While we strongly discourage using a list of size other than 2, Groovy's normal semantics apply in this case;
     * throwing away elements after the second one and using null for the key or value for the case of a shortened list.
     * If your collector Map doesn't support null keys or values, you might get a runtime error, e.g. NullPointerException or IllegalArgumentException.
     *
     * @param self      an array
     * @param collector the Map into which the transformed entries are put
     * @param transform the closure used for transforming, which has an item from self as the parameter and
     *                  should return a Map.Entry, a Map or a two-element list containing the resulting key and value
     * @return the collector with all transformed values added to it
     * @see DefaultGroovyMethods#collect(Map, Collection, Closure)
     * @since 1.7.9
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, Map<K, V> collector, @ClosureParams(FirstParam.Component.class) Closure<?> transform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterator<>(self), collector, transform);
    }

    /**
     * Iterates through an array transforming each element into a map entry using the
     * transform function and adding it to the collector. A "fat-free" variant of
     * {@link #collectEntries(Object[], Map, Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * String[] words = ['bb', 'ccc']
     * assert words.collectEntries([a: 1], w -&gt; new MapEntry(w, w.size())) == [a: 1, bb: 2, ccc: 3]
     * </pre>
     *
     * @param self      an array
     * @param collector an initial map to add the collected entries to
     * @param transform the transform function applied to each element, returning a map entry
     * @return the collector with the collected entries added to it
     * @since 6.0.0
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, Map<K, V> collector, Function<? super E, ? extends Map.Entry<K, V>> transform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterable<>(self), collector, transform);
    }

    /**
     * A variant of collectEntries for arrays with separate functions for transforming the keys and values.
     *
     * <pre class="language-groovy groovyTestCase">
     * String[] languages = ['Groovy', 'Java', 'Kotlin', 'Scala']
     * def firstLetter = (s) -&gt; s[0]
     * assert languages.collectEntries(firstLetter, String::size) == [G:6, J:4, K:6, S:5]
     * </pre>
     *
     * @param self           an array
     * @param keyTransform   a function for transforming array elements into keys
     * @param valueTransform a function for transforming array elements into values
     * @return a Map of the transformed entries
     * @since 5.0.0
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, Function<? super E, K> keyTransform, Function<? super E, V> valueTransform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterator<>(self), new LinkedHashMap<>(), keyTransform, valueTransform);
    }

    /**
     * A variant of collectEntries for arrays with separate functions for transforming the keys and values.
     * The supplied collector map is used as the destination for transformed entries.
     *
     * @param self           an array
     * @param collector      the Map into which the transformed entries are put
     * @param keyTransform   a function for transforming array elements into keys
     * @param valueTransform a function for transforming array elements into values
     * @return the collector with all transformed values added to it
     * @since 5.0.0
     */
    public static <K, V, E> Map<K, V> collectEntries(E[] self, Map<K, V> collector, Function<? super E, K> keyTransform, Function<? super E, V> valueTransform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterator<>(self), collector, keyTransform, valueTransform);
    }

    //--------------------------------------------------------------------------
    // collectMany

    /**
     * Projects each item from a source array to a collection and concatenates (flattens) the resulting collections into a single list.
     * <pre class="language-groovy groovyTestCase">
     * def nums = [1, 2, 3, 4, 5, 6] as Object[]
     * def squaresAndCubesOfEvens = nums.collectMany{ it % 2 ? [] : [it**2, it**3] }
     * assert squaresAndCubesOfEvens == [4, 8, 16, 64, 36, 216]
     * </pre>
     *
     * @param self       an array
     * @param projection a projecting Closure returning a collection of items
     * @return A list created from the projected collections concatenated (flattened) together.
     * @since 1.8.1
     */
    public static <T, E> List<T> collectMany(E[] self, @ClosureParams(FirstParam.Component.class) Closure<? extends Collection<? extends T>> projection) {
        return collectMany(self, new ArrayList<>(), projection);
    }

    /**
     * Projects each item from a source array to a collection and concatenates
     * (flattens) the resulting collections into a single list. A "fat-free" variant of
     * {@link #collectMany(Object[], Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = 1..10
     * def squaresAndCubesOfEvens = nums.collectMany(n -&gt; n % 2 ? [] : [n**2, n**3])
     * assert squaresAndCubesOfEvens == [4, 8, 16, 64, 36, 216, 64, 512, 100, 1000]
     * </pre>
     *
     * @param self       an array
     * @param projection a projecting function returning a collection of items
     * @return a list created from the projected collections concatenated (flattened) together
     * @since 6.0.0
     */
    public static <T, E> List<T> collectMany(E[] self, Function<? super E, ? extends Collection<? extends T>> projection) {
        return collectMany(self, new ArrayList<>(), projection);
    }

    /**
     * Projects each item from a source array to a collection and concatenates (flattens) the resulting collections into a single list.
     * <pre class="language-groovy groovyTestCase">
     * def nums = [1, 2, 3, 4, 5, 6] as Object[]
     * def squaresAndCubesOfEvens = nums.collectMany{ it % 2 ? [] : [it**2, it**3] }
     * assert squaresAndCubesOfEvens == [4, 8, 16, 64, 36, 216]
     * </pre>
     *
     * @param self       an array
     * @param collector  an initial collection to add the projected items to
     * @param projection a projecting Closure returning a collection of items
     * @return The collector with the projected collections concatenated (flattened) to it.
     * @since 1.8.1
     */
    public static <T, E, C extends Collection<T>> C collectMany(E[] self, C collector, @ClosureParams(FirstParam.Component.class) Closure<? extends Collection<? extends T>> projection) {
        return DefaultGroovyMethods.collectMany(new ArrayIterable<>(self), collector, projection);
    }

    /**
     * Projects each item from a source array to a result collection and concatenates
     * (flattens) the resulting collections adding them into the <code>collector</code>.
     * A "fat-free" variant of {@link #collectMany(Object[], Collection, Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4, 5]
     * def origPlusIncrements = nums.collectMany([] as Set, n -&gt; [n, n + 1])
     * assert origPlusIncrements.size() == nums.size() + 1
     * </pre>
     *
     * @param self       an array
     * @param collector  an initial collection to add the projected items to
     * @param projection a projecting function returning a collection of items
     * @return the collector with the projected collections concatenated (flattened) into it
     * @since 6.0.0
     */
    public static <T, E, C extends Collection<T>> C collectMany(E[] self, C collector, Function<? super E, ? extends Collection<? extends T>> projection) {
        return DefaultGroovyMethods.collectMany(new ArrayIterable<>(self), collector, projection);
    }

    //--------------------------------------------------------------------------
    // column

    /**
     * Select a column from a 2D array.
     * <pre class="language-groovy groovyTestCase">
     * double[][] nums = [[1.0d, 2.0d], [10.0d, 20.0d]]
     * assert nums.column(0) == [1.0d, 10.0d] as double[]
     * assert nums.column(1) == [2.0d, 20.0d] as double[]
     * </pre>
     *
     * @param self a double[][]
     * @return a double[]
     * @since 5.0.0
     */
    public static double[] column(double[][] self, int col) {
        Objects.requireNonNull(self);
        int rows = self.length;
        if (rows == 0) {
            return new double[0];
        }
        validateCol(self[0].length, col);
        final double[] result = new double[rows];
        for (int row = 0; row < rows; row++) {
            result[row] = self[row][col];
        }
        return result;
    }

    /**
     * Select a column from a 2D array.
     * <pre class="language-groovy groovyTestCase">
     * float[][] nums = [[1.0f, 2.0f], [10.0f, 20.0f]]
     * assert nums.column(0) == [1.0f, 10.0f] as float[]
     * assert nums.column(1) == [2.0f, 20.0f] as float[]
     * </pre>
     *
     * @param self a float[][]
     * @return a float[]
     * @since 5.0.0
     */
    public static float[] column(float[][] self, int col) {
        Objects.requireNonNull(self);
        int rows = self.length;
        if (rows == 0) {
            return new float[0];
        }
        validateCol(self[0].length, col);
        final float[] result = new float[rows];
        for (int row = 0; row < rows; row++) {
            result[row] = self[row][col];
        }
        return result;
    }

    /**
     * Select a column from a 2D array.
     * <pre class="language-groovy groovyTestCase">
     * int[][] nums = [[1, 2], [10, 20]]
     * assert nums.column(0) == [1, 10] as int[]
     * assert nums.column(1) == [2, 20] as int[]
     * </pre>
     *
     * @param self an int[][]
     * @return an int[]
     * @since 5.0.0
     */
    public static int[] column(int[][] self, int col) {
        Objects.requireNonNull(self);
        int rows = self.length;
        if (rows == 0) {
            return new int[0];
        }
        validateCol(self[0].length, col);
        final int[] result = new int[rows];
        for (int row = 0; row < rows; row++) {
            result[row] = self[row][col];
        }
        return result;
    }

    /**
     * Select a column from a 2D array.
     * <pre class="language-groovy groovyTestCase">
     * long[][] nums = [[1L, 2L], [10L, 20L]]
     * assert nums.column(0) == [1L, 10L] as long[]
     * assert nums.column(1) == [2L, 20L] as long[]
     * </pre>
     *
     * @param self a long[][]
     * @return a long[]
     * @since 5.0.0
     */
    public static long[] column(long[][] self, int col) {
        Objects.requireNonNull(self);
        int rows = self.length;
        if (rows == 0) {
            return new long[0];
        }
        validateCol(self[0].length, col);
        final long[] result = new long[rows];
        for (int row = 0; row < rows; row++) {
            result[row] = self[row][col];
        }
        return result;
    }

    private static void validateCol(int size, int col) {
        if (col < 0) {
            throw new IllegalArgumentException("Expected column value of " + col + " to be 0 or greater");
        }
        if (col >= size) {
            throw new IllegalArgumentException("Expected column value of " + col + " to be less than " + size);
        }
    }

    //--------------------------------------------------------------------------
    // columns

    @Deprecated
    public static Iterator<double[]> columns(double[][] self) {
        return new DoubleDoubleArrayColumnIterator(self);
    }

    @Deprecated
    public static Iterator<float[]> columns(float[][] self) {
        return new FloatFloatArrayColumnIterator(self);
    }

    @Deprecated
    public static Iterator<int[]> columns(int[][] self) {
        return new IntIntArrayColumnIterator(self);
    }

    @Deprecated
    public static Iterator<long[]> columns(long[][] self) {
        return new LongLongArrayColumnIterator(self);
    }

    //--------------------------------------------------------------------------
    // contains

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(boolean[] self, Object value) {
        Objects.requireNonNull(self);
        for (boolean next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(byte[] self, Object value) {
        Objects.requireNonNull(self);
        for (byte next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(char[] self, Object value) {
        Objects.requireNonNull(self);
        for (char next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(short[] self, Object value) {
        Objects.requireNonNull(self);
        for (short next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(int[] self, Object value) {
        Objects.requireNonNull(self);
        for (int next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(long[] self, Object value) {
        Objects.requireNonNull(self);
        for (long next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(float[] self, Object value) {
        Objects.requireNonNull(self);
        for (float next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(double[] self, Object value) {
        Objects.requireNonNull(self);
        for (double next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    /**
     * Checks whether the array contains the given value.
     *
     * @param self  the array we are searching
     * @param value the value being searched for
     * @return true if the array contains the value
     * @since 1.8.6
     */
    public static boolean contains(Object[] self, Object value) {
        Objects.requireNonNull(self);
        for (Object next : self) {
            if (DefaultTypeTransformation.compareEqual(value, next)) return true;
        }
        return false;
    }

    //--------------------------------------------------------------------------
    // count

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, true]
     * assert array.count(true) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(boolean[] self, Object value) {
        return DefaultGroovyMethods.count(new BooleanArrayIterator(self), value);
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [10, 20, 20, 30]
     * assert array.count(20) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(byte[] self, Object value) {
        return DefaultGroovyMethods.count(new ByteArrayIterator(self), value);
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['x', 'y', 'z', 'z', 'y']
     * assert array.count('y') == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(char[] self, Object value) {
        return DefaultGroovyMethods.count(new CharArrayIterator(self), value);
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [10, 20, 20, 30]
     * assert array.count(20) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(short[] self, Object value) {
        return DefaultGroovyMethods.count(new ShortArrayIterator(self), value);
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [10, 20, 20, 30]
     * assert array.count(20) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(int[] self, Object value) {
        return DefaultGroovyMethods.count(new IntArrayIterator(self), value);
    }

    /**
     * Counts the number of elements in the int array matching the given predicate.
     * The primitive-array counterpart of {@link #count(Object[], Predicate)}, accepting an {@link IntPredicate}.
     * A value passed instead of a predicate selects {@link #count(int[], Object)} (value equality).
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [1, 2, 3, 4, 5]
     * assert nums.count(n -&gt; n % 2 == 0) == 2
     * </pre>
     *
     * @param self      an int array
     * @param predicate the predicate evaluated against each element
     * @return the number of elements matching the predicate
     * @since 6.0.0
     */
    public static Number count(int[] self, IntPredicate predicate) {
        Objects.requireNonNull(self);
        long answer = 0;
        for (int item : self) {
            if (predicate.test(item)) answer += 1;
        }
        // for b/c with Java return an int if we can
        if (answer <= Integer.MAX_VALUE) return (int) answer;
        return answer;
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [10L, 20L, 20L, 30L]
     * assert array.count(20L) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(long[] self, Object value) {
        return DefaultGroovyMethods.count(new LongArrayIterator(self), value);
    }

    /**
     * Counts the number of elements in the long array matching the given predicate.
     * The primitive-array counterpart of {@link #count(Object[], Predicate)}, accepting a {@link LongPredicate}.
     * A value passed instead of a predicate selects {@link #count(long[], Object)} (value equality).
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [1L, 2L, 3L, 4L, 5L]
     * assert nums.count(n -&gt; n % 2 == 0) == 2
     * </pre>
     *
     * @param self      a long array
     * @param predicate the predicate evaluated against each element
     * @return the number of elements matching the predicate
     * @since 6.0.0
     */
    public static Number count(long[] self, LongPredicate predicate) {
        Objects.requireNonNull(self);
        long answer = 0;
        for (long item : self) {
            if (predicate.test(item)) answer += 1;
        }
        // for b/c with Java return an int if we can
        if (answer <= Integer.MAX_VALUE) return (int) answer;
        return answer;
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [10.0f, 20.0f, 20.0f, 30.0f]
     * assert array.count(20.0f) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(float[] self, Object value) {
        return DefaultGroovyMethods.count(new FloatArrayIterator(self), value);
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code>).
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [10.0d, 20.0d, 20.0d, 30.0d]
     * assert array.count(20.0d) == 2
     * </pre>
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @see DefaultGroovyMethods#count(Iterator, Object)
     * @since 1.6.4
     */
    public static Number count(double[] self, Object value) {
        return DefaultGroovyMethods.count(new DoubleArrayIterator(self), value);
    }

    /**
     * Counts the number of elements in the double array matching the given predicate.
     * The primitive-array counterpart of {@link #count(Object[], Predicate)}, accepting a {@link DoublePredicate}.
     * A value passed instead of a predicate selects {@link #count(double[], Object)} (value equality).
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [1.0d, 2.0d, 3.0d, 4.0d]
     * assert nums.count(n -&gt; n &gt; 2) == 2
     * </pre>
     *
     * @param self      a double array
     * @param predicate the predicate evaluated against each element
     * @return the number of elements matching the predicate
     * @since 6.0.0
     */
    public static Number count(double[] self, DoublePredicate predicate) {
        Objects.requireNonNull(self);
        long answer = 0;
        for (double item : self) {
            if (predicate.test(item)) answer += 1;
        }
        // for b/c with Java return an int if we can
        if (answer <= Integer.MAX_VALUE) return (int) answer;
        return answer;
    }

    /**
     * Counts the number of occurrences of the given value inside this array.
     * Comparison is done using Groovy's == operator (using
     * <code>compareTo(value) == 0</code> or <code>equals(value)</code> ).
     *
     * @param self  the array within which we count the number of occurrences
     * @param value the value being searched for
     * @return the number of occurrences
     * @since 1.6.4
     */
    public static Number count(Object[] self, Object value) {
        return DefaultGroovyMethods.count(Arrays.asList(self), value);
    }

    /**
     * Counts the number of occurrences which satisfy the given closure from inside this array.
     *
     * @param self      the array within which we count the number of occurrences
     * @param predicate a closure condition
     * @return the number of occurrences
     * @since 1.8.0
     */
    public static <T> Number count(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        return DefaultGroovyMethods.count(Arrays.asList(self), predicate);
    }

    /**
     * Counts the number of array elements matching the given predicate.
     * A "fat-free" variant of {@link #count(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4, 5]
     * assert nums.count(n -&gt; n % 2 == 0) == 2
     * </pre>
     *
     * @param self      an array
     * @param predicate the predicate evaluated against each element
     * @return the number of elements matching the predicate
     * @since 6.0.0
     */
    public static <T> Number count(T[] self, Predicate<? super T> predicate) {
        return DefaultGroovyMethods.count(Arrays.asList(self), predicate);
    }

    //-------------------------------------------------------------------------
    // countBy

    /**
     * Sorts all array members into groups determined by the supplied mapping
     * closure and counts the group size.  The closure should return the key that each
     * item should be grouped by.  The returned Map will have an entry for each
     * distinct key returned from the closure, with each value being the frequency of
     * items occurring for that group.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">assert ([1,2,2,2,3] as Object[]).countBy{ it % 2 } == [1:2, 0:3]</pre>
     *
     * @param self    an array to group and count
     * @param closure a closure mapping items to the frequency keys
     * @return a new Map grouped by keys with frequency counts
     * @see DefaultGroovyMethods#countBy(Iterator, Closure)
     * @since 1.8.0
     */
    public static <K, E> Map<K, Integer> countBy(E[] self, @ClosureParams(FirstParam.Component.class) Closure<K> closure) {
        return DefaultGroovyMethods.countBy(new ArrayIterator<>(self), closure);
    }

    /**
     * Sorts all array members into groups determined by the supplied mapping function
     * and counts the group size. A "fat-free" variant of
     * {@link #countBy(Object[], Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4, 5]
     * assert [1: 3, 0: 2] == nums.countBy(n -&gt; n % 2)
     * </pre>
     *
     * @param self     an array to group and count
     * @param function a function mapping items to the frequency keys
     * @return a new Map grouped by keys with frequency counts
     * @since 6.0.0
     */
    public static <K, E> Map<K, Integer> countBy(E[] self, Function<? super E, ? extends K> function) {
        return DefaultGroovyMethods.countBy(new ArrayIterator<>(self), function);
    }

    /**
     * Creates a multiset-like map of the array members.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * assert [1:2, 2:2, 3:1] == ([1,2,1,2,3] as Object[]).countBy()
     * </pre>
     *
     * @param self    an array to group and count
     * @return a new Map where the keys are the set of values in the array and the values are the frequency counts
     * @since 5.0.0
     */
    public static <E> Map<E, Integer> countBy(E[] self) {
        return countBy(self, (Closure<E>) Closure.IDENTITY);
    }

    //-------------------------------------------------------------------------
    // drop

    /**
     * Drops the given number of elements from the head of this array
     * if they are available.
     * <pre class="language-groovy groovyTestCase">
     * String[] strings = [ 'a', 'b', 'c' ]
     * assert strings.drop( 0 ) == [ 'a', 'b', 'c' ] as String[]
     * assert strings.drop( 2 ) == [ 'c' ] as String[]
     * assert strings.drop( 5 ) == [] as String[]
     * </pre>
     *
     * @param self the original array
     * @param num  the number of elements to drop from this array
     * @return An array consisting of all elements of this array except the
     *         first <code>num</code> ones, or else the empty array, if this
     *         array has less than <code>num</code> elements.
     * @since 1.8.1
     */
    public static <T> T[] drop(T[] self, int num) {
        if (self.length <= num) {
            return createSimilarArray(self, 0);
        }
        if (num <= 0) {
            T[] ret = createSimilarArray(self, self.length);
            System.arraycopy(self, 0, ret, 0, self.length);
            return ret;
        }

        T[] ret = createSimilarArray(self, self.length - num);
        System.arraycopy(self, num, ret, 0, self.length - num);
        return ret;
    }

    //--------------------------------------------------------------------------
    // dropRight

    /**
     * Drops the given number of elements from the tail of this array
     * if they are available.
     * <pre class="language-groovy groovyTestCase">
     * String[] strings = [ 'a', 'b', 'c' ]
     * assert strings.dropRight( 0 ) == [ 'a', 'b', 'c' ] as String[]
     * assert strings.dropRight( 2 ) == [ 'a' ] as String[]
     * assert strings.dropRight( 5 ) == [] as String[]
     * </pre>
     *
     * @param self the original array
     * @param num  the number of elements to drop from this array
     * @return An array consisting of all elements of this array except the
     *         last <code>num</code> ones, or else the empty array, if this
     *         array has less than <code>num</code> elements.
     * @since 2.4.0
     */
    public static <T> T[] dropRight(T[] self, int num) {
        if (self.length <= num) {
            return createSimilarArray(self, 0);
        }
        if (num <= 0) {
            T[] ret = createSimilarArray(self, self.length);
            System.arraycopy(self, 0, ret, 0, self.length);
            return ret;
        }

        T[] ret = createSimilarArray(self, self.length - num);
        System.arraycopy(self, 0, ret, 0, self.length - num);
        return ret;
    }

    //--------------------------------------------------------------------------
    // dropWhile

    /**
     * Create a suffix of the given array by dropping as many elements as possible from the
     * front of the original array such that calling the given closure condition evaluates to
     * true when passed each of the dropped elements.
     * <pre class="language-groovy groovyTestCase">
     * def nums = [ 1, 3, 2 ] as Integer[]
     * assert nums.dropWhile{ it {@code <=} 3 } == [ ] as Integer[]
     * assert nums.dropWhile{ it {@code <} 3 } == [ 3, 2 ] as Integer[]
     * assert nums.dropWhile{ it != 2 } == [ 2 ] as Integer[]
     * assert nums.dropWhile{ it == 0 } == [ 1, 3, 2 ] as Integer[]
     * </pre>
     *
     * @param self      the original array
     * @param condition the closure that must evaluate to true to
     *                  continue dropping elements
     * @return The shortest suffix of the given array such that the given closure condition
     *         evaluates to true for each element dropped from the front of the array.
     * @since 1.8.7
     */
    public static <T> T[] dropWhile(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        int num = 0;
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(condition);
        while (num < self.length) {
            if (bcw.call(self[num])) {
                num += 1;
            } else {
                break;
            }
        }
        return drop(self, num);
    }

    /**
     * Returns a suffix of an array where elements are dropped from the front while the predicate is satisfied.
     * A "fat-free" variant of {@link #dropWhile(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 0, 4]
     * assert nums.dropWhile(n -&gt; n &lt; 3).toList() == [3, 0, 4]
     * </pre>
     *
     * @param self      the original array
     * @param condition the predicate that must evaluate to true to continue dropping elements
     * @return the shortest suffix of the given array such that its first element does not pass the given predicate
     * @since 6.0.0
     */
    public static <T> T[] dropWhile(T[] self, Predicate<? super T> condition) {
        int num = 0;
        while (num < self.length) {
            if (condition.test(self[num])) {
                num += 1;
            } else {
                break;
            }
        }
        return drop(self, num);
    }

    //--------------------------------------------------------------------------
    // each

    /**
     * Iterates through a boolean[] passing each boolean to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, false]
     * String result = ''
     * array.each{ result += it.toString()[0] }
     * assert result == 'ftf'
     * </pre>
     *
     * @param self     the boolean array over which we iterate
     * @param consumer the consumer for each boolean
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static boolean[] each(boolean[] self, Consumer<Boolean> consumer) {
        Objects.requireNonNull(self);
        for (boolean item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a boolean[] passing each boolean to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, false]
     * String result = ''
     * array.each{ result += it.toString()[0] }
     * assert result == 'ftf'
     * </pre>
     *
     * @param self    the boolean array over which we iterate
     * @param closure the closure applied on each boolean
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static boolean[] each(boolean[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (boolean item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through a byte[] passing each byte to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1, 2]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self     the byte array over which we iterate
     * @param consumer the consumer for each byte
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static byte[] each(byte[] self, Consumer<Byte> consumer) {
        Objects.requireNonNull(self);
        for (byte item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a byte[] passing each byte to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1, 2]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self    the byte array over which we iterate
     * @param closure the closure applied on each byte
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static byte[] each(byte[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (byte item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through a char[] passing each char to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a' as char, 'b' as char, 'c' as char]
     * String result = ''
     * array.each{ result += it }
     * assert result == 'abc'
     * </pre>
     *
     * @param self     the char array over which we iterate
     * @param consumer the consumer for each char
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static char[] each(char[] self, Consumer<Character> consumer) {
        Objects.requireNonNull(self);
        for (char item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a char[] passing each char to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a' as char, 'b' as char, 'c' as char]
     * String result = ''
     * array.each{ result += it }
     * assert result == 'abc'
     * </pre>
     *
     * @param self    the char array over which we iterate
     * @param closure the closure applied on each char
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static char[] each(char[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (char item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through a short[] passing each short to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1, 2]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self     the short array over which we iterate
     * @param consumer the consumer for each short
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static short[] each(short[] self, Consumer<Short> consumer) {
        Objects.requireNonNull(self);
        for (short item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a short[] passing each short to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1, 2]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self    the short array over which we iterate
     * @param closure the closure applied on each short
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static short[] each(short[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (short item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through an int[] passing each int to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1, 2]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self     the int array over which we iterate
     * @param consumer the consumer for each int
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static int[] each(int[] self, IntConsumer consumer) {
        Objects.requireNonNull(self);
        for (int item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through an int[] passing each int to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1, 2]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self    the int array over which we iterate
     * @param closure the closure applied on each int
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static int[] each(int[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through a long[] passing each long to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 1L, 2L]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self     the long array over which we iterate
     * @param consumer the consumer for each long
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static long[] each(long[] self, LongConsumer consumer) {
        Objects.requireNonNull(self);
        for (long item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a long[] passing each long to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 1L, 2L]
     * String result = ''
     * array.each{ result += it }
     * assert result == '012'
     * </pre>
     *
     * @param self    the long array over which we iterate
     * @param closure the closure applied on each long
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static long[] each(long[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (long item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through a float[] passing each float to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0f, 1f, 2f]
     * String result = ''
     * array.each{ result += it }
     * assert result == '0.01.02.0'
     * </pre>
     *
     * @param self     the float array over which we iterate
     * @param consumer the consumer for each float
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static float[] each(float[] self, Consumer<Float> consumer) {
        Objects.requireNonNull(self);
        for (float item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a float[] passing each float to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0f, 1f, 2f]
     * String result = ''
     * array.each{ result += it }
     * assert result == '0.01.02.0'
     * </pre>
     *
     * @param self    the float array over which we iterate
     * @param closure the closure applied on each float
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static float[] each(float[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (float item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through a double[] passing each double to the given consumer.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0d, 1d, 2d]
     * String result = ''
     * array.each{ result += it }
     * assert result == '0.01.02.0'
     * </pre>
     *
     * @param self     the double array over which we iterate
     * @param consumer the consumer for each double
     * @return the self array
     * @since 5.0.0
     */
    @Incubating
    public static double[] each(double[] self, DoubleConsumer consumer) {
        Objects.requireNonNull(self);
        for (double item : self) {
            consumer.accept(item);
        }
        return self;
    }

    /**
     * Iterates through a double[] passing each double to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0d, 1d, 2d]
     * String result = ''
     * array.each{ result += it }
     * assert result == '0.01.02.0'
     * </pre>
     *
     * @param self    the double array over which we iterate
     * @param closure the closure applied on each double
     * @return the self array
     * @since 6.0.0
     */
    @Incubating
    public static double[] each(double[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (double item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through an array passing each array entry to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['a', 'b', 'c']
     * String result = ''
     * letters.each{ result += it }
     * assert result == 'abc'
     * </pre>
     *
     * @param self    the array over which we iterate
     * @param closure the closure applied on each array entry
     * @return the self array
     * @since 2.5.0
     */
    public static <T> T[] each(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        for (T item : self) {
            closure.call(item);
        }
        return self;
    }

    /**
     * Iterates through an array, passing each element to the given consumer.
     * A "fat-free" variant of {@link #each(Object[], Closure)} accepting a {@link Consumer}.
     * <pre class="language-groovy groovyTestCase">
     * def result = []
     * assert (['a', 'b', 'c'] as String[]).each(result::add).length == 3
     * assert result == ['a', 'b', 'c']
     * </pre>
     *
     * @param self     the array over which we iterate
     * @param consumer the consumer applied on each element found
     * @return the self array
     * @since 6.0.0
     */
    public static <T> T[] each(T[] self, Consumer<? super T> consumer) {
        for (T item : self) {
            consumer.accept(item);
        }
        return self;
    }

    //--------------------------------------------------------------------------
    // eachByte

    /**
     * Traverses through each byte of this byte array.
     *
     * @param self    a byte array
     * @param closure a closure
     * @since 1.5.5
     */
    public static void eachByte(byte[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (double item : self) {
            closure.call(item);
        }
    }

    /**
     * Traverses through each byte of this Byte array. Alias for each.
     *
     * @param self    a Byte array
     * @param closure a closure
     * @since 1.5.5
     */
    public static void eachByte(Byte[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        each(self, closure);
    }

    //--------------------------------------------------------------------------
    // eachColumn

    /**
     * Process the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * double[][] nums = [[1.0d, 2.0d], [10.0d, 20.0d]]
     * nums.eachColumn {
     *     assert it[0] * 10.0d == it[1]
     * }
     * </pre>
     *
     * @param self a double[][]
     * @param closure the closure applied on each array column
     * @return the self array
     * @since 5.0.0
     */
    public static double[][] eachColumn(double[][] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        DefaultGroovyMethods.each(new DoubleDoubleArrayColumnIterator(self), closure);
        return self;
    }

    /**
     * Process the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * double[][] nums = [[1.0f, 2.0f], [10.0f, 20.0f]]
     * nums.eachColumn {
     *     assert it[0] * 10.0f == it[1]
     * }
     * </pre>
     *
     * @param self a float[][]
     * @param closure the closure applied on each array column
     * @return the self array
     * @since 5.0.0
     */
    public static float[][] eachColumn(float[][] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        DefaultGroovyMethods.each(new FloatFloatArrayColumnIterator(self), closure);
        return self;
    }

    /**
     * Process the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * double[][] nums = [[1, 2], [10, 20]]
     * nums.eachColumn {
     *     assert it[0] * 10 == it[1]
     * }
     * </pre>
     *
     * @param self an int[][]
     * @param closure the closure applied on each array column
     * @return the self array
     * @since 5.0.0
     */
    public static int[][] eachColumn(int[][] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        DefaultGroovyMethods.each(new IntIntArrayColumnIterator(self), closure);
        return self;
    }

    /**
     * Process the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * double[][] nums = [[1L, 2L], [10L, 20L]]
     * nums.eachColumn {
     *     assert it[0] * 10L == it[1]
     * }
     * </pre>
     *
     * @param self a long[][]
     * @param closure the closure applied on each array column
     * @return the self array
     * @since 5.0.0
     */
    public static long[][] eachColumn(long[][] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        DefaultGroovyMethods.each(new LongLongArrayColumnIterator(self), closure);
        return self;
    }

    //--------------------------------------------------------------------------
    // eachWithIndex

    /**
     * Iterates through a boolean[],
     * passing each boolean and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, false]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(false)1(true)2(false)'
     * </pre>
     *
     * @param self    a boolean array
     * @param closure a Closure to operate on each boolean
     * @return the self array
     * @since 5.0.0
     */
    public static boolean[] eachWithIndex(boolean[] self, @ClosureParams(value=FromString.class,options="Boolean,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through a byte[],
     * passing each byte and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [10, 20, 30]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(10)1(20)2(30)'
     * </pre>
     *
     * @param self    a byte array
     * @param closure a Closure to operate on each byte
     * @return the self array
     * @since 5.0.0
     */
    public static byte[] eachWithIndex(byte[] self, @ClosureParams(value=FromString.class,options="Byte,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through a char[],
     * passing each char and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a' as char, 'b' as char, 'c' as char]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(a)1(b)2(c)'
     * </pre>
     *
     * @param self    a char array
     * @param closure a Closure to operate on each char
     * @return the self array
     * @since 5.0.0
     */
    public static char[] eachWithIndex(char[] self, @ClosureParams(value=FromString.class,options="Character,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through a short[],
     * passing each short and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [10, 20, 30]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(10)1(20)2(30)'
     * </pre>
     *
     * @param self    a short array
     * @param closure a Closure to operate on each short
     * @return the self array
     * @since 5.0.0
     */
    public static short[] eachWithIndex(short[] self, @ClosureParams(value=FromString.class,options="Short,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through an int[],
     * passing each int and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [10, 20, 30]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(10)1(20)2(30)'
     * </pre>
     *
     * @param self    an int array
     * @param closure a Closure to operate on each int
     * @return the self array
     * @since 5.0.0
     */
    public static int[] eachWithIndex(int[] self, @ClosureParams(value=FromString.class,options="Integer,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through a long[],
     * passing each long and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [10L, 20L, 30L]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(10)1(20)2(30)'
     * </pre>
     *
     * @param self    a long array
     * @param closure a Closure to operate on each long
     * @return the self array
     * @since 5.0.0
     */
    public static long[] eachWithIndex(long[] self, @ClosureParams(value=FromString.class,options="Long,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through a float[],
     * passing each float and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [10f, 20f, 30f]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(10.0)1(20.0)2(30.0)'
     * </pre>
     *
     * @param self    a float array
     * @param closure a Closure to operate on each float
     * @return the self array
     * @since 5.0.0
     */
    public static float[] eachWithIndex(float[] self, @ClosureParams(value=FromString.class,options="Float,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through a double[],
     * passing each double and the element's index (a counter starting at
     * zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [10d, 20d, 30d]
     * String result = ''
     * array.eachWithIndex{ item, index {@code ->} result += "$index($item)" }
     * assert result == '0(10.0)1(20.0)2(30.0)'
     * </pre>
     *
     * @param self    a double array
     * @param closure a Closure to operate on each double
     * @return the self array
     * @since 5.0.0
     */
    public static double[] eachWithIndex(double[] self, @ClosureParams(value=FromString.class,options="Double,Integer") Closure<?> closure) {
        Objects.requireNonNull(self);
        final Object[] args = new Object[2];
        for (int i = 0, n = self.length; i < n; i += 1) {
            args[0] = self[i];
            args[1] = i;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through an array, passing each array element and the element's
     * index (a counter starting at zero) to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['a', 'b', 'c']
     * String result = ''
     * letters.eachWithIndex{ letter, index {@code ->} result += "$index:$letter" }
     * assert result == '0:a1:b2:c'
     * </pre>
     *
     * @param self    an array
     * @param closure a Closure to operate on each array entry
     * @return the self array
     * @since 2.5.0
     */
    public static <T> T[] eachWithIndex(T[] self, @ClosureParams(value=FromString.class,options="T,Integer") Closure<?> closure) {
        final Object[] args = new Object[2];
        int counter = 0;
        for(T item : self) {
            args[0] = item;
            args[1] = counter++;
            closure.call(args);
        }
        return self;
    }

    /**
     * Iterates through an array, passing each element and its index to the given consumer.
     * A "fat-free" variant of {@link #eachWithIndex(Object[], Closure)} accepting an {@link ObjIntConsumer}.
     * <pre class="language-groovy groovyTestCase">
     * def result = [:]
     * (['a', 'b', 'c'] as String[]).eachWithIndex((item, index) -&gt; result[index] = item)
     * assert result == [0: 'a', 1: 'b', 2: 'c']
     * </pre>
     *
     * @param self     the array over which we iterate
     * @param consumer the consumer applied on each element and its index
     * @return the self array
     * @since 6.0.0
     */
    public static <T> T[] eachWithIndex(T[] self, ObjIntConsumer<? super T> consumer) {
        int counter = 0;
        for (T item : self) {
            consumer.accept(item, counter++);
        }
        return self;
    }

    //--------------------------------------------------------------------------
    // equals

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array1 = [true, false]
     * boolean[] array2 = [true, false]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a boolean array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(boolean[] self, boolean[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * byte[] array1 = [4, 8]
     * byte[] array2 = [4, 8]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a byte array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(byte[] self, byte[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * char[] array1 = ['a', 'b']
     * char[] array2 = ['a', 'b']
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a char array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(char[] self, char[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * short[] array1 = [4, 8]
     * short[] array2 = [4, 8]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a short array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(short[] self, short[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] array1 = [4, 8]
     * int[] array2 = [4, 8]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  an int array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(int[] self, int[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] array1 = [4L, 8L]
     * long[] array2 = [4L, 8L]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a long array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(long[] self, long[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] array1 = [4.0f, 8.0f]
     * float[] array2 = [4.0f, 8.0f]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a float array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(float[] self, float[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Compares the contents of this array to the contents of the given array.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] array1 = [4.0d, 8.0d]
     * double[] array2 = [4.0d, 8.0d]
     * assert array1 !== array2
     * assert array1.equals(array2)
     * </pre>
     *
     * @param self  a double array
     * @param right the array being compared
     * @return true if the contents of both arrays are equal.
     * @since 5.0.0
     */
    public static boolean equals(double[] self, double[] right) {
        return Arrays.equals(self, right);
    }

    /**
     * Determines if the contents of this array are equal to the
     * contents of the given list, in the same order. This returns
     * <code>false</code> if either collection is <code>null</code>.
     *
     * @param left  an array
     * @param right the List being compared
     * @return {@code true} if the contents of both collections are equal.
     * @since 1.5.0
     */
    public static boolean equals(Object[] left, List<?> right) {
        return DefaultGroovyMethods.equals(right, left);
    }

    //--------------------------------------------------------------------------
    // every

    /**
     * Iterates over the contents of a boolean Array, and checks whether
     * every element is true.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array1 = [false, true]
     * assert !array1.every()
     * boolean[] array2 = [true, true]
     * assert array2.every()
     * </pre>
     *
     * @param self the boolean array over which we iterate
     * @return true if no boolean is false
     * @since 5.0.0
     */
    public static boolean every(boolean[] self) {
        Objects.requireNonNull(self);
        for (boolean item : self) {
            if (!item) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a boolean Array, and checks whether a
     * predicate is valid for every element.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true]
     * assert array.every{ it }
     * assert !array.every{ !it }
     * </pre>
     *
     * @param self      the boolean array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(boolean[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (boolean item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a byte Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1, 2]
     * assert array.every{ it &lt; 3 }
     * assert !array.every{ it > 1 }
     * </pre>
     *
     * @param self      the byte array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(byte[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (byte item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a char Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a', 'b', 'c']
     * assert array.every{ it &lt;= 'd' }
     * assert !array.every{ it > 'b' }
     * </pre>
     *
     * @param self      the char array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(char[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (char item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a short Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1, 2]
     * assert array.every{ it &lt; 3 }
     * assert !array.every{ it > 1 }
     * </pre>
     *
     * @param self      the char array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(short[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (short item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of an int Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1, 2]
     * assert array.every{ it &lt; 3 }
     * assert !array.every{ it > 1 }
     * </pre>
     *
     * @param self      the int array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(int[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (int item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Returns true if every element of the int array matches the given predicate.
     * A "fat-free" variant of {@link #every(int[], Closure)} accepting an {@link IntPredicate}.
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [2, 4, 6]
     * assert nums.every(n -&gt; n % 2 == 0)
     * </pre>
     *
     * @param self      an int array
     * @param predicate the predicate evaluated against each element
     * @return true if every element satisfies the predicate
     * @since 6.0.0
     */
    public static boolean every(int[] self, IntPredicate predicate) {
        Objects.requireNonNull(self);
        for (int item : self) {
            if (!predicate.test(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a long Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 1L, 2L]
     * assert array.every{ it &lt; 3L }
     * assert !array.every{ it > 1L }
     * </pre>
     *
     * @param self      the long array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(long[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (long item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Returns true if every element of the long array matches the given predicate.
     * A "fat-free" variant of {@link #every(long[], Closure)} accepting a {@link LongPredicate}.
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [2L, 4L, 6L]
     * assert nums.every(n -&gt; n % 2 == 0)
     * </pre>
     *
     * @param self      a long array
     * @param predicate the predicate evaluated against each element
     * @return true if every element satisfies the predicate
     * @since 6.0.0
     */
    public static boolean every(long[] self, LongPredicate predicate) {
        Objects.requireNonNull(self);
        for (long item : self) {
            if (!predicate.test(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a float Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 1.0f, 2.0f]
     * assert array.every{ it &lt; 2.5f }
     * assert !array.every{ it > 1.5f }
     * </pre>
     *
     * @param self      the float array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(float[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (float item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Iterates over the contents of a double Array, and checks whether a
     * predicate is valid for all elements.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 1.0d, 2.0d]
     * assert array.every{ it &lt; 2.5d }
     * assert !array.every{ it > 1.5d }
     * </pre>
     *
     * @param self      the double array over which we iterate
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 5.0.0
     */
    public static boolean every(double[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (double item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Returns true if every element of the double array matches the given predicate.
     * A "fat-free" variant of {@link #every(double[], Closure)} accepting a {@link DoublePredicate}.
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [2.0d, 4.0d, 6.0d]
     * assert nums.every(n -&gt; n % 2 == 0)
     * </pre>
     *
     * @param self      a double array
     * @param predicate the predicate evaluated against each element
     * @return true if every element satisfies the predicate
     * @since 6.0.0
     */
    public static boolean every(double[] self, DoublePredicate predicate) {
        Objects.requireNonNull(self);
        for (double item : self) {
            if (!predicate.test(item)) return false;
        }
        return true;
    }

    /**
     * Used to determine if the given predicate closure is valid (i.e. returns
     * <code>true</code> for all items in this Array).
     *
     * @param self      an array
     * @param predicate the closure predicate used for matching
     * @return true if the predicate returns true for all elements in the array
     * @since 2.5.0
     */
    public static <T> boolean every(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> predicate) {
        Objects.requireNonNull(self);
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(predicate);
        for (T item : self) {
            if (!bcw.call(item)) return false;
        }
        return true;
    }

    /**
     * Returns true if every element of the array matches the given predicate.
     * A "fat-free" variant of {@link #every(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [2, 4, 6]
     * assert nums.every(n -&gt; n % 2 == 0)
     * assert !nums.every(n -&gt; n &gt; 2)
     * </pre>
     *
     * @param self      an array
     * @param predicate the predicate evaluated against each element
     * @return true if every element satisfies the predicate
     * @since 6.0.0
     */
    public static <T> boolean every(T[] self, Predicate<? super T> predicate) {
        Objects.requireNonNull(self);
        for (T item : self) {
            if (!predicate.test(item)) return false;
        }
        return true;
    }

    //--------------------------------------------------------------------------
    // find

    /**
     * Finds the first element in the array that matches the given closure condition.
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * def list = [1,2,3] as Integer[]
     * assert 2 == list.find { it {@code >} 1 }
     * assert null == list.find { it {@code >} 5 }
     * </pre>
     *
     * @param self      an array
     * @param condition a closure condition
     * @return The first element from the array that matches the condition or null if no element matches.
     * @since 2.0
     */
    public static <T> T find(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(condition);
        for (T element : self) {
            if (bcw.call(element)) {
                return element;
            }
        }
        return null;
    }

    /**
     * Finds the first element in the array that matches the given predicate, or null if none match.
     * A "fat-free" variant of {@link #find(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4]
     * assert nums.find(n -&gt; n &gt; 2) == 3
     * assert nums.find(n -&gt; n &gt; 5) == null
     * </pre>
     *
     * @param self      an array
     * @param condition the predicate evaluated against each element
     * @return the first element matching the predicate, in iteration order, or null if none matches
     * @since 6.0.0
     */
    public static <T> T find(T[] self, Predicate<? super T> condition) {
        for (T element : self) {
            if (condition.test(element)) {
                return element;
            }
        }
        return null;
    }

    //--------------------------------------------------------------------------
    // findAll

    /**
     * Finds the elements of the array matching the IDENTITY Closure (i.e.&#160;matching Groovy truth).
     * <pre class="language-groovy groovyTestCase">
     * def items = [1, 2, 0, false, true, '', 'foo', [], [4, 5], null] as Object[]
     * assert items.findAll() == [1, 2, true, 'foo', [4, 5]]
     * </pre>
     *
     * @param self an array
     * @return A list of the truthy values.
     * @see Closure#IDENTITY
     * @since 2.0
     */
    public static <T> List<T> findAll(T[] self) {
        return findAll(self, Closure.IDENTITY);
    }

    /**
     * Finds all elements of the array matching the given Closure condition.
     * <pre class="language-groovy groovyTestCase">
     * def items = [1,2,3,4] as Integer[]
     * assert [2,4] == items.findAll { it % 2 == 0 }
     * </pre>
     *
     * @param self      an array
     * @param condition a closure condition
     * @return A list of the matching values.
     * @since 2.0
     */
    public static <T> List<T> findAll(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        return DefaultGroovyMethods.findMany(new ArrayList<>(), new ArrayIterator<>(self), condition);
    }

    /**
     * Finds all elements of the array matching the given predicate.
     * A "fat-free" variant of {@link #findAll(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4, 5, 6]
     * assert nums.findAll(n -&gt; n % 2 == 0) == [2, 4, 6]
     * </pre>
     *
     * @param self      an array
     * @param condition the predicate evaluated against each element
     * @return a list of the elements matching the predicate
     * @since 6.0.0
     */
    public static <T> List<T> findAll(T[] self, Predicate<? super T> condition) {
        return DefaultGroovyMethods.findMany(new ArrayList<>(), new ArrayIterator<>(self), condition);
    }

    //--------------------------------------------------------------------------
    // findIndexOf

    /**
     * Iterates over the elements of an array and returns the index of the first
     * item that satisfies the condition specified by the closure.
     *
     * @param self      an array
     * @param condition the matching condition
     * @return The index of the first matched object or -1 if no match was found.
     * @since 2.5.0
     */
    public static <T> int findIndexOf(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        return findIndexOf(self, 0, condition);
    }

    /**
     * Iterates over the elements of an array, starting from a specified index,
     * and returns the index of the first item that satisfies the condition
     * specified by the closure.
     *
     * @param self       an array
     * @param startIndex start matching from this index
     * @param condition  the matching condition
     * @return The index of the first matched object or -1 if no match was found.
     * @since 2.5.0
     */
    public static <T> int findIndexOf(T[] self, int startIndex, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        return DefaultGroovyMethods.findIndexOf(new ArrayIterator<>(self), startIndex, condition);
    }

    //--------------------------------------------------------------------------
    // findIndexValues

    /**
     * Iterates over the elements of an array and returns the index values of
     * the items that match the condition specified in the closure.
     *
     * @param self      an array
     * @param condition the matching condition
     * @return a list of numbers corresponding to the index values of all matched objects
     * @since 2.5.0
     */
    public static <T> List<Number> findIndexValues(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        return findIndexValues(self, 0, condition);
    }

    /**
     * Iterates over the elements of an array, starting from a specified index,
     * and returns the index values of the items that match the condition
     * specified in the closure.
     *
     * @param self       an array
     * @param startIndex start matching from this index
     * @param condition  the matching condition
     * @return a list of numbers corresponding to the index values of all matched objects
     * @since 2.5.0
     */
    public static <T> List<Number> findIndexValues(T[] self, Number startIndex, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        return DefaultGroovyMethods.toList(DefaultGroovyMethods.findIndexValues(new ArrayIterator<>(self), startIndex, condition));
    }

    //--------------------------------------------------------------------------
    // findLastIndexOf

    /**
     * Returns the index of the last item that matches the specified condition.
     * <pre class="language-groovy groovyTestCase">
     * def array = new Number[]{1, 2, 1, 2, 1}
     * assert array.findLastIndexOf{it==1} ==  4
     * assert array.findLastIndexOf{it==2} ==  3
     * assert array.findLastIndexOf{it==3} == -1
     * assert array.findLastIndexOf{it&gt;=0} ==  4
     * assert array.findLastIndexOf{it&lt;=0} == -1
     * def empty = new Object[0]
     * assert empty.findLastIndexOf {true} == -1
     * </pre>
     *
     * @param self      an array
     * @param condition the matching condition
     * @return The index of the last matched object or -1 if no match was found.
     * @since 2.5.0
     */
    public static <T> int findLastIndexOf(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        return findLastIndexOf(self, 0, condition);
    }

    /**
     * Returns the index of the last item that matches the specified condition
     * that is at or beyond the given index.
     * <pre class="language-groovy groovyTestCase">
     * def array = new Number[]{3, 1, 2, 1, 2, 1}
     * assert array.findLastIndexOf(1,{it==0}) == -1
     * assert array.findLastIndexOf(1,{it==1}) ==  5
     * assert array.findLastIndexOf(1,{it==2}) ==  4
     * assert array.findLastIndexOf(1,{it==3}) == -1
     * assert array.findLastIndexOf(0,{it==3}) ==  0
     * def empty = new Object[0]
     * assert empty.findLastIndexOf( 2,{true}) == -1
     * assert empty.findLastIndexOf(-2,{true}) == -1
     * </pre>
     *
     * @param self       an array
     * @param lowerBound the minimum index
     * @param condition  the matching condition
     * @return The index of the last matched object or -1 if no match was found.
     * @since 2.5.0
     */
    public static <T> int findLastIndexOf(T[] self, int lowerBound, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(condition);
        if (lowerBound < 0) lowerBound = 0; // ensure it's non-negative
        for (int i = self.length - 1; i >= lowerBound; i -= 1) {
            if (bcw.call(self[i])) {
                return i;
            }
        }
        return -1;
    }

    //--------------------------------------------------------------------------
    // findResult

    /**
     * Iterates through the Array stopping once the first non-null
     * result is found and returning that result. If all results are null, null is returned.
     *
     * @param self an array
     * @return The first non-null result from calling the closure, or null.
     * @since 4.0.9
     */
    public static <T> T findResult(T[] self) {
        return DefaultGroovyMethods.findResult(new ArrayIterator<>(self));
    }

    /**
     * Iterates through the Array stopping once the first non-null
     * result is found and returning that result. If all are null, the defaultResult is returned.
     *
     * @param self          an Array
     * @param defaultResult an Object that should be returned if all elements are null
     * @return the first non-null result from calling the closure, or the defaultValue
     * @since 4.0.9
     */
    public static <T, U extends T, V extends T> T findResult(U[] self, V defaultResult) {
        return DefaultGroovyMethods.findResult(new ArrayIterator<>(self), defaultResult);
    }

    /**
     * Iterates through the Array calling the given closure condition for each item but stopping once the first non-null
     * result is found and returning that result. If all results are null, null is returned.
     *
     * @param self      an array
     * @param condition a closure that returns a non-null value to indicate that processing should stop and the value should be returned
     * @return The first non-null result from calling the closure, or null.
     * @since 2.5.0
     */
    public static <S, T> T findResult(S[] self, @ClosureParams(FirstParam.Component.class) Closure<T> condition) {
        return DefaultGroovyMethods.findResult(new ArrayIterator<>(self), condition);
    }

    /**
     * Iterates through the Array calling the given closure condition for each item but stopping once the first non-null
     * result is found and returning that result. If all are null, the defaultResult is returned.
     *
     * @param self          an array
     * @param defaultResult a value that should be returned if all closure results are null
     * @param condition     a closure that returns a non-null value to indicate that processing should stop and the value should be returned
     * @return The first non-null result from calling the closure, or the defaultValue.
     * @since 2.5.0
     */
    public static <S, T, U extends T, V extends T> T findResult(S[] self, U defaultResult, @ClosureParams(FirstParam.Component.class) Closure<V> condition) {
        return DefaultGroovyMethods.findResult(new ArrayIterator<>(self), defaultResult, condition);
    }

    //--------------------------------------------------------------------------
    // findResults

    /**
     * Iterates through the Array collecting any non-null results.
     *
     * @param self an array
     * @return The list of non-null values.
     * @since 4.0.9
     */
    public static <T> Collection<T> findResults(T[] self) {
        return DefaultGroovyMethods.findResults(new ArrayIterator<>(self));
    }

    /**
     * Iterates through the Array transforming items using the supplied closure
     * and collecting any non-null results.
     *
     * @param self               an array
     * @param filteringTransform a closure that should return either a non-null transformed value or null for items which should be discarded
     * @return The list of non-null transformed values.
     * @since 2.5.0
     */
    public static <T, U> Collection<T> findResults(U[] self, @ClosureParams(FirstParam.Component.class) Closure<T> filteringTransform) {
        return DefaultGroovyMethods.findResults(new ArrayIterator<>(self), filteringTransform);
    }

    //--------------------------------------------------------------------------
    // first

    /**
     * Returns the first item from the boolean array.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false]
     * assert array.first() == true
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static boolean first(boolean[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the byte array.
     * <pre class="language-groovy groovyTestCase">
     * byte[] bytes = [1, 2, 3]
     * assert bytes.first() == 1
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static byte first(byte[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the char array.
     * <pre class="language-groovy groovyTestCase">
     * char[] chars = ['a', 'b', 'c']
     * assert chars.first() == 'a'
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static char first(char[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the short array.
     * <pre class="language-groovy groovyTestCase">
     * short[] shorts = [10, 20, 30]
     * assert shorts.first() == 10
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static short first(short[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the int array.
     * <pre class="language-groovy groovyTestCase">
     * int[] ints = [1, 3, 5]
     * assert ints.first() == 1
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static int first(int[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the long array.
     * <pre class="language-groovy groovyTestCase">
     * long[] longs = [2L, 4L, 6L]
     * assert longs.first() == 2L
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static long first(long[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the float array.
     * <pre class="language-groovy groovyTestCase">
     * float[] floats = [2.0f, 4.0f, 6.0f]
     * assert floats.first() == 2.0f
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static float first(float[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the double array.
     * <pre class="language-groovy groovyTestCase">
     * double[] doubles = [10.0d, 20.0d, 30.0d]
     * assert doubles.first() == 10.0d
     * </pre>
     * An alias for {@code head()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static double first(double[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    /**
     * Returns the first item from the array.
     * <pre class="language-groovy groovyTestCase">
     * def array = [3, 4, 2].toArray()
     * assert array.first() == 3
     * </pre>
     *
     * @param self an array
     * @return the first item from the array
     * @throws NoSuchElementException if the array is empty
     * @since 1.7.3
     */
    public static <T> T first(T[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "first");
        return self[0];
    }

    //--------------------------------------------------------------------------
    // flatten

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true]
     * assert array.flatten() == [false, true]
     * </pre>
     *
     * @param self a boolean Array
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Boolean> flatten(boolean[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1]
     * assert array.flatten() == [0, 1]
     * </pre>
     *
     * @param self a byte Array
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Byte> flatten(byte[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'ab'.chars
     * assert array.flatten() == ['a', 'b']
     * </pre>
     *
     * @param self a char Array
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Character> flatten(char[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1]
     * assert array.flatten() == [0, 1]
     * </pre>
     *
     * @param self a short Array
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Short> flatten(short[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1]
     * assert array.flatten() == [0, 1]
     * </pre>
     *
     * @param self an int Array
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Integer> flatten(int[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 1L]
     * assert array.flatten() == [0L, 1L]
     * </pre>
     *
     * @param self a long Array to flatten
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Long> flatten(long[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 1.0f]
     * assert array.flatten() == [0.0f, 1.0f]
     * </pre>
     *
     * @param self a float Array to flatten
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Float> flatten(float[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array is added to a new collection.
     * It is an alias for {@code toList()} but allows algorithms to be written which also
     * work on multidimensional arrays or non-arrays where flattening would be applicable.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 1.0d]
     * assert array.flatten() == [0.0d, 1.0d]
     * </pre>
     *
     * @param self a double Array to flatten
     * @return a Collection of the array elements
     * @since 1.6.0
     */
    public static List<Double> flatten(double[] self) {
        return toList(self);
    }

    /**
     * Flattens an array. This array and any nested arrays or
     * collections have their contents (recursively) added to the new collection.
     *
     * @param self an Array to flatten
     * @return S flattened Collection
     * @since 1.6.0
     */
    public static List<Object> flatten(Object[] self) {
        return DefaultGroovyMethods.flatten(Arrays.asList(self));
    }

    //

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * boolean[][] array = [[true, false], [true, false]]
     * assert array.flatten() == [true, false, true, false]
     * </pre>
     *
     * @param self a 2D boolean Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Boolean> flatten(boolean[][] self) {
        Objects.requireNonNull(self);
        List<Boolean> result = new ArrayList<>();
        for (boolean[] booleans : self) {
            result.addAll(toList(booleans));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * byte[][] array = [[0, 1], [2, 3]]
     * assert array.flatten() == [0, 1, 2, 3]
     * </pre>
     *
     * @param self a 2D byte Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Byte> flatten(byte[][] self) {
        Objects.requireNonNull(self);
        List<Byte> result = new ArrayList<>();
        for (byte[] bytes : self) {
            result.addAll(toList(bytes));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * char[][] array = ['ab'.chars, 'cd'.chars]
     * assert array.flatten() == ['a', 'b', 'c', 'd']
     * </pre>
     *
     * @param self a 2D char Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Character> flatten(char[][] self) {
        Objects.requireNonNull(self);
        List<Character> result = new ArrayList<>();
        for (char[] chars : self) {
            result.addAll(toList(chars));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * short[][] array = [[0, 1], [2, 3]]
     * assert array.flatten() == [0, 1, 2, 3]
     * </pre>
     *
     * @param self a 2D short Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Short> flatten(short[][] self) {
        Objects.requireNonNull(self);
        List<Short> result = new ArrayList<>();
        for (short[] shorts : self) {
            result.addAll(toList(shorts));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[][] array = [[0, 1], [2, 3]]
     * assert array.flatten() == [0, 1, 2, 3]
     * </pre>
     *
     * @param self a 2D int Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Integer> flatten(int[][] self) {
        Objects.requireNonNull(self);
        List<Integer> result = new ArrayList<>();
        for (int[] ints : self) {
            result.addAll(toList(ints));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[][] array = [[0, 1], [2, 3]]
     * assert array.flatten() == [0, 1, 2, 3]
     * </pre>
     *
     * @param self a 2D long Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Long> flatten(long[][] self) {
        Objects.requireNonNull(self);
        List<Long> result = new ArrayList<>();
        for (long[] longs : self) {
            result.addAll(toList(longs));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[][] array = [[0.0f, 1.0f], [2.0f, 3.0f]]
     * assert array.flatten() == [0.0f, 1.0f, 2.0f, 3.0f]
     * </pre>
     *
     * @param self a 2D float Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Float> flatten(float[][] self) {
        Objects.requireNonNull(self);
        List<Float> result = new ArrayList<>();
        for (float[] floats : self) {
            result.addAll(toList(floats));
        }
        return result;
    }

    /**
     * Flattens a 2D array into a new collection.
     * The items are copied row by row.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[][] array = [[0.0f, 1.0f], [2.0f, 3.0f]]
     * assert array.flatten() == [0.0f, 1.0f, 2.0f, 3.0f]
     * </pre>
     *
     * @param self a 2D double Array
     * @return a Collection of the array elements
     * @since 5.0.0
     */
    public static List<Double> flatten(double[][] self) {
        Objects.requireNonNull(self);
        List<Double> result = new ArrayList<>();
        for (double[] doubles : self) {
            result.addAll(toList(doubles));
        }
        return result;
    }

    //--------------------------------------------------------------------------
    // flattenMany

    /**
     * Flatten an array. This array and any nested arrays, collections or
     * optionals have their contents (recursively) added to a new collection.
     * A transform is applied to any leaf nodes before further flattening.
     *
     * @param self an array
     * @param transform a transform applied to any leaf elements
     * @return a flattened Collection
     * @since 5.0.0
     */
    public static Collection flattenMany(Object[] self, Closure<?> transform) {
        return DefaultGroovyMethods.flattenMany(new ArrayIterable<>(self), transform);
    }

    //--------------------------------------------------------------------------
    // getAt

    /**
     * Supports the subscript operator for a boolean array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, false, true, false, true]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [false, false, false] // NumberRange
     * assert array[(1..5.5).step(2)] == [true, true, true]    // NumberRange
     * </pre>
     *
     * @param array a boolean array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved booleans
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Boolean> getAt(boolean[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a byte array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [1, 3, 5, 7, 9, 11]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [1, 5, 9]   // NumberRange
     * assert array[(1..5.5).step(2)] == [3, 7, 11]  // NumberRange
     * </pre>
     *
     * @param array a byte array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved bytes
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Byte> getAt(byte[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a char array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'abcdef'.chars
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == ['a', 'c', 'e']  // NumberRange
     * assert array[(1..5.5).step(2)] == ['b', 'd', 'f']  // NumberRange
     * </pre>
     *
     * @param array a char array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved chars
     * @since 1.5.0
     */
    @SuppressWarnings("unchecked")
    public static List<Character> getAt(char[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a short array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [1, 3, 5, 7, 9, 11]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [1, 5, 9]   // NumberRange
     * assert array[(1..5.5).step(2)] == [3, 7, 11]  // NumberRange
     * </pre>
     *
     * @param array a short array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved shorts
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Short> getAt(short[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for an int array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [1, 3, 5, 7, 9, 11]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [1, 5, 9]   // NumberRange
     * assert array[(1..5.5).step(2)] == [3, 7, 11]  // NumberRange
     * </pre>
     *
     * @param array an int array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the ints at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Integer> getAt(int[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a long array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [1L, 3L, 5L, 7L, 9L, 11L]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [1L, 5L, 9L]   // NumberRange
     * assert array[(1..5.5).step(2)] == [3L, 7L, 11L]  // NumberRange
     * </pre>
     *
     * @param array a long array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved longs
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Long> getAt(long[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a float array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [1.0f, 3.0f, 5.0f, 7.0f, 9.0f, 11.0f]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [1.0f, 5.0f, 9.0f]   // NumberRange
     * assert array[(1..5.5).step(2)] == [3.0f, 7.0f, 11.0f]  // NumberRange
     * </pre>
     *
     * @param array a float array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved floats
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Float> getAt(float[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a double array with a range giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [1.0d, 3.0d, 5.0d, 7.0d, 9.0d, 11.0d]
     * assert array[2..&lt;2] == [] // EmptyRange
     * assert array[(0..5.5).step(2)] == [1.0d, 5.0d, 9.0d]   // NumberRange
     * assert array[(1..5.5).step(2)] == [3.0d, 7.0d, 11.0d]  // NumberRange
     * </pre>
     *
     * @param array a double array
     * @param range a range indicating the indices for the items to retrieve
     * @return list of the retrieved doubles
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Double> getAt(double[] array, Range<?> range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for an object array with a range giving the desired indices.
     *
     * @param array an Array of Objects
     * @param range a Range
     * @return a range of a list from the range's from index up to but not
     *         including the range's to value
     * @since 1.0
     */
    public static <T> List<T> getAt(T[] array, Range<?> range) {
        return DefaultGroovyMethods.getAt(Arrays.asList(array), range);
    }

    //

    /**
     * Supports the subscript operator for a boolean array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, false, true, true, false]
     * assert array[2..3] == [true, true]
     * assert array[-2..-1] == [true, false]
     * assert array[-1..-2] == [false, true]
     * </pre>
     *
     * @param array a boolean array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved booleans
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Boolean> getAt(boolean[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Boolean> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for a byte array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 10, 20, 30, 40]
     * assert array[2..3] == [20, 30]
     * assert array[-2..-1] == [30, 40]
     * assert array[-1..-2] == [40, 30]
     * </pre>
     *
     * @param array a byte array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved bytes
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Byte> getAt(byte[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Byte> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for a char array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'abcdef'.chars
     * assert array[2..3] == ['c', 'd']
     * assert array[-2..-1] == ['e', 'f']
     * assert array[-1..-2] == ['f', 'e']
     * </pre>
     *
     * @param array a char array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved chars
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Character> getAt(char[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Character> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for a short array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 10, 20, 30, 40]
     * assert array[2..3] == [20, 30]
     * assert array[-2..-1] == [30, 40]
     * assert array[-1..-2] == [40, 30]
     * </pre>
     *
     * @param array a short array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved shorts
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Short> getAt(short[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Short> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for an int array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 10, 20, 30, 40]
     * assert array[2..3] == [20, 30]
     * assert array[-2..-1] == [30, 40]
     * assert array[-1..-2] == [40, 30]
     * </pre>
     *
     * @param array an int array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved ints
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Integer> getAt(int[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Integer> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for a long array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 10L, 20L, 30L, 40L]
     * assert array[2..3] == [20L, 30L]
     * assert array[-2..-1] == [30L, 40L]
     * assert array[-1..-2] == [40L, 30L]
     * </pre>
     *
     * @param array a long array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved longs
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Long> getAt(long[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Long> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for a float array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 10.0f, 20.0f, 30.0f, 40.0f]
     * assert array[2..3] == [20.0f, 30.0f]
     * assert array[-2..-1] == [30.0f, 40.0f]
     * assert array[-1..-2] == [40.0f, 30.0f]
     * </pre>
     *
     * @param array a float array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved floats
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Float> getAt(float[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Float> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for a double array with an IntRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 10.0d, 20.0d, 30.0d, 40.0d]
     * assert array[2..3] == [20.0d, 30.0d]
     * assert array[-2..-1] == [30.0d, 40.0d]
     * assert array[-1..-2] == [40.0d, 30.0d]
     * </pre>
     *
     * @param array a double array
     * @param range an IntRange indicating the indices for the items to retrieve
     * @return list of the retrieved doubles
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Double> getAt(double[] array, IntRange range) {
        RangeInfo info = subListBorders(array.length, range);
        List<Double> answer = primitiveArrayGet(array, subListRange(info, range));
        return info.reverse ? DefaultGroovyMethods.reverse(answer) : answer;
    }

    /**
     * Supports the subscript operator for an object array with an IntRange giving the desired indices.
     *
     * @param array an object array
     * @param range an IntRange
     * @return a range of a list from the range's from index up to but not
     *         including the range's to value
     * @since 1.0
     */
    public static <T> List<T> getAt(T[] array, IntRange range) {
        return DefaultGroovyMethods.getAt(Arrays.asList(array), range);
    }

    //

    /**
     * Supports the subscript operator for a boolean array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, false, true, true, false]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [true, true]
     * </pre>
     *
     * @param array a boolean array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved bytes
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Boolean> getAt(boolean[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a byte array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 10, 20, 30, 40]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [20, 30]
     * </pre>
     *
     * @param array a byte array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved bytes
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Byte> getAt(byte[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a boolean array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'abcdef'.chars
     * def range = new ObjectRange(2, 3)
     * assert array[range] == ['c', 'd']
     * </pre>
     *
     * @param array a char array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved chars
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Character> getAt(char[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a short array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 10, 20, 30, 40]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [20, 30]
     * </pre>
     *
     * @param array a short array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved shorts
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Short> getAt(short[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for an int array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 10, 20, 30, 40]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [20, 30]
     * </pre>
     *
     * @param array an int array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved ints
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Integer> getAt(int[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a long array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 10L, 20L, 30L, 40L]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [20L, 30L]
     * </pre>
     *
     * @param array a long array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved longs
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Long> getAt(long[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a float array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 10.0f, 20.0f, 30.0f, 40.0f]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [20.0f, 30.0f]
     * </pre>
     *
     * @param array a float array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved floats
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Float> getAt(float[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for a double array with an ObjectRange giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 10.0d, 20.0d, 30.0d, 40.0d]
     * def range = new ObjectRange(2, 3)
     * assert array[range] == [20.0d, 30.0d]
     * </pre>
     *
     * @param array a double array
     * @param range an ObjectRange indicating the indices for the items to retrieve
     * @return list of the retrieved doubles
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Double> getAt(double[] array, ObjectRange range) {
        return primitiveArrayGet(array, range);
    }

    /**
     * Supports the subscript operator for an object array with an ObjectRange giving the desired indices.
     *
     * @param array an Array of Objects
     * @param range an ObjectRange
     * @return a range of a list from the range's from index up to but not
     *         including the range's to value
     * @since 1.0
     */
    public static <T> List<T> getAt(T[] array, ObjectRange range) {
        return DefaultGroovyMethods.getAt(Arrays.asList(array), range);
    }

    //

    /**
     * Supports the subscript operator for an object array with an EmptyRange.
     *
     * @param array an Array of Objects
     * @param range an EmptyRange
     * @return an empty Range
     * @since 1.5.0
     */
    public static <T> List<T> getAt(T[] array, EmptyRange<?> range) {
        return new ArrayList<>();
    }

    //

    /**
     * Supports the subscript operator for a boolean array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, false, true, true, false]
     * assert array[2, 3] == [true, true]
     * assert array[0, 0..1, [1, [-1]]] == [false, false, false, false, false]
     * </pre>
     *
     * @param array   a boolean array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the booleans at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Boolean> getAt(boolean[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for a byte array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 2, 4, 6, 8]
     * assert array[2, 3] == [4, 6]
     * assert array[1, 0..1, [0, [-1]]] == [2, 0, 2, 0, 8]
     * </pre>
     *
     * @param array   a byte array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the bytes at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Byte> getAt(byte[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for a char array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'abcde'.chars
     * assert array[2, 3] == ['c', 'd']
     * assert array[1, 0..1, [0, [-1]]] == ['b', 'a', 'b', 'a', 'e']
     * </pre>
     *
     * @param array   a char array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the chars at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Character> getAt(char[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for a short array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 2, 4, 6, 8]
     * assert array[2, 3] == [4, 6]
     * assert array[1, 0..1, [0, [-1]]] == [2, 0, 2, 0, 8]
     * </pre>
     *
     * @param array   a short array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the shorts at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Short> getAt(short[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for an int array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 2, 4, 6, 8]
     * assert array[2, 3] == [4, 6]
     * assert array[1, 0..1, [0, [-1]]] == [2, 0, 2, 0, 8]
     * </pre>
     *
     * @param array   an int array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the ints at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Integer> getAt(int[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for a long array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 2L, 4L, 6L, 8L]
     * assert array[2, 3] == [4L, 6L]
     * assert array[1, 0..1, [0, [-1]]] == [2L, 0L, 2L, 0L, 8L]
     * </pre>
     *
     * @param array   a long array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the longs at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Long> getAt(long[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for a float array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 2.0f, 4.0f, 6.0f, 8.0f]
     * assert array[2, 3] == [4.0f, 6.0f]
     * assert array[1, 0..1, [0, [-1]]] == [2.0f, 0.0f, 2.0f, 0.0f, 8.0f]
     * </pre>
     *
     * @param array   a float array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the floats at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Float> getAt(float[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Supports the subscript operator for a double array
     * with a (potentially nested) collection giving the desired indices.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 2.0d, 4.0d, 6.0d, 8.0d]
     * assert array[2, 3] == [4.0d, 6.0d]
     * assert array[1, 0..1, [0, [-1]]] == [2.0d, 0.0d, 2.0d, 0.0d, 8.0d]
     * </pre>
     *
     * @param array   a double array
     * @param indices a collection of indices for the items to retrieve
     * @return list of the doubles at the given indices
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Double> getAt(double[] array, Collection<?> indices) {
        return primitiveArrayGet(array, indices);
    }

    /**
     * Selects a List of items from an array using a Collection to
     * identify the indices to be selected.
     *
     * @param array   an object array
     * @param indices a collection of indices
     * @return a new list of the values at the given indices
     * @since 1.0
     */
    public static <T> List<T> getAt(T[] array, Collection<?> indices) {
        List<T> answer = new ArrayList<>(indices.size());
        for (Object value : indices) {
            if (value instanceof Range) {
                answer.addAll(getAt(array, (Range<?>) value));
            } else if (value instanceof Collection) {
                answer.addAll(getAt(array, (Collection<?>) value));
            } else {
                int idx = DefaultTypeTransformation.intUnbox(value);
                answer.add(array[normaliseIndex(idx, array.length)]);
            }
        }
        return answer;
    }

    //--------------------------------------------------------------------------
    // getIndices

    /**
     * Returns indices of the boolean array.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(boolean[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the byte array.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(byte[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the char array.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'ab'.chars
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(char[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the short array.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(short[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the int array.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(int[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the long array.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0L, 1L]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(long[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the float array.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0.0f, 1.0f]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(float[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the double array.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0.0d, 1.0d]
     * assert array.indices == 0..1
     * </pre>
     *
     * @see ArrayGroovyMethods#getIndices(Object[])
     * @since 3.0.8
     */
    public static IntRange getIndices(double[] self) {
        Objects.requireNonNull(self);
        return new IntRange(false, 0, self.length);
    }

    /**
     * Returns indices of the array.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['a', 'b', 'c', 'd']
     * {@code assert 0..<4 == letters.indices}
     * </pre>
     *
     * @param self an array
     * @return an index range
     * @since 2.4.0
     */
    public static <T> IntRange getIndices(T[] self) {
        return new IntRange(false, 0, self.length);
    }

    //--------------------------------------------------------------------------
    // grep

    /**
     * Iterates over the array returning each element that matches
     * using the IDENTITY Closure as a filter - effectively returning all elements which satisfy Groovy truth.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * def items = [1, 2, 0, false, true, '', 'foo', [], [4, 5], null] as Object[]
     * assert items.grep() == [1, 2, true, 'foo', [4, 5]]
     * </pre>
     *
     * @param self an array
     * @return a list of elements which satisfy Groovy truth
     * @see Closure#IDENTITY
     * @since 2.0
     */
    public static <T> List<T> grep(T[] self) {
        return grep(self, Closure.IDENTITY);
    }

    /**
     * Iterates over the array of items and returns a collection of items that match
     * the given filter - calling the {@link DefaultGroovyMethods#isCase(Object,Object)}
     * method used by switch statements. This method can be used with different
     * kinds of filters like regular expressions, classes, ranges etc.
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * def items = ['a', 'b', 'aa', 'bc', 3, 4.5] as Object[]
     * assert items.grep( ~/a+/ )  == ['a', 'aa']
     * assert items.grep( ~/../ )  == ['aa', 'bc']
     * assert items.grep( Number ) == [ 3, 4.5 ]
     * assert items.grep{ it.toString().size() == 1 } == [ 'a', 'b', 3 ]
     * </pre>
     *
     * @param self   an array
     * @param filter the filter to perform on each element of the array (using the {@link DefaultGroovyMethods#isCase(java.lang.Object, java.lang.Object)} method)
     * @return a list of objects which match the filter
     * @since 2.0
     */
    public static <T> List<T> grep(T[] self, Object filter) {
        List<T> answer = new ArrayList<>();
        for (T element : self) {
            if (DefaultTypeTransformation.castToBoolean(InvokerHelper.invokeMethod(filter, "isCase", element))) {
                answer.add(element);
            }
        }
        return answer;
    }

    //--------------------------------------------------------------------------
    // groupBy

    /**
     * Sorts all array members into groups determined by the supplied mapping closure.
     * The closure should return the key that this item should be grouped by. The returned
     * LinkedHashMap will have an entry for each distinct key returned from the closure,
     * with each value being a list of items for that group.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * Integer[] items = [1,2,3,4,5,6]
     * assert [0:[2,4,6], 1:[1,3,5]] == items.groupBy { it % 2 }
     * </pre>
     *
     * @param self    an array to group
     * @param closure a closure mapping entries on keys
     * @return A map grouped by keys.
     * @since 2.2.0
     */
    public static <K, T> Map<K, List<T>> groupBy(T[] self, @ClosureParams(FirstParam.Component.class) Closure<K> closure) {
        return DefaultGroovyMethods.groupBy(Arrays.asList(self), closure);
    }

    /**
     * Sorts all array members into groups determined by the supplied mapping function.
     * A "fat-free" variant of {@link #groupBy(Object[], Closure)} accepting a {@link Function}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4, 5, 6]
     * assert [1: [1, 3, 5], 0: [2, 4, 6]] == nums.groupBy(n -&gt; n % 2)
     * </pre>
     *
     * @param self     an array to group
     * @param function a function mapping entries on keys
     * @return a new Map grouped by keys
     * @since 6.0.0
     */
    public static <K, T> Map<K, List<T>> groupBy(T[] self, Function<? super T, ? extends K> function) {
        return DefaultGroovyMethods.groupBy(Arrays.asList(self), function);
    }

    /**
     * Sorts all array members into (sub)groups determined by the supplied
     * mapping closures as per the Iterable variant of this method.
     *
     * @param self     an array to group
     * @param closures an array of closures, each mapping entries on keys
     * @return A map grouped by keys on each criterion.
     * @since 2.2.0
     */
    public static Map groupBy(Object[] self, Object... closures) {
        return DefaultGroovyMethods.groupBy(new ArrayIterable<>(self), closures);
    }

    /**
     * Sorts all array members into (sub)groups determined by the supplied
     * mapping closures as per the list variant of this method.
     *
     * @param self     an array to group
     * @param closures a list of closures, each mapping entries on keys
     * @return A map grouped by keys on each criterion.
     * @since 2.2.0
     */
    public static Map groupBy(Object[] self, List<Closure<?>> closures) {
        return DefaultGroovyMethods.groupBy(new ArrayIterable<>(self), closures);
    }

    //--------------------------------------------------------------------------
    // groupByMany

    /**
     * Groups all array members into (sub)groups determined by the supplied key mapping closure.
     * The closure should return a list of keys applicable to a member.
     * The member will be grouped under each key from the list.
     *
     * Example usage finding the words with capital letters:
     * <pre class="language-groovy groovyTestCase">
     * String[] words = ['TO', 'be', 'Or', 'nOT', 'To', 'be']
     * assert words.groupByMany(w -> w.toSet().grep(~'[A-Z]')) == [T:['TO', 'nOT', 'To'], O:['TO', 'Or', 'nOT']]
     * </pre>
     *
     * If the lists of generated keys are all of size 1, the result will be the same as
     * {@code groupBy} with a closure returning the value in the key list:
     * <pre class="language-groovy groovyTestCase">
     * String[] animals = ['cat', 'dog', 'bird', 'pony']
     * assert animals.groupByMany(a -> [a.size()]) == animals.groupBy(String::size)
     * </pre>
     *
     * @param self  an array to group
     * @param keyFn a closure returning an Iterable of keys for each element
     * @return a new Map from keys to lists of elements
     * @since 6.0.0
     */
    public static <T, K> Map<K, List<T>> groupByMany(
        T[] self,
        Function<? super T, ? extends Iterable<? extends K>> keyFn
    ) {
        return DefaultGroovyMethods.groupByMany(Arrays.asList(self), keyFn);
    }

    /**
     * Groups all members from the array into (sub)groups determined by the supplied key mapping closure.
     * The key mapping closure should return a list of keys applicable to a member.
     * The value returned by mapping the member with the value mapping closure will be grouped under each key from the list.
     *
     * @param self  an array to group
     * @param valueFn a closure which can transform each member before collecting
     * @param keyFn a closure returning an Iterable of keys for each member
     * @return a new Map from keys to lists of elements
     * @since 6.0.0
     */
    public static <T, U, K> Map<K, List<U>> groupByMany(
        T[] self,
        Function<? super T, ? extends U> valueFn,
        Function<? super T, ? extends Iterable<? extends K>> keyFn
    ) {
        return DefaultGroovyMethods.groupByMany(Arrays.asList(self), valueFn, keyFn);
    }

    //--------------------------------------------------------------------------
    // groovyToString

    /**
     * Returns Groovy's list-like string representation for an Object array.
     * This is used by Groovy's formatting infrastructure (e.g., GString interpolation,
     * {@code println}, assert messages). By default, it delegates to
     * {@link FormatHelper#toArrayString(Object[])}.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(Object[])},
     * the JDK's default array {@code toString()} is used instead.
     * Alternatively, you have the option to provide a replacement extension method in an extension module
     * to customize how arrays are displayed throughout Groovy.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(Object[] self) {
        return FormatHelper.toArrayString(self);
    }

    /**
     * Returns Groovy's list-like string representation for a boolean array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(boolean[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(boolean[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    /**
     * Returns Groovy's list-like string representation for a byte array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(byte[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(byte[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    /**
     * Returns Groovy's string representation for a char array.
     * By default, a char array is rendered as a String (e.g. {@code 'abc'.chars}
     * displays as {@code abc}).
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(char[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(char[] self) {
        return new String(self);
    }

    /**
     * Returns Groovy's list-like string representation for a short array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(short[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(short[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    /**
     * Returns Groovy's list-like string representation for an int array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(int[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(int[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    /**
     * Returns Groovy's list-like string representation for a long array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(long[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(long[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    /**
     * Returns Groovy's list-like string representation for a float array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(float[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(float[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    /**
     * Returns Groovy's list-like string representation for a double array.
     * <p>
     * If disabled, e.g. via {@code -Dgroovy.extension.disable=groovyToString(double[])},
     * the JDK's default array {@code toString()} is used instead.
     *
     * @param self the array to format
     * @return the string representation
     * @since 6.0.0
     */
    public static String groovyToString(double[] self) {
        return FormatHelper.toListString(DefaultTypeTransformation.primitiveArrayToList(self));
    }

    //--------------------------------------------------------------------------
    // head

    /**
     * Returns the first item from the boolean array.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false]
     * assert array.head() == true
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static boolean head(boolean[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the byte array.
     * <pre class="language-groovy groovyTestCase">
     * byte[] bytes = [1, 2, 3]
     * assert bytes.head() == 1
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static byte head(byte[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the char array.
     * <pre class="language-groovy groovyTestCase">
     * char[] chars = ['a', 'b', 'c']
     * assert chars.head() == 'a'
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static char head(char[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the short array.
     * <pre class="language-groovy groovyTestCase">
     * short[] shorts = [10, 20, 30]
     * assert shorts.head() == 10
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static short head(short[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the int array.
     * <pre class="language-groovy groovyTestCase">
     * int[] ints = [1, 3, 5]
     * assert ints.head() == 1
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static int head(int[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the long array.
     * <pre class="language-groovy groovyTestCase">
     * long[] longs = [2L, 4L, 6L]
     * assert longs.head() == 2L
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static long head(long[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the float array.
     * <pre class="language-groovy groovyTestCase">
     * float[] floats = [2.0f, 4.0f, 6.0f]
     * assert floats.head() == 2.0f
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static float head(float[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the double array.
     * <pre class="language-groovy groovyTestCase">
     * double[] doubles = [10.0d, 20.0d, 30.0d]
     * assert doubles.head() == 10.0d
     * </pre>
     * An alias for {@code first()}.
     *
     * @param self an array
     * @return the first element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static double head(double[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    /**
     * Returns the first item from the Object array.
     * <pre class="language-groovy groovyTestCase">def array = [3, 4, 2].toArray()
     * assert array.head() == 3</pre>
     *
     * @param self an array
     * @return the first item from the Object array
     * @throws NoSuchElementException if the array is empty
     * @since 1.7.3
     */
    public static <T> T head(T[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "head");
        return self[0];
    }

    //--------------------------------------------------------------------------
    // indexOf

    /**
     * Returns the index of the first occurrence of the specified element in the
     * array. That is, the lowest index {@code i} such that
     * {@code Objects.equals(array[i], object)} or -1 if there is no such index.
     *
     * <pre class="language-groovy groovyTestCase">
     * String[] array = ['foo','bar','foo']
     * assert array.indexOf('foo') ==  0
     * assert array.indexOf('bar') ==  1
     * assert array.indexOf('baz') == -1
     * assert array.indexOf(12345) == -1
     * </pre>
     *
     * @since 5.0.0
     */
    public static int indexOf(Object[] self, Object object) {
        for (int i = 0; i < self.length; i += 1) {
            if (Objects.equals(self[i], object)) {
                return i;
            }
        }
        return -1;
    }

    //--------------------------------------------------------------------------
    // indexed

    /**
     * Zips an int[] with indices in (index, value) order starting from index 0.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, 20, 30]
     * assert [0: 10, 1: 20, 2: 30] == nums.indexed()
     * </pre>
     *
     * @see #indexed(int[], int)
     * @since 3.0.8
     */
    public static Map<Integer, Integer> indexed(int[] self) {
        return indexed(self, 0);
    }

    /**
     * Zips a long[] with indices in (index, value) order starting from index 0.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, 20L, 30L]
     * assert [0: 10L, 1: 20L, 2: 30L] == nums.indexed()
     * </pre>
     *
     * @see #indexed(long[], int)
     * @since 3.0.8
     */
    public static Map<Integer, Long> indexed(long[] self) {
        return indexed(self, 0);
    }

    /**
     * Zips a float[] with indices in (index, value) order starting from index 0.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [10.0f, 20.0f, 30.0f]
     * assert [0: 10.0f, 1: 20.0f, 2: 30.0f] == nums.indexed()
     * </pre>
     *
     * @see #indexed(float[], int)
     * @since 5.0.0
     */
    public static Map<Integer, Float> indexed(float[] self) {
        return indexed(self, 0);
    }

    /**
     * Zips a double[] with indices in (index, value) order starting from index 0.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10.0d, 20.0d, 30.0d]
     * assert [0: 10.0d, 1: 20.0d, 2: 30.0d] == nums.indexed()
     * </pre>
     *
     * @see #indexed(double[], int)
     * @since 3.0.8
     */
    public static Map<Integer, Double> indexed(double[] self) {
        return indexed(self, 0);
    }

    /**
     * Zips an int[] with indices in (index, value) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, 20, 30]
     * assert [5: 10, 6: 20, 7: 30] == nums.indexed(5)
     * assert ["1: 10", "2: 20", "3: 30"] == nums.indexed(1).collect { idx, str {@code ->} "$idx: $str" }
     * </pre>
     *
     * @param self   an int array
     * @param offset an index to start from
     * @return a Map (since the keys/indices are unique) containing the elements from the iterable zipped with indices
     * @see DefaultGroovyMethods#indexed(Iterable, int)
     * @since 3.0.8
     */
    public static Map<Integer, Integer> indexed(int[] self, int offset) {
        return DefaultGroovyMethods.indexed(new IntArrayIterable(self), offset);
    }

    /**
     * Zips a long[] with indices in (index, value) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, 20L, 30L]
     * assert [5: 10L, 6: 20L, 7: 30L] == nums.indexed(5)
     * </pre>
     *
     * @param self   a long array
     * @param offset an index to start from
     * @return a Map (since the keys/indices are unique) containing the elements from the iterable zipped with indices
     * @see DefaultGroovyMethods#indexed(Iterable, int)
     * @since 3.0.8
     */
    public static Map<Integer, Long> indexed(long[] self, int offset) {
        return DefaultGroovyMethods.indexed(new LongArrayIterable(self), offset);
    }

    /**
     * Zips a float[] with indices in (index, value) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [10.0f, 20.0f, 30.0f]
     * assert [5: 10.0f, 6: 20.0f, 7: 30.0f] == nums.indexed(5)
     * </pre>
     *
     * @param self   a float[]
     * @param offset an index to start from
     * @return a Map (since the keys/indices are unique) containing the elements from the iterable zipped with indices
     * @see DefaultGroovyMethods#indexed(Iterable, int)
     * @since 5.0.0
     */
    public static Map<Integer, Float> indexed(float[] self, int offset) {
        return DefaultGroovyMethods.indexed(new FloatArrayIterable(self), offset);
    }

    /**
     * Zips a double[] with indices in (index, value) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10.0d, 20.0d, 30.0d]
     * assert [5: 10.0d, 6: 20.0d, 7: 30.0d] == nums.indexed(5)
     * </pre>
     *
     * @param self   a double[]
     * @param offset an index to start from
     * @return a Map (since the keys/indices are unique) containing the elements from the iterable zipped with indices
     * @see DefaultGroovyMethods#indexed(Iterable, int)
     * @since 3.0.8
     */
    public static Map<Integer, Double> indexed(double[] self, int offset) {
        return DefaultGroovyMethods.indexed(new DoubleArrayIterable(self), offset);
    }

    /**
     * Zips an object array with indices in (index, value) order starting from index 0.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = 'A'..'C'
     * assert [0: 'A', 1: 'B', 2: 'C'] == letters.indexed()
     * </pre>
     *
     * @see #indexed(Object[], int)
     * @since 5.0.0
     */
    public static <T> Map<Integer, T> indexed(T[] self) {
        return indexed(self, 0);
    }

    /**
     * Zips an object array with indices in (index, value) order starting from a given index.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = 'A'..'C'
     * assert [5: 'A', 6: 'B', 7: 'C'] == letters.indexed(5)
     * assert ["1: A", "2: B", "3: C"] == letters.indexed(1).collect { idx, str {@code ->} "$idx: $str" }
     * </pre>
     *
     * @param self   an Object array
     * @param offset an index to start from
     * @return a Map (since the keys/indices are unique) containing the elements from the iterable zipped with indices
     * @see DefaultGroovyMethods#indexed(Iterable, int)
     * @since 5.0.0
     */
    public static <T> Map<Integer, T> indexed(T[] self, int offset) {
        return DefaultGroovyMethods.indexed(new ArrayIterable<>(self), offset);
    }

    //--------------------------------------------------------------------------
    // init

    /**
     * Returns the items from the boolean array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false, true]
     * def result = array.init()
     * assert result == [true, false]
     * assert array.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static boolean[] init(boolean[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the byte array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * byte[] bytes = [1, 2, 3]
     * def result = bytes.init()
     * assert result == [1, 2]
     * assert bytes.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static byte[] init(byte[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the char array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * char[] chars = ['a', 'b', 'c']
     * def result = chars.init()
     * assert result == ['a', 'b']
     * assert chars.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static char[] init(char[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the short array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * short[] shorts = [10, 20, 30]
     * def result = shorts.init()
     * assert result == [10, 20]
     * assert shorts.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static short[] init(short[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the int array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * int[] ints = [1, 3, 5]
     * def result = ints.init()
     * assert result == [1, 3]
     * assert ints.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static int[] init(int[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the long array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * long[] longs = [2L, 4L, 6L]
     * def result = longs.init()
     * assert result == [2L, 4L]
     * assert longs.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static long[] init(long[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the float array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * float[] floats = [2.0f, 4.0f, 6.0f]
     * def result = floats.init()
     * assert result == [2.0f, 4.0f]
     * assert floats.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static float[] init(float[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the double array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     * double[] doubles = [10.0d, 20.0d, 30.0d]
     * def result = doubles.init()
     * assert result == [10.0d, 20.0d]
     * assert doubles.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static double[] init(double[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    /**
     * Returns the items from the Object array excluding the last item.
     * <pre class="language-groovy groovyTestCase">
     *     String[] strings = ["a", "b", "c"]
     *     def result = strings.init()
     *     assert result.length == 2
     *     assert strings.class.componentType == String
     * </pre>
     *
     * @param self an array
     * @return an array without its last element
     * @throws UnsupportedOperationException if the array is empty
     * @since 2.4.0
     */
    public static <T> T[] init(T[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "init");
        return Arrays.copyOfRange(self, 0, self.length - 1);
    }

    //--------------------------------------------------------------------------
    // inject

    /**
     * Iterates through the given array, passing the first two elements to the
     * closure. The result is passed back (injected) to the closure along with
     * the third element and so on until all array elements have been consumed.
     *
     * <pre class="language-groovy groovyTestCase">
     * def array = new Number[] {1, 2, 3, 4}
     * def value = array.inject { acc, val -> acc * val }
     * assert value == 24
     *
     * array = new Object[] {['a','b'], ['b','c'], ['d','b']}
     * value = array.inject { acc, val -> acc.intersect(val) }
     * assert value == ['b']
     *
     * array = new String[] {'t', 'i', 'm'}
     * value = array.inject { acc, val -> acc + val }
     * assert value == 'tim'
     * </pre>
     *
     * @param self    an array
     * @param closure a closure
     * @return first value for single-element array or the result of the last closure call
     * @throws NoSuchElementException if the array is empty
     * @see #inject(Object[], Object, Closure)
     * @since 1.8.7
     */
    public static <E extends T, T, V extends T> T inject(E[] self, @ClosureParams(value=FromString.class,options="T,E") Closure<V> closure) {
        if (self.length == 0) {
            throw new NoSuchElementException("Cannot call inject() on an empty array without passing an initial value.");
        }
        T value = self[0];
        Object[] params = new Object[2];
        for (int i = 1; i < self.length; i += 1) {
            params[0] = value;
            params[1] = self[i];
            value = closure.call(params);
        }
        return value;
    }

    /**
     * Iterates through the given array, passing the first two elements to the
     * operator. The result is passed back (injected) to the operator along with
     * the third element and so on until all array elements have been consumed.
     * A "fat-free" variant of {@link #inject(Object[], Closure)} accepting a {@link BinaryOperator}.
     *
     * <pre class="language-groovy groovyTestCase">
     * import java.util.function.BinaryOperator
     * Number[] array = [1, 2, 3, 4]
     * BinaryOperator&lt;Number&gt; mult = (acc, val) -&gt; acc * val
     * assert array.inject(mult) == 24
     * </pre>
     *
     * @param self     an array
     * @param operator a binary operator combining the running result with each element
     * @return first value for single-element array or the result of the last operator call
     * @throws NoSuchElementException if the array is empty
     * @since 6.0.0
     */
    public static <T> T inject(T[] self, BinaryOperator<T> operator) {
        if (self.length == 0) {
            throw new NoSuchElementException("Cannot call inject() on an empty array without passing an initial value.");
        }
        T value = self[0];
        for (int i = 1; i < self.length; i += 1) {
            value = operator.apply(value, self[i]);
        }
        return value;
    }

    /**
     * Iterates through the given array, passing in the initial value and the
     * first element to the closure. The result is sent back (injected) with the
     * second element. The new result is injected back into the closure with the
     * third element and so on until all elements have been consumed.
     *
     * <pre class="language-groovy groovyTestCase">
     * def array = new Number[] {2, 3, 4}
     * def value = array.inject(1) { acc, val -> acc * val }
     * assert value == 24
     *
     * array = new Object[] {['a','b'], ['b','c'], ['d','b']}
     * value = array.inject(['a','b','c']) { acc, val -> acc.intersect(val) }
     * assert value == ['b']
     *
     * array = new String[] {'t', 'i', 'm'}
     * value = array.inject("") { acc, val -> acc + val }
     * assert value == 'tim'
     * </pre>
     *
     * @param self         an array
     * @param initialValue base value
     * @param closure      a closure
     * @return base value for empty array or the result of the last closure call
     * @since 1.5.0
     */
    public static <E, T, U extends T, V extends T> T inject(E[] self, U initialValue, @ClosureParams(value=FromString.class,options="T,E") Closure<V> closure) {
        T value = initialValue;
        Object[] params = new Object[2];
        for (E e : self) {
            params[0] = value;
            params[1] = e;
            value = closure.call(params);
        }
        return value;
    }

    /**
     * Iterates through the given array, passing in the initial value and the first
     * element to the function. The result is sent back (injected) with the second
     * element and so on until all elements have been consumed.
     * A "fat-free" variant of {@link #inject(Object[], Object, Closure)} accepting a {@link BiFunction}.
     *
     * <pre class="language-groovy groovyTestCase">
     * import java.util.function.BiFunction
     * Number[] array = [2, 3, 4]
     * BiFunction&lt;Number, Number, Number&gt; mult = (acc, val) -&gt; acc * val
     * assert array.inject(1, mult) == 24
     * </pre>
     *
     * @param self         an array
     * @param initialValue base value
     * @param function     a function combining the running result with each element
     * @return base value for empty array or the result of the last function call
     * @since 6.0.0
     */
    public static <E, U> U inject(E[] self, U initialValue, BiFunction<? super U, ? super E, ? extends U> function) {
        U value = initialValue;
        for (E e : self) {
            value = function.apply(value, e);
        }
        return value;
    }

    //--------------------------------------------------------------------------
    // injectAll

    /**
     * Iterates through the given array, injecting values as per <tt>inject</tt>
     * but returns the list of all calculated values instead of just the final result.
     *
     * @since 5.0.0
     */
    public static <E extends T, T, V extends T> List<T> injectAll(E[] self, @ClosureParams(value=FromString.class,options="T,E") Closure<V> closure) {
        if (self.length == 0) {
            throw new NoSuchElementException("Cannot call inject() on an empty array without passing an initial value.");
        }
        List<T> result = new ArrayList<>();
        T value = self[0];
        Object[] params = new Object[2];
        for (int i = 1; i < self.length; i += 1) {
            params[0] = value;
            params[1] = self[i];
            value = closure.call(params);
            result.add(value);
        }
        return result;
    }

    /**
     * Iterates through the given array, injecting values as per <tt>inject</tt>
     * but returns the list of all calculated values instead of just the final result.
     * A "fat-free" variant of {@link #injectAll(Object[], Closure)} accepting a {@link BinaryOperator}.
     * <pre class="language-groovy groovyTestCase">
     * import java.util.function.BinaryOperator
     * Integer[] nums = 1..5
     * BinaryOperator&lt;Integer&gt; add = (a, b) -&gt; a + b
     * assert nums.injectAll(add) == [3, 6, 10, 15]
     * </pre>
     *
     * @param self     an array
     * @param operator a binary operator combining the running result with each element
     * @return the list of all calculated values
     * @throws NoSuchElementException if the array is empty
     * @since 6.0.0
     */
    public static <T> List<T> injectAll(T[] self, BinaryOperator<T> operator) {
        if (self.length == 0) {
            throw new NoSuchElementException("Cannot call injectAll() on an empty array without passing an initial value.");
        }
        List<T> result = new ArrayList<>();
        T value = self[0];
        for (int i = 1; i < self.length; i += 1) {
            value = operator.apply(value, self[i]);
            result.add(value);
        }
        return result;
    }

    /**
     * Iterates through the given array, injecting values as per <tt>inject</tt>
     * but returns the list of all calculated values instead of just the final result.
     *
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = 1..5
     * var prefixSum = nums.injectAll(0, Integer::sum)
     * Arrays.parallelPrefix(nums, Integer::sum) // built-in JDK mutating method
     * assert nums == prefixSum
     * </pre>
     *
     * @since 5.0.0
     */
    public static <E, T, U extends T, V extends T> List<T> injectAll(E[] self, U initialValue, @ClosureParams(value=FromString.class,options="T,E") Closure<V> closure) {
        List<T> result = new ArrayList<>();
        T value = initialValue;
        Object[] params = new Object[2];
        for (E e : self) {
            params[0] = value;
            params[1] = e;
            value = closure.call(params);
            result.add(value);
        }
        return result;
    }

    /**
     * Iterates through the given array, injecting values as per <tt>inject</tt>
     * but returns the list of all calculated values instead of just the final result.
     * A "fat-free" variant of {@link #injectAll(Object[], Object, Closure)} accepting a {@link BiFunction}.
     * <pre class="language-groovy groovyTestCase">
     * import java.util.function.BiFunction
     * Integer[] nums = [1, 2, 3]
     * BiFunction&lt;Integer, Integer, Integer&gt; add = (a, b) -&gt; a + b
     * assert nums.injectAll(0, add) == [1, 3, 6]
     * </pre>
     *
     * @param self         an array
     * @param initialValue base value
     * @param function     a function combining the running result with each element
     * @return the list of all calculated values
     * @since 6.0.0
     */
    public static <E, U> List<U> injectAll(E[] self, U initialValue, BiFunction<? super U, ? super E, ? extends U> function) {
        List<U> result = new ArrayList<>();
        U value = initialValue;
        for (E e : self) {
            value = function.apply(value, e);
            result.add(value);
        }
        return result;
    }

    //--------------------------------------------------------------------------
    // isSorted

    /**
     * Determines if the array is sorted in natural (ascending) order.
     * This is efficient — it checks adjacent pairs in a single pass and
     * short-circuits on the first out-of-order pair.
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [1, 2, 3]
     * assert nums.isSorted()
     * int[] unsorted = [3, 1, 2]
     * assert !unsorted.isSorted()
     * </pre>
     *
     * @param self the int array to check
     * @return true if the array elements are sorted in non-descending order
     * @since 6.0.0
     */
    public static boolean isSorted(int[] self) {
        for (int i = 1; i < self.length; i++) {
            if (self[i - 1] > self[i]) return false;
        }
        return true;
    }

    /**
     * Determines if the array is sorted in natural (ascending) order.
     * This is efficient — it checks adjacent pairs in a single pass and
     * short-circuits on the first out-of-order pair.
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [1L, 2L, 3L]
     * assert nums.isSorted()
     * long[] unsorted = [3L, 1L, 2L]
     * assert !unsorted.isSorted()
     * </pre>
     *
     * @param self the long array to check
     * @return true if the array elements are sorted in non-descending order
     * @since 6.0.0
     */
    public static boolean isSorted(long[] self) {
        for (int i = 1; i < self.length; i++) {
            if (self[i - 1] > self[i]) return false;
        }
        return true;
    }

    /**
     * Determines if the array is sorted in natural order using a {@link NumberAwareComparator}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3]
     * assert nums.isSorted()
     * Integer[] unsorted = [3, 1, 2]
     * assert !unsorted.isSorted()
     * </pre>
     *
     * @param self the array to check
     * @return true if the array elements are sorted in non-descending order
     * @see #isSorted(Object[], Comparator)
     * @since 6.0.0
     */
    public static <T> boolean isSorted(T[] self) {
        return isSorted(self, new NumberAwareComparator<>());
    }

    /**
     * Determines if the array is sorted according to the given Comparator.
     * This is efficient — it checks adjacent pairs in a single pass and
     * short-circuits on the first out-of-order pair.
     * <pre class="language-groovy groovyTestCase">
     * String[] words = ["hello","Hey","hi"]
     * assert words.isSorted(String.CASE_INSENSITIVE_ORDER)
     * </pre>
     *
     * @param self       the array to check
     * @param comparator a Comparator used for the comparison
     * @return true if the array elements are sorted according to the comparator
     * @since 6.0.0
     */
    public static <T> boolean isSorted(T[] self, Comparator<? super T> comparator) {
        for (int i = 1; i < self.length; i++) {
            if (comparator.compare(self[i - 1], self[i]) > 0) return false;
        }
        return true;
    }

    /**
     * Determines if the array is sorted in non-descending order of the keys
     * returned by the given key extractor. Keys are compared number-aware.
     * For a custom ordering use {@link #isSorted(Object[], Comparator)} (a
     * two-arg closure coerces to a Comparator).
     *
     * @param self         the array to check
     * @param keyExtractor extracts the sort key from each element
     * @return true if the array elements are sorted by key in non-descending order
     * @see #isSorted(Object[], Comparator)
     * @since 6.0.0
     */
    public static <T> boolean isSorted(T[] self, Function<? super T, ?> keyExtractor) {
        Comparator<Object> byKey = new NumberAwareComparator<>();
        Comparator<T> comparator = (a, b) -> byKey.compare(keyExtractor.apply(a), keyExtractor.apply(b));
        return isSorted(self, comparator);
    }

    //--------------------------------------------------------------------------
    // iterator

    /**
     * Returns an Iterator which traverses the given array in index order.
     *
     * @param self an array
     * @return an Iterator backed by the given Array.
     * @see ArrayIterator
     * @since 1.6.4
     */
    public static <T> Iterator<T> iterator(final T[] self) {
        return new ArrayIterator<>(self);
    }

    //--------------------------------------------------------------------------
    // join

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of boolean
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(boolean[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of byte
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(byte[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of char
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(char[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of short
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(short[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of int
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(int[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of long
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(long[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of float
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(float[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * @param self an array of double
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(double[] self) {
        return join(self, null);
    }

    /**
     * Concatenates the string representation of each item in this array.
     *
     * <pre class="language-groovy groovyTestCase">
     * def array = new Number[]{1,2L,3G}
     * assert array.join() == "123"
     * </pre>
     *
     * @param self an array of Object
     * @return the joined String
     * @since 5.0.0
     */
    public static String join(Object[] self) {
        return join(self, null);
    }

    //

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of boolean
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(boolean[] self, String separator) {
        return DefaultGroovyMethods.join(new BooleanArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of byte
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(byte[] self, String separator) {
        return DefaultGroovyMethods.join(new ByteArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of char
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(char[] self, String separator) {
        return DefaultGroovyMethods.join(new CharArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of short
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(short[] self, String separator) {
        return DefaultGroovyMethods.join(new ShortArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of int
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(int[] self, String separator) {
        return DefaultGroovyMethods.join(new IntArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of long
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(long[] self, String separator) {
        return DefaultGroovyMethods.join(new LongArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of float
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(float[] self, String separator) {
        return DefaultGroovyMethods.join(new FloatArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * @param self      an array of double
     * @param separator a String separator
     * @return the joined String
     * @since 2.4.1
     */
    public static String join(double[] self, String separator) {
        return DefaultGroovyMethods.join(new DoubleArrayIterator(self), separator);
    }

    /**
     * Concatenates the string representation of each item in this array,
     * with the given String as a separator between each item.
     *
     * <pre class="language-groovy groovyTestCase">
     * Serializable[] array = [1,2L,-3G]
     * assert array.join("+") == "1+2+-3"
     * </pre>
     *
     * @param self      an array of Object
     * @param separator a String separator
     * @return the joined String
     * @since 1.0
     */
    public static String join(Object[] self, String separator) {
        return DefaultGroovyMethods.join(new ArrayIterator<>(self), separator);
    }

    //--------------------------------------------------------------------------
    // last

    /**
     * Returns the last item from the boolean array.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false, true]
     * assert array.last() == true
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static boolean last(boolean[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the byte array.
     * <pre class="language-groovy groovyTestCase">
     * byte[] bytes = [1, 2, 3]
     * assert bytes.last() == 3
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static byte last(byte[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the char array.
     * <pre class="language-groovy groovyTestCase">
     * char[] chars = ['a', 'b', 'c']
     * assert chars.last() == 'c'
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static char last(char[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the short array.
     * <pre class="language-groovy groovyTestCase">
     * short[] shorts = [10, 20, 30]
     * assert shorts.last() == 30
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static short last(short[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the int array.
     * <pre class="language-groovy groovyTestCase">
     * int[] ints = [1, 3, 5]
     * assert ints.last() == 5
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static int last(int[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the long array.
     * <pre class="language-groovy groovyTestCase">
     * long[] longs = [2L, 4L, 6L]
     * assert longs.last() == 6L
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static long last(long[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the float array.
     * <pre class="language-groovy groovyTestCase">
     * float[] floats = [2.0f, 4.0f, 6.0f]
     * assert floats.last() == 6.0f
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static float last(float[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the double array.
     * <pre class="language-groovy groovyTestCase">
     * double[] doubles = [10.0d, 20.0d, 30.0d]
     * assert doubles.last() == 30.0d
     * </pre>
     *
     * @param self an array
     * @return the last element
     * @throws NoSuchElementException if the array is empty
     * @since 5.0.0
     */
    public static double last(double[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "last");
        return self[self.length - 1];
    }

    /**
     * Returns the last item from the array.
     * <pre class="language-groovy groovyTestCase">
     * def array = [3, 4, 2].toArray()
     * assert array.last() == 2
     * </pre>
     *
     * @param self an array
     * @return the last item from the array
     * @throws NoSuchElementException if you try to access last() for an empty array
     * @since 1.7.3
     */
    public static <T> T last(T[] self) {
        if (self.length == 0) {
            throw new NoSuchElementException("Cannot access last() element from an empty array");
        }
        return self[self.length - 1];
    }

    //--------------------------------------------------------------------------
    // lastIndexOf

    /**
     * Returns the index of the last occurrence of the specified element in the
     * array. That is, the highest index {@code i} such that
     * {@code Objects.equals(array[i], object)} or -1 if there is no such index.
     *
     * <pre class="language-groovy groovyTestCase">
     * String[] array = ['foo','bar','foo']
     * assert array.lastIndexOf('foo') ==  2
     * assert array.lastIndexOf('bar') ==  1
     * assert array.lastIndexOf('baz') == -1
     * assert array.lastIndexOf(12345) == -1
     * </pre>
     *
     * @since 5.0.0
     */
    public static int lastIndexOf(Object[] self, Object object) {
        for (int i = self.length - 1; i >= 0; i -= 1) {
            if (Objects.equals(self[i], object)) {
                return i;
            }
        }
        return -1;
    }

    //--------------------------------------------------------------------------
    // max

    /**
     * Adds max() method to int arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [1, 3, 2]
     * assert 3 == nums.max()
     * </pre>
     *
     * @param self an int array
     * @return the maximum value
     * @since 3.0.8
     */
    public static int max(int[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");
        int answer = self[0];
        for (int i = 1; i < self.length; i++) {
            int value = self[i];
            if (value > answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds max() method to long arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [1L, 3L, 2L]
     * assert 3L == nums.max()
     * </pre>
     *
     * @param self a long array
     * @return the maximum value
     * @since 3.0.8
     */
    public static long max(long[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");
        long answer = self[0];
        for (int i = 1; i < self.length; i++) {
            long value = self[i];
            if (value > answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds max() method to float arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [1.1f, 3.3f, 2.2f]
     * assert 3.3f == nums.max()
     * </pre>
     *
     * @param self a float array
     * @return the maximum value
     * @since 5.0.0
     */
    public static float max(float[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");
        float answer = self[0];
        for (int i = 1; i < self.length; i++) {
            float value = self[i];
            if (value > answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds max() method to double arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [1.1d, 3.3d, 2.2d]
     * assert 3.3d == nums.max()
     * </pre>
     *
     * @param self a double array
     * @return the maximum value
     * @since 3.0.8
     */
    public static double max(double[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");
        double answer = self[0];
        for (int i = 1; i < self.length; i++) {
            double value = self[i];
            if (value > answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds max() method to Object arrays.
     *
     * @param self an array
     * @return the maximum value
     * @see DefaultGroovyMethods#max(Iterator)
     * @since 1.5.5
     */
    public static <T> T max(T[] self) {
        return DefaultGroovyMethods.max(new ArrayIterator<>(self));
    }

    //

    /**
     * Selects the maximum value found from the int array
     * using the supplied IntComparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, 20, -30]
     * assert 20 == nums.max{ n, m {@code ->} n {@code <=>} m }
     * assert -30 == nums.max{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self     an int array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static int max(int[] self, IntComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        int maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            int v = self[i];
            if (comparator.compare(v, maxV) > 0) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the int array
     * using the supplied IntUnaryOperator to determine the maximum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, 20, -30]
     * assert 20 == nums.max{ it }
     * assert -30 == nums.max{ it.abs() }
     * </pre>
     * <p>
     *
     * @param self     an int array
     * @param operator an operator that returns an int used for comparing values
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static int max(int[] self, IntUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        int maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            int v = self[i];
            if (operator.applyAsInt(v) > operator.applyAsInt(maxV)) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the long array
     * using the supplied LongBinaryOperator as a comparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, 20L, -30L]
     * assert 20L == nums.max{ n, m {@code ->} n {@code <=>} m }
     * assert -30L == nums.max{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self     a long array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static long max(long[] self, LongComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        long maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            long v = self[i];
            if (comparator.compare(v, maxV) > 0) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the long array
     * using the supplied LongUnaryOperator to determine the maximum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, 20L, -30L]
     * assert 20L == nums.max{ it }
     * assert -30L == nums.max{ it.abs() }
     * </pre>
     * <p>
     *
     * @param self     a long array
     * @param operator an operator that returns a long used for comparing values
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static long max(long[] self, LongUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        long maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            long v = self[i];
            if (operator.applyAsLong(v) > operator.applyAsLong(maxV)) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the float array
     * using the supplied FloatComparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10f, 20f, -30f]
     * assert 20f == nums.max{ n, m {@code ->} n {@code <=>} m }
     * assert -30f == nums.max{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self       a float array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static float max(float[] self, FloatComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        float maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            float v = self[i];
            if (comparator.compare(v, maxV) > 0) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the float array
     * using the supplied FloatUnaryOperator to determine the maximum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [10f, 20f, -30f]
     * assert -30f == nums.max{ it.abs() }
     * assert 20f == nums.max{ it }
     * </pre>
     * <p>
     *
     * @param self     a float array
     * @param operator an operator that returns a float used for comparing values
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static float max(float[] self, FloatUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        float maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            float v = self[i];
            if (operator.applyAsFloat(v) > operator.applyAsFloat(maxV)) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the double array
     * using the supplied DoubleComparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10d, 20d, -30d]
     * assert 20d == nums.max{ n, m {@code ->} n {@code <=>} m }
     * assert -30d == nums.max{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self       a double array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static double max(double[] self, DoubleComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        double maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            double v = self[i];
            if (comparator.compare(v, maxV) > 0) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the double array
     * using the supplied DoubleUnaryOperator to determine the maximum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10d, 20d, -30d]
     * assert -30d == nums.max{ it.abs() }
     * assert 20d == nums.max{ it }
     * </pre>
     * <p>
     *
     * @param self     a double array
     * @param operator an operator that returns a double used for comparing values
     * @return the maximum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static double max(double[] self, DoubleUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "max");

        double maxV = self[0];
        for (int i = 1; i < self.length; i++) {
            double v = self[i];
            if (operator.applyAsDouble(v) > operator.applyAsDouble(maxV)) {
                maxV = v;
            }
        }
        return maxV;
    }

    /**
     * Selects the maximum value found from the Object array using the given comparator.
     *
     * @param self       an array
     * @param comparator a Comparator
     * @return the maximum value
     * @see DefaultGroovyMethods#max(Iterator, Comparator)
     * @since 1.5.5
     */
    public static <T> T max(T[] self, Comparator<? super T> comparator) {
        return DefaultGroovyMethods.max(new ArrayIterator<>(self), comparator);
    }

    /**
     * Selects the maximum value found from the Object array
     * using the closure to determine the correct ordering.
     * <p>
     * If the closure has two parameters
     * it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer,
     * zero, or a positive integer when the first parameter is less than,
     * equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a
     * Comparable (typically an Integer) which is then used for
     * further comparison.
     *
     * @param self    an array
     * @param closure a Closure used to determine the correct ordering
     * @return the maximum value
     * @since 1.5.5
     */
    public static <T> T max(T[] self, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        return DefaultGroovyMethods.max(new ArrayIterator<>(self), closure);
    }

    //

    /**
     * Selects the maximum value found from the int array
     * using the comparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, 20, 30]
     * assert 30 == nums.maxComparing(Comparator.naturalOrder())
     * assert 10 == nums.maxComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       an int array
     * @param comparator a Comparator
     * @return the maximum value
     * @see DefaultGroovyMethods#max(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static int maxComparing(int[] self, Comparator<Integer> comparator) {
        return DefaultGroovyMethods.max(new IntArrayIterator(self), comparator);
    }

    /**
     * Selects the maximum value found from the long array
     * using the comparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, 20L, 30L]
     * assert 30L == nums.maxComparing(Comparator.naturalOrder())
     * assert 10L == nums.maxComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       a long array
     * @param comparator a Comparator
     * @return the maximum value
     * @see DefaultGroovyMethods#max(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static long maxComparing(long[] self, Comparator<Long> comparator) {
        return DefaultGroovyMethods.max(new LongArrayIterator(self), comparator);
    }

    /**
     * Selects the maximum value found from the float array
     * using the comparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10.0f, 20.0f, 30.0f]
     * assert 30f == nums.maxComparing(Comparator.naturalOrder())
     * assert 10f == nums.maxComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       a float array
     * @param comparator a Comparator
     * @return the maximum value
     * @see DefaultGroovyMethods#max(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static float maxComparing(float[] self, Comparator<Float> comparator) {
        return DefaultGroovyMethods.max(new FloatArrayIterator(self), comparator);
    }

    /**
     * Selects the maximum value found from the double array
     * using the comparator to determine the maximum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10.0d, 20.0d, 30.0d]
     * assert 30d == nums.maxComparing(Comparator.naturalOrder())
     * assert 10d == nums.maxComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       a double array
     * @param comparator a Comparator
     * @return the maximum value
     * @see DefaultGroovyMethods#max(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static double maxComparing(double[] self, Comparator<Double> comparator) {
        return DefaultGroovyMethods.max(new DoubleArrayIterator(self), comparator);
    }

    //--------------------------------------------------------------------------
    // min

    /**
     * Adds min() method to int arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [20, 10, 30]
     * assert 10 == nums.min()
     * </pre>
     *
     * @param self an int array
     * @return the minimum value
     * @since 3.0.8
     */
    public static int min(int[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");
        int answer = self[0];
        for (int i = 1; i < self.length; i++) {
            int value = self[i];
            if (value < answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds min() method to long arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [20L, 10L, 30L]
     * assert 10L == nums.min()
     * </pre>
     *
     * @param self a long array
     * @return the minimum value
     * @since 3.0.8
     */
    public static long min(long[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");
        long answer = self[0];
        for (int i = 1; i < self.length; i++) {
            long value = self[i];
            if (value < answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds min() method to float arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [1.1f, 3.3f, 2.2f]
     * assert 1.1f == nums.min()
     * </pre>
     *
     * @param self a float array
     * @return the minimum value
     * @since 5.0.0
     */
    public static float min(float[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");
        float answer = self[0];
        for (int i = 1; i < self.length; i++) {
            float value = self[i];
            if (value < answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds min() method to double arrays.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [20.0d, 10.0d, 30.0d]
     * assert 10.0d == nums.min()
     * </pre>
     *
     * @param self a double array
     * @return the minimum value
     * @since 3.0.8
     */
    public static double min(double[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");
        double answer = self[0];
        for (int i = 1; i < self.length; i++) {
            double value = self[i];
            if (value < answer) answer = value;
        }
        return answer;
    }

    /**
     * Adds min() method to Object arrays.
     *
     * @param self an array
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator)
     * @since 1.5.5
     */
    public static <T> T min(T[] self) {
        return DefaultGroovyMethods.min(new ArrayIterator<>(self));
    }

    //

    /**
     * Selects the minimum value found from the int array
     * using the supplied IntComparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, -20, 30]
     * assert -20 == nums.min{ n, m {@code ->} n {@code <=>} m }
     * assert 10 == nums.min{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self       an int array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static int min(int[] self, IntComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        int minV = self[0];
        for (int i = 1; i < self.length; i++) {
            int v = self[i];
            if (comparator.compare(v, minV) < 0) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the int array
     * using the supplied IntUnaryOperator to determine the minimum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, -20, 30]
     * assert -20 == nums.min{ n {@code ->} n }
     * assert 10 == nums.min{ n {@code ->} n.abs() }
     * </pre>
     * <p>
     *
     * @param self     an int array
     * @param operator an operator that returns an int used for comparing values
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static int min(int[] self, IntUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        int minV = self[0];
        for (int i = 1; i < self.length; i++) {
            int v = self[i];
            if (operator.applyAsInt(v) < operator.applyAsInt(minV)) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the long array
     * using the supplied LongComparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, -20L, 30L]
     * assert -20L == nums.min{ n, m {@code ->} n {@code <=>} m }
     * assert 10L == nums.min{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self       a long array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static long min(long[] self, LongComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        long minV = self[0];
        for (int i = 1; i < self.length; i++) {
            long v = self[i];
            if (comparator.compare(v, minV) < 0) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the long array
     * using the supplied LongUnaryOperator to determine the minimum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, -20L, 30L]
     * assert -20L == nums.min{ it }
     * assert 10L == nums.min{ it.abs() }
     * </pre>
     * <p>
     *
     * @param self     a long array
     * @param operator an operator that returns a long used for comparing values
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static long min(long[] self, LongUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        long minV = self[0];
        for (int i = 1; i < self.length; i++) {
            long v = self[i];
            if (operator.applyAsLong(v) < operator.applyAsLong(minV)) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the float array
     * using the supplied FloatComparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10f, -20f, 30f]
     * assert -20f == nums.min{ n, m {@code ->} n {@code <=>} m }
     * assert 10f == nums.min{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self       a float array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static float min(float[] self, FloatComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        float minV = self[0];
        for (int i = 1; i < self.length; i++) {
            float v = self[i];
            if (comparator.compare(v, minV) < 0) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the float array
     * using the supplied FloatUnaryOperator to determine the minimum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10f, -20f, 30f]
     * assert -20f == nums.min{ it }
     * assert 10f == nums.min{ it.abs() }
     * </pre>
     * <p>
     *
     * @param self     a double array
     * @param operator an operator that returns a double used for comparing values
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static float min(float[] self, FloatUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        float minV = self[0];
        for (int i = 1; i < self.length; i++) {
            float v = self[i];
            if (operator.applyAsFloat(v) < operator.applyAsFloat(minV)) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the double array
     * using the supplied DoubleComparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10d, -20d, 30d]
     * assert -20d == nums.min{ n, m {@code ->} n {@code <=>} m }
     * assert 10d == nums.min{ n, m {@code ->} n.abs() {@code <=>} m.abs() }
     * </pre>
     * <p>
     *
     * @param self       a double array
     * @param comparator a comparator, i.e. returns a negative value if the first parameter is less than the second
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static double min(double[] self, DoubleComparator comparator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        double minV = self[0];
        for (int i = 1; i < self.length; i++) {
            double v = self[i];
            if (comparator.compare(v, minV) < 0) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the double array
     * using the supplied DoubleUnaryOperator to determine the minimum of any two values.
     * The operator is applied to each array element and the results are compared.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10d, -20d, 30d]
     * assert -20d == nums.min{ it }
     * assert 10d == nums.min{ it.abs() }
     * </pre>
     * <p>
     *
     * @param self     a double array
     * @param operator an operator that returns a double used for comparing values
     * @return the minimum value
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static double min(double[] self, DoubleUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "min");

        double minV = self[0];
        for (int i = 1; i < self.length; i++) {
            double v = self[i];
            if (operator.applyAsDouble(v) < operator.applyAsDouble(minV)) {
                minV = v;
            }
        }
        return minV;
    }

    /**
     * Selects the minimum value found from the Object array using the given comparator.
     *
     * @param self       an array
     * @param comparator a Comparator
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator, java.util.Comparator)
     * @since 1.5.5
     */
    public static <T> T min(T[] self, Comparator<? super T> comparator) {
        return DefaultGroovyMethods.min(new ArrayIterator<>(self), comparator);
    }

    /**
     * Selects the minimum value found from the Object array
     * using the closure to determine the correct ordering.
     * <p>
     * If the closure has two parameters
     * it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer,
     * zero, or a positive integer when the first parameter is less than,
     * equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a
     * Comparable (typically an Integer) which is then used for
     * further comparison.
     *
     * @param self    an array
     * @param closure a Closure used to determine the correct ordering
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator, groovy.lang.Closure)
     * @since 1.5.5
     */
    public static <T> T min(T[] self, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        return DefaultGroovyMethods.min(new ArrayIterator<>(self), closure);
    }

    //

    /**
     * Selects the minimum value found from the int array
     * using the comparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [1, 2, 3]
     * assert 1 == nums.minComparing(Comparator.naturalOrder())
     * assert 3 == nums.minComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       an int array
     * @param comparator a Comparator
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static int minComparing(int[] self, Comparator<Integer> comparator) {
        return DefaultGroovyMethods.min(new IntArrayIterator(self), comparator);
    }

    /**
     * Selects the minimum value found from the long array
     * using the comparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [10L, 20L, 30L]
     * assert 10L == nums.minComparing(Comparator.naturalOrder())
     * assert 30L == nums.minComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       a long array
     * @param comparator a Comparator
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static long minComparing(long[] self, Comparator<Long> comparator) {
        return DefaultGroovyMethods.min(new LongArrayIterator(self), comparator);
    }

    /**
     * Selects the minimum value found from the float array
     * using the comparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10.0f, 20.0f, 30.0f]
     * assert 10f == nums.minComparing(Comparator.naturalOrder())
     * assert 30f == nums.minComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       a float array
     * @param comparator a Comparator
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static float minComparing(float[] self, Comparator<Float> comparator) {
        return DefaultGroovyMethods.min(new FloatArrayIterator(self), comparator);
    }

    /**
     * Selects the minimum value found from the double array
     * using the comparator to determine the minimum of any two values.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [10.0d, 20.0d, 30.0d]
     * assert 10d == nums.minComparing(Comparator.naturalOrder())
     * assert 30d == nums.minComparing(Comparator.reverseOrder())
     * </pre>
     * <p>
     *
     * @param self       a double array
     * @param comparator a Comparator
     * @return the minimum value
     * @see DefaultGroovyMethods#min(Iterator, java.util.Comparator)
     * @since 5.0.0
     */
    @Incubating
    public static double minComparing(double[] self, Comparator<Double> comparator) {
        return DefaultGroovyMethods.min(new DoubleArrayIterator(self), comparator);
    }

    //--------------------------------------------------------------------------
    // minus

    /**
     * Creates a new array composed of the elements of the first array minus the
     * elements of the given Iterable.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] ints = [1, 2, 3, 1]
     * List&lt;Integer> nope = [1, 3]
     * def result = ints - nope
     * assert result.class == Integer[]
     * assert result == new Integer[]{2}
     *
     * Integer[] none = []
     * result = none - 123
     * assert result !== none
     * assert result.length == 0
     * assert result.class == Integer[]
     * </pre>
     *
     * @param self     an array
     * @param removeMe an Iterable of elements to remove
     * @return An array with the supplied elements removed.
     * @since 1.5.5
     */
    public static <T> T[] minus(T[] self, Iterable<?> removeMe) {
        Collection<T> temp = DefaultGroovyMethods.minus((Iterable<T>) toList(self), removeMe);
        return temp.toArray(createSimilarArray(self, temp.size()));
    }

    /**
     * Creates a new array composed of the elements of the first array minus the
     * elements of the given array.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] ints = [1, 2, 3, 1]
     * Integer[] nope = [1, 3]
     * def result = ints - nope
     * assert result.class == Integer[]
     * assert result == new Integer[]{2}
     *
     * Integer[] none = []
     * result = none - 123
     * assert result !== none
     * assert result.length == 0
     * assert result.class == Integer[]
     * </pre>
     *
     * @param self     an array
     * @param removeMe an array of elements to remove
     * @return An array with the supplied elements removed.
     * @since 1.5.5
     */
    public static <T> T[] minus(T[] self, Object[] removeMe) {
        return switch (removeMe.length) {
            case 0 -> self.clone();
            case 1 -> ArrayGroovyMethods.minus(self, removeMe[0]);
            default -> {
                Collection<T> temp = DefaultGroovyMethods.minus((Collection<T>) toList(self), Arrays.asList(removeMe));
                yield temp.toArray(createSimilarArray(self, temp.size()));
            }
        };
    }

    /**
     * Creates a new array composed of the elements of the given array minus every occurrence the given object.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] ints = [1, 2, 3, 1]
     * def result = ints - 1
     * assert result.class == Integer[]
     * assert result == new Integer[]{2, 3}
     *
     * Integer[] none = []
     * result = none - '1'
     * assert result !== none
     * assert result.length == 0
     * assert result.class == Integer[]
     * </pre>
     *
     * @param self     an array
     * @param removeMe an element to remove from the array
     * @return a new array with the operand removed
     * @since 1.5.5
     */
    public static <T> T[] minus(T[] self, Object removeMe) {
        int i = 0, n = self.length;
        T[] result = createSimilarArray(self, n);
        for (T t : self) {
            if (!DefaultGroovyMethods.coercedEquals(t, removeMe)) {
                result[i] = t;
                i += 1;
            }
        }
        if (i != n) {
            result = Arrays.copyOfRange(result, 0, i);
        }
        return result;
    }

    //--------------------------------------------------------------------------
    // partitionPoint

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as Integer[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as Integer[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy arr
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static <T> int partitionPoint(T[] self, IntRange range, Predicate<? super T> condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as Integer[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as Integer[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new Integer[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static <T> int partitionPoint(T[] self, Predicate<? super T> condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as char[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as char[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy arr
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(char[] self, IntRange range, IntPredicate condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as char[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as char[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new char[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(char[] self, IntPredicate condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as short[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as short[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy arr
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(short[] self, IntRange range, IntPredicate condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as short[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as short[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new short[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(short[] self, IntPredicate condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as int[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as int[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy arr
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(int[] self, IntRange range, IntPredicate condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as int[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as int[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new int[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(int[] self, IntPredicate condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as long[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as long[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy arr
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(long[] self, IntRange range, LongPredicate condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as long[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as long[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new long[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(long[] self, LongPredicate condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as float[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as float[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy arr
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(float[] self, IntRange range, DoublePredicate condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as float[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as float[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new float[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(float[] self, DoublePredicate condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as double[]
     * assert arr.partitionPoint(0..&lt;arr.size()) { it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as double[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 100 } == arr.size()
     * // for all match condition
     * assert arr.partitionPoint(0..&lt;arr.size()) { it &lt;= 0 } == 0
     * // for no match condition with range
     * assert arr.partitionPoint(2..&lt;arr.size()) { it &lt;= 0 } == 2
     * </pre>
     *
     * @param self      a groovy array
     * @param range     the range [l,r] to find data match the condition
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(double[] self, IntRange range, DoublePredicate condition) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);

        int result = info.from;
        int left = info.from, right = info.to - 1;
        while (left <= right) {
            int mid = left + (right - left) / 2;
            if (condition.test(self[mid])) {
                result = mid + 1;
                left = mid + 1;
            } else {
                right = mid - 1;
            }
        }
        return result;
    }

    /**
     * Returns the index of the partition point according to the given predicate
     * (the index of the first element of the second partition).
     * The arr is assumed to be partitioned according to the given predicate.
     * <pre class="language-groovy groovyTestCase">
     * def arr = [7, 15, 3, 5, 4, 12, 6] as double[]
     * assert arr.partitionPoint{ it%2 != 0 } == 4
     * </pre>
     *
     * <pre class="language-groovy groovyTestCase">
     * def arr = [1, 2, 3, 3, 4, 4, 5, 6, 7] as double[]
     * // usage case like lower_bound(cpp), bisect_left(python)
     * assert arr.partitionPoint{ it &lt; 4 } == 4
     * // usage case like upper_bound(cpp), bisect_right(python)
     * assert arr.partitionPoint{ it &lt;= 4 } == 6
     * // for all match condition
     * assert arr.partitionPoint{ it &lt;= 100 } == arr.size()
     * // for no match condition
     * assert arr.partitionPoint{ it &lt;= 0 } == 0
     * // empty input
     * assert (new double[0]).partitionPoint{ it &lt; 4 } == 0
     * </pre>
     *
     * @param self      a groovy arr
     * @param condition the matching condition
     * @return an integer that is the index of the first element of the second partition
     * @since 5.0.0
     */
    public static int partitionPoint(double[] self, DoublePredicate condition) {
        Objects.requireNonNull(self);
        if (self.length == 0) return 0;
        return partitionPoint(self, new IntRange(true, 0, self.length - 1), condition);
    }

    //--------------------------------------------------------------------------
    // plus

    /**
     * Creates an array containing elements from an original array plus those from a Collection.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] a = [1, 2, 3]
     * def result = a + [4, 5, 6]
     * assert result.class == Integer[]
     * assert result == new Integer[]{1, 2, 3, 4, 5, 6}
     *
     * Number[] c = [-1, 0.9, null]
     * result = c + [1, 2, 3]
     * assert result.class == Number[]
     * assert result == new Number[]{-1, 0.9, null, 1, 2, 3}
     *
     * result = a + [-1, 0.9, null]
     * assert result.class == Integer[]
     * assert result == new Integer[]{1, 2, 3, -1, 0, null}
     *
     * // improper type arguments; Date can't be coerced to Integer
     * groovy.test.GroovyAssert.shouldFail(ClassCastException) { a + [new Date()] }
     * </pre>
     *
     * @param left  the array
     * @param right a Collection to be appended
     * @return A new array containing left with right appended to it.
     * @throws ClassCastException if any elements from right aren't compatible (according to {@link DefaultTypeTransformation#castToType(Object, Class)}) to the component type of left
     * @since 1.8.7
     */
    @SuppressWarnings("unchecked")
    public static <T> T[] plus(T[] left, Collection<?> right) {
        T[] result = Arrays.copyOf(left, left.length + right.size());
        int i = left.length;
        Class<?> leftType = left.getClass().getComponentType();
        for (Object t : right) {
            result[i] = (T) DefaultTypeTransformation.castToType(t, leftType);
            i += 1;
        }
        return result;
    }

    /**
     * Creates an array containing elements from an original array plus those from an Iterable.
     * <pre class="language-groovy groovyTestCase">
     * class AbcIterable implements Iterable<String> {
     *     Iterator<String> iterator() { "abc".iterator() }
     * }
     * String[] array = ['x', 'y', 'z']
     * def result = array + new AbcIterable()
     * assert result.class == String[]
     * assert result == new String[]{'x', 'y', 'z', 'a', 'b', 'c'}
     * </pre>
     *
     * @param left  the array
     * @param right an Iterable to be appended
     * @return A new array containing elements from left with those from right appended.
     * @throws ClassCastException if any elements from right aren't compatible (according to {@link DefaultTypeTransformation#castToType(Object, Class)}) to the component type of left
     * @see #union(Object[], Iterable)
     * @since 1.8.7
     */
    public static <T> T[] plus(T[] left, Iterable<?> right) {
        return plus(left, DefaultGroovyMethods.toList(right));
    }

    /**
     * Creates an array as a union of two arrays.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] a = [1, 2, 3]
     * Integer[] b = [4, 5, 6]
     * def result = a + b
     * assert result.class == Integer[]
     * assert result == new Integer[]{1, 2, 3, 4, 5, 6}
     *
     * Number[] c = [-1, 0.9, null]
     * result = c + a
     * assert result.class == Number[]
     * assert result == new Number[]{-1, 0.9, null, 1, 2, 3}
     *
     * result = a + c
     * assert result.class == Integer[]
     * assert result == new Integer[]{1, 2, 3, -1, 0, null}
     *
     * Date[] d = [new Date()]
     * // improper type arguments; Date can't be coerced to Integer
     * groovy.test.GroovyAssert.shouldFail(ClassCastException) { a + d }
     * </pre>
     *
     * @param left  the left Array
     * @param right the right Array
     * @return A new array containing right appended to left.
     * @throws ClassCastException if any elements from right aren't compatible (according to {@link DefaultTypeTransformation#castToType(Object, Class)}) to the component type of left
     * @since 1.8.7
     */
    @SuppressWarnings("unchecked")
    public static <T> T[] plus(T[] left, Object[] right) {
        T[] result = Arrays.copyOf(left, left.length + right.length);
        T[] temp = (T[]) DefaultTypeTransformation.castToType(right, left.getClass());
        System.arraycopy(temp, 0, result, left.length, temp.length);
        return result;
    }

    /**
     * Creates an array containing elements from an original array plus an additional appended element.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] a = [1, 2, 3]
     * def result = a + 4
     * assert result.class == Integer[]
     * assert result == new Integer[]{1, 2, 3, 4}
     *
     * result = a + 5.5d
     * assert result.class == Integer[]
     * assert result == new Integer[]{1, 2, 3, 5}
     *
     * // improper type arguments; Date can't be coerced to Integer
     * groovy.test.GroovyAssert.shouldFail(ClassCastException) { a + new Date() }
     * </pre>
     *
     * @param left  the array
     * @param right the value to append
     * @return A new array containing left with right appended to it.
     * @throws ClassCastException if any elements from right aren't compatible (according to {@link DefaultTypeTransformation#castToType(Object, Class)}) to the component type of left
     * @since 1.8.7
     */
    @SuppressWarnings("unchecked")
    public static <T> T[] plus(T[] left, Object right) {
        T[] result = Arrays.copyOf(left, left.length + 1);
        result[left.length] = (T) DefaultTypeTransformation.castToType(right, left.getClass().getComponentType());
        return result;
    }

    //--------------------------------------------------------------------------
    // putAt

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] from = [70, 80, 90]
     * Integer[] nums = [1, 2, 3, 4, 5]
     * nums[1..3] = from
     * assert nums == [1, 70, 80, 90, 5]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static <T> void putAt(T[] self, IntRange range, T[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Null will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [70, 80, 90]
     * Integer[] nums = [1, 2, 3, 4, 5]
     * nums[1..3] = from
     * assert nums == [1, 70, 80, 90, 5]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static <T> void putAt(T[] self, IntRange range, Iterable<T> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<T> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            T next = iter.hasNext() ? iter.next() : null;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] from = [true, true, true]
     * boolean[] to = [false, false, false, false, false]
     * to[1..3] = from
     * assert to == [false, true, true, true, false]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(boolean[] self, IntRange range, boolean[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * False will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [true, true, true]
     * boolean[] to = [false, false, false, false, false]
     * to[1..3] = from
     * assert to == [false, true, true, true, false]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(boolean[] self, IntRange range, Iterable<Boolean> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Boolean> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            boolean next = iter.hasNext() ? iter.next() : false;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * byte[] from = [1, 1, 1]
     * byte[] to = [0, 0, 0, 0, 0]
     * to[1..3] = from
     * assert to == [0, 1, 1, 1, 0]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(byte[] self, IntRange range, byte[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Zero will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [1, 1, 1]
     * byte[] to = [0, 0, 0, 0, 0]
     * to[1..3] = from
     * assert to == [0, 1, 1, 1, 0]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(byte[] self, IntRange range, Iterable<Number> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Number> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            byte next = iter.hasNext() ? iter.next().byteValue() : 0;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * char[] from = 'XYZ'.chars
     * char[] to = 'abcde'.chars
     * to[1..3] = from
     * assert to == 'aXYZe'.chars
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(char[] self, IntRange range, char[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * The null character, \0, will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = 'XYZ'.chars.toList()
     * char[] to = 'abcde'.chars
     * to[1..3] = from
     * assert to == 'aXYZe'.chars
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(char[] self, IntRange range, Iterable<Character> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Character> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            char next = iter.hasNext() ? iter.next() : '\0';
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * short[] from = [1, 1, 1]
     * short[] to = [0, 0, 0, 0, 0]
     * to[1..3] = from
     * assert to == [0, 1, 1, 1, 0]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(short[] self, IntRange range, short[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Zero will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [1, 1, 1]
     * short[] to = [0, 0, 0, 0, 0]
     * to[1..3] = from
     * assert to == [0, 1, 1, 1, 0]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(short[] self, IntRange range, Iterable<Number> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Number> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            short next = iter.hasNext() ? iter.next().shortValue() : 0;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * int[] from = [1, 1, 1]
     * int[] to = [0, 0, 0, 0, 0]
     * to[1..3] = from
     * assert to == [0, 1, 1, 1, 0]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(int[] self, IntRange range, int[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Zero will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [1, 1, 1]
     * int[] to = [0, 0, 0, 0, 0]
     * to[1..3] = from
     * assert to == [0, 1, 1, 1, 0]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(int[] self, IntRange range, Iterable<Number> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Number> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            int next = iter.hasNext() ? iter.next().intValue() : 0;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * long[] from = [1L, 1L, 1L]
     * long[] to = [0L, 0L, 0L, 0L, 0L]
     * to[1..3] = from
     * assert to == [0L, 1L, 1L, 1L, 0L]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(long[] self, IntRange range, long[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Zero will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [1L, 1L, 1L]
     * long[] to = [0L, 0L, 0L, 0L, 0L]
     * to[1..3] = from
     * assert to == [0L, 1L, 1L, 1L, 0L]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(long[] self, IntRange range, Iterable<Number> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Number> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            long next = iter.hasNext() ? iter.next().longValue() : 0;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * float[] from = [1f, 1f, 1f]
     * float[] to = [0f, 0f, 0f, 0f, 0f]
     * to[1..3] = from
     * assert to == [0f, 1f, 1f, 1f, 0f]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(float[] self, IntRange range, float[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Zero will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [1f, 1f, 1f]
     * float[] to = [0f, 0f, 0f, 0f, 0f]
     * to[1..3] = from
     * assert to == [0f, 1f, 1f, 1f, 0f]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(float[] self, IntRange range, Iterable<Number> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Number> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            float next = iter.hasNext() ? iter.next().floatValue() : 0;
            self[i] = next;
        }
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * <pre class="language-groovy groovyTestCase">
     * double[] from = [1d, 1d, 1d]
     * double[] to = [0d, 0d, 0d, 0d, 0d]
     * to[1..3] = from
     * assert to == [0d, 1d, 1d, 1d, 0d]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @throws IndexOutOfBoundsException if the source doesn't have sufficient elements or the IntRange is too big for the self array
     * @since 5.0.0
     */
    public static void putAt(double[] self, IntRange range, double[] source) {
        RangeInfo info = range.subListBorders(self.length);
        System.arraycopy(source, 0, self, info.from, info.to - info.from);
    }

    /**
     * A helper method to allow arrays to be set with subscript operators.
     * Zero will be used if the source iterable has insufficient elements.
     * <pre class="language-groovy groovyTestCase">
     * def from = [1d, 1d, 1d]
     * double[] to = [0d, 0d, 0d, 0d, 0d]
     * to[1..3] = from
     * assert to == [0d, 1d, 1d, 1d, 0d]
     * </pre>
     *
     * @param self   an array
     * @param range  the subset of the array to set
     * @param source the source array from which new values will come
     * @since 5.0.0
     */
    public static void putAt(double[] self, IntRange range, Iterable<Number> source) {
        RangeInfo info = range.subListBorders(self.length);
        Iterator<Number> iter = source.iterator();
        for (int i = info.from; i < info.to; i++) {
            double next = iter.hasNext() ? iter.next().doubleValue() : 0;
            self[i] = next;
        }
    }

    //--------------------------------------------------------------------------
    // reverse

    /**
     * Creates a new boolean array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true]
     * assert array.reverse() == [true, false]
     * </pre>
     *
     * @param self a boolean array
     * @return an array containing the reversed items
     * @see #reverse(boolean[], boolean)
     * @since 5.0.0
     */
    public static boolean[] reverse(boolean[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, true]
     * def yarra = array.reverse(true)
     * assert array == [true, true, false]
     * assert yarra == [true, true, false]
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == [true, true, false]
     * assert yarra == [false, true, true]
     * </pre>
     *
     * @param self   a boolean array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static boolean[] reverse(boolean[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new byte array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = 1..2
     * assert array.reverse() == 2..1
     * </pre>
     *
     * @param self a byte array
     * @return an array containing the reversed items
     * @see #reverse(byte[], boolean)
     * @since 5.0.0
     */
    public static byte[] reverse(byte[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = 1..3
     * def yarra = array.reverse(true)
     * assert array == 3..1
     * assert yarra == 3..1
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == 3..1
     * assert yarra == 1..3
     * </pre>
     *
     * @param self   a byte array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static byte[] reverse(byte[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new char array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a', 'b']
     * assert array.reverse() == ['b', 'a'] as char[]
     * </pre>
     *
     * @param self a char array
     * @return an array containing the reversed items
     * @see #reverse(char[], boolean)
     * @since 5.0.0
     */
    public static char[] reverse(char[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = ['a', 'b', 'c']
     * def yarra = array.reverse(true)
     * assert array == ['c', 'b', 'a']
     * assert yarra == ['c', 'b', 'a']
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == ['c', 'b', 'a']
     * assert yarra == ['a', 'b', 'c']
     * </pre>
     *
     * @param self   a char array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static char[] reverse(char[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new short array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = 1..2
     * assert array.reverse() == 2..1
     * </pre>
     *
     * @param self a short array
     * @return an array containing the reversed items
     * @see #reverse(short[], boolean)
     * @since 5.0.0
     */
    public static short[] reverse(short[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = 1..3
     * def yarra = array.reverse(true)
     * assert array == 3..1
     * assert yarra == 3..1
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == 3..1
     * assert yarra == 1..3
     * </pre>
     *
     * @param self   a short array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static short[] reverse(short[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new int array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = 1..2
     * assert array.reverse() == 2..1
     * </pre>
     *
     * @param self an int array
     * @return an array containing the reversed items
     * @see #reverse(int[], boolean)
     * @since 5.0.0
     */
    public static int[] reverse(int[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = 1..3
     * def yarra = array.reverse(true)
     * assert array == 3..1
     * assert yarra == 3..1
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == 3..1
     * assert yarra == 1..3
     * </pre>
     *
     * @param self   an int array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static int[] reverse(int[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new long array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = 1L..2L
     * assert array.reverse() == 2L..1L
     * </pre>
     *
     * @param self a long array
     * @return an array containing the reversed items
     * @see #reverse(long[], boolean)
     * @since 5.0.0
     */
    public static long[] reverse(long[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = 1L..3L
     * def yarra = array.reverse(true)
     * assert array == 3L..1L
     * assert yarra == 3L..1L
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == 3L..1L
     * assert yarra == 1L..3L
     * </pre>
     *
     * @param self   a long array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static long[] reverse(long[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new float array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [1f, 2f]
     * assert array.reverse() == [2f, 1f]
     * </pre>
     *
     * @param self a float array
     * @return an array containing the reversed items
     * @see #reverse(float[], boolean)
     * @since 5.0.0
     */
    public static float[] reverse(float[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = 1f..3f
     * def yarra = array.reverse(true)
     * assert array == 3f..1f
     * assert yarra == 3f..1f
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == 3f..1f
     * assert yarra == 1f..3f
     * </pre>
     *
     * @param self   a float array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static float[] reverse(float[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new double array containing items which are the same as this array but in reverse order.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [1d, 2d]
     * assert array.reverse() == [2d, 1d]
     * </pre>
     *
     * @param self a double array
     * @return an array containing the reversed items
     * @see #reverse(double[], boolean)
     * @since 5.0.0
     */
    public static double[] reverse(double[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = 1d..3d
     * def yarra = array.reverse(true)
     * assert array == 3d..1d
     * assert yarra == 3d..1d
     * assert array === yarra
     * yarra = array.reverse(false)
     * assert array !== yarra
     * assert array == 3d..1d
     * assert yarra == 1d..3d
     * </pre>
     *
     * @param self   a double array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return an array containing the reversed items
     * @since 5.0.0
     */
    public static double[] reverse(double[] self, boolean mutate) {
        int len = self.length;
        if (!mutate) self = self.clone();
        for (int i=0, mid=len>>1, j=len-1; i<mid; i++, j--)
            swap(self, i, j);
        return self;
    }

    /**
     * Creates a new array containing items which are the same as this array but in reverse order.
     *
     * @param self    an array
     * @return An array containing the reversed items.
     * @see #reverse(Object[], boolean)
     * @since 1.5.5
     */
    public static <T> T[] reverse(T[] self) {
        return reverse(self, false);
    }

    /**
     * Reverses the items in an array. If mutate is true, the original array is modified in place and returned.
     * Otherwise, a new array containing the reversed items is produced.
     *
     * <pre class="language-groovy groovyTestCase">
     * def array = new Object[] {1,2,3}
     * def yarra = array.reverse(true)
     * assert array == 3..1
     * assert yarra == 3..1
     *
     * yarra = array.reverse(false)
     * assert array == 3..1
     * assert yarra == 1..3
     * </pre>
     *
     * @param self   an array
     * @param mutate {@code true} if the array itself should be reversed in place, {@code false} if a new array should be created
     * @return An array containing the reversed items.
     * @since 1.8.1
     */
    public static <T> T[] reverse(T[] self, boolean mutate) {
        if (!mutate) self = self.clone();
        Collections.reverse(Arrays.asList(self));
        return self;
    }

    //--------------------------------------------------------------------------
    // reverseEach

    /**
     * Iterates through a boolean[] in reverse order passing each boolean to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, true]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == 'truetruefalse'
     * </pre>
     *
     * @param self    the boolean array over which we iterate
     * @param closure the closure applied on each boolean
     * @return the self array
     * @since 5.0.0
     */
    public static boolean[] reverseEach(boolean[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through a byte[] in reverse order passing each byte to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [0, 1, 2]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == '210'
     * </pre>
     *
     * @param self    the byte array over which we iterate
     * @param closure the closure applied on each byte
     * @return the self array
     * @since 5.0.0
     */
    public static byte[] reverseEach(byte[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through a char[] in reverse order passing each char to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'abc'.chars
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == 'cba'
     * </pre>
     *
     * @param self    the char array over which we iterate
     * @param closure the closure applied on each char
     * @return the self array
     * @since 5.0.0
     */
    public static char[] reverseEach(char[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through a short[] in reverse order passing each short to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [0, 1, 2]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == '210'
     * </pre>
     *
     * @param self    the short array over which we iterate
     * @param closure the closure applied on each short
     * @return the self array
     * @since 5.0.0
     */
    public static short[] reverseEach(short[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through an int[] in reverse order passing each int to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [0, 1, 2]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == '210'
     * </pre>
     *
     * @param self    the int array over which we iterate
     * @param closure the closure applied on each int
     * @return the self array
     * @since 5.0.0
     */
    public static int[] reverseEach(int[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through a long[] in reverse order passing each long to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [0, 1, 2]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == '210'
     * </pre>
     *
     * @param self    the long array over which we iterate
     * @param closure the closure applied on each long
     * @return the self array
     * @since 5.0.0
     */
    public static long[] reverseEach(long[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through a float[] in reverse order passing each float to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [0, 1, 2]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == '2.01.00.0'
     * </pre>
     *
     * @param self    the float array over which we iterate
     * @param closure the closure applied on each float
     * @return the self array
     * @since 5.0.0
     */
    public static float[] reverseEach(float[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates through a double[] in reverse order passing each double to the given closure.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [0, 1, 2]
     * String result = ''
     * array.reverseEach{ result += it }
     * assert result == '2.01.00.0'
     * </pre>
     *
     * @param self    the double array over which we iterate
     * @param closure the closure applied on each double
     * @return the self array
     * @since 5.0.0
     */
    public static double[] reverseEach(double[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    /**
     * Iterates over each element of the array in the reverse order.
     *
     * @param self    an array
     * @param closure a closure to which each item is passed
     * @return the original array
     * @since 1.5.2
     */
    public static <T> T[] reverseEach(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        Objects.requireNonNull(self);
        for (int i = self.length - 1; i >= 0; i--) {
            closure.call(self[i]);
        }
        return self;
    }

    //--------------------------------------------------------------------------
    // shuffle

    private static Random r;

    /**
     * Randomly reorders the elements of the specified array.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] array = [10, 5, 20]
     * def origSize = array.size()
     * def items = array.toList()
     * array.shuffle()
     * assert array.size() == origSize
     * assert items.every{ array.contains(it) }
     * </pre>
     *
     * @param self an array
     * @since 3.0.0
     */
    public static <T> void shuffle(T[] self) {
        Random rnd = r;
        if (rnd == null)
            r = rnd = new Random(); // harmless race.
        shuffle(self, rnd);
    }

    /**
     * Randomly reorders the elements of the specified array using the
     * specified random instance as the source of randomness.
     * <pre class="language-groovy groovyTestCase">
     * def r = new Random()
     * Integer[] array = [10, 5, 20]
     * def origSize = array.size()
     * def items = array.toList()
     * array.shuffle(r)
     * assert array.size() == origSize
     * assert items.every{ array.contains(it) }
     * </pre>
     *
     * @param self an array
     * @since 3.0.0
     */
    public static <T> void shuffle(T[] self, Random rnd) {
        for (int i = 0; i < self.length-1; i++) {
            int nextIndex = rnd.nextInt(self.length);
            T tmp = self[i];
            self[i] = self[nextIndex];
            self[nextIndex] = tmp;
        }
    }

    //--------------------------------------------------------------------------
    // shuffled

    /**
     * Creates a new array containing the elements of the specified array but in a random order.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] array = [10, 5, 20]
     * def result = array.shuffled()
     * assert array !== result
     * assert array.length == result.length
     * assert array.every{ result.contains(it) }
     * assert array == new Integer[] {10, 5, 20}
     * </pre>
     *
     * @param self an array
     * @return the shuffled array
     * @since 3.0.0
     */
    public static <T> T[] shuffled(T[] self) {
        Random rnd = r;
        if (rnd == null)
            r = rnd = new Random(); // harmless race.
        return shuffled(self, rnd);
    }

    /**
     * Creates a new array containing the elements of the specified array but in a random
     * order using the specified random instance as the source of randomness.
     * <pre class="language-groovy groovyTestCase">
     * def r = new Random()
     * Integer[] array = [10, 5, 20]
     * def result = array.shuffled(r)
     * assert array !== result
     * assert array.length == result.length
     * assert array.every{ result.contains(it) }
     * assert array == new Integer[] {10, 5, 20}
     * </pre>
     *
     * @param self an array
     * @return the shuffled array
     * @since 3.0.0
     */
    public static <T> T[] shuffled(T[] self, Random rnd) {
        T[] result = self.clone();
        Collections.shuffle(Arrays.asList(result), rnd);
        return result;
    }

    //--------------------------------------------------------------------------
    // size

    /**
     * Provides arrays with a {@code size} method similar to collections.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false, true]
     * assert array.size() == 3
     * </pre>
     *
     * @param self a boolean array
     * @return the length of the array
     * @since 1.5.0
     */
    public static int size(boolean[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self a byte array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(byte[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self a char array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(char[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self a short array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(short[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self an int array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(int[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self a long array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(long[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self a float array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(float[] self) {
        return self.length;
    }

    /**
     * Provides arrays with a {@code size} method similar to collections.
     *
     * @param self a double array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(double[] self) {
        return self.length;
    }

    /**
     * Provides the standard Groovy <code>size()</code> method for an array.
     *
     * @param self an object array
     * @return the length of the array
     * @since 1.0
     */
    public static int size(Object[] self) {
        return self.length;
    }

    //--------------------------------------------------------------------------
    // sort

    /**
     * Modifies this array so that its elements are in sorted order.
     * The array items are assumed to be comparable.
     *
     * @param self the array to be sorted
     * @return the sorted array
     * @since 1.5.5
     */
    public static <T> T[] sort(T[] self) {
        Arrays.sort(self, new NumberAwareComparator<>());
        return self;
    }

    /**
     * Sorts the given array into sorted order.
     * The array items are assumed to be comparable.
     * If mutate is true, the array is sorted in place and returned. Otherwise, a new sorted
     * array is returned and the original array remains unchanged.
     * <pre class="language-groovy groovyTestCase">
     * def orig = ["hello","hi","Hey"] as String[]
     * def sorted = orig.sort(false)
     * assert orig == ["hello","hi","Hey"] as String[]
     * assert sorted == ["Hey","hello","hi"] as String[]
     * orig.sort(true)
     * assert orig == ["Hey","hello","hi"] as String[]
     * </pre>
     *
     * @param self   the array to be sorted
     * @param mutate false will always cause a new array to be created, true will mutate the array in place
     * @return the sorted array
     * @since 1.8.1
     */
    public static <T> T[] sort(T[] self, boolean mutate) {
        T[] answer = mutate ? self : self.clone();
        Arrays.sort(answer, new NumberAwareComparator<>());
        return answer;
    }

    /**
     * Sorts the given array into sorted order using the given comparator.
     *
     * @param self the array to be sorted
     * @param comparator a Comparator used for the comparison
     * @return the sorted array
     * @since 1.5.5
     */
    public static <T> T[] sort(T[] self, Comparator<? super T> comparator) {
        return sort(self, true, comparator);
    }

    /**
     * Sorts the elements from this array into sorted order as determined by the given comparator.
     * If mutate is true, the array is sorted in place and returned. Otherwise, a new sorted
     * array is returned and the original array remains unchanged.
     * <pre class="language-groovy groovyTestCase">
     * def orig = ["hello","hi","Hey"] as String[]
     * def sorted = orig.sort(false, String.CASE_INSENSITIVE_ORDER)
     * assert orig == ["hello","hi","Hey"] as String[]
     * assert sorted == ["hello","Hey","hi"] as String[]
     * orig.sort(true, String.CASE_INSENSITIVE_ORDER)
     * assert orig == ["hello","Hey","hi"] as String[]
     * </pre>
     *
     * @param self       the array containing elements to be sorted
     * @param mutate     false will always cause a new array to be created, true will mutate arrays in place
     * @param comparator a Comparator used for the comparison
     * @return a sorted array
     * @since 1.8.1
     */
    public static <T> T[] sort(T[] self, boolean mutate, Comparator<? super T> comparator) {
        T[] answer = mutate ? self : self.clone();
        Arrays.sort(answer, comparator);
        return answer;
    }

    /**
     * Sorts the elements from this array into a newly created array using
     * the Closure to determine the correct ordering.
     * <p>
     * If the closure has two parameters it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer, zero, or a positive integer when the
     * first parameter is less than, equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a Comparable (typically an Integer)
     * which is then used for further comparison.
     *
     * @param self the array containing the elements to be sorted
     * @param closure a Closure used to determine the correct ordering
     * @return the sorted array
     * @since 1.5.5
     */
    public static <T> T[] sort(T[] self, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        return sort(self, false, closure);
    }

    /**
     * Sorts the elements from this array with index values in the given index range
     * into a newly created array using the Closure to determine the correct ordering.
     * <p>
     * If the closure has two parameters it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer, zero, or a positive integer when the
     * first parameter is less than, equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a Comparable (typically an Integer)
     * which is then used for further comparison.
     *
     * @param self the array containing the elements to be sorted
     * @param closure a Closure used to determine the correct ordering
     * @return the sorted array
     * @since 5.0.0
     */
    public static <T> T[] sort(T[] self, IntRange range, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        return sort(self, range, false, closure);
    }

    /**
     * Sorts the elements from this array into sorted order using the Closure to determine the correct ordering.
     * If mutate is false, a new array is returned and the original array remains unchanged.
     * Otherwise, the original array is sorted in place and returned.
     * <p>
     * If the closure has two parameters it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer, zero, or a positive integer when the
     * first parameter is less than, equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a Comparable (typically an Integer)
     * which is then used for further comparison.
     * <pre class="language-groovy groovyTestCase">
     * def orig = ["hello","hi","Hey"] as String[]
     * def sorted = orig.sort(false) { it.size() }
     * assert orig == ["hello","hi","Hey"] as String[]
     * assert sorted == ["hi","Hey","hello"] as String[]
     * orig.sort(true) { it.size() }
     * assert orig == ["hi","Hey","hello"] as String[]
     * </pre>
     *
     * @param self    the array to be sorted
     * @param mutate  false causes a new array to be created, true will mutate arrays in place
     * @param closure a Closure used to determine the correct ordering
     * @return the sorted array
     * @since 1.8.1
     */
    public static <T> T[] sort(T[] self, boolean mutate, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        if (!mutate) self = self.clone();
        Comparator<T> c = closure.getMaximumNumberOfParameters() == 1 ? new OrderBy<>(closure) : new ClosureComparator<>(closure);
        Arrays.sort(self, c);
        return self;
    }

    /**
     * Sorts the elements with index values in the given index range
     * into sorted order using the Closure to determine the correct ordering.
     * If mutate is false, a new array is returned and the original array remains unchanged.
     * Otherwise, the original array is sorted in place and returned.
     * <p>
     * If the closure has two parameters it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer, zero, or a positive integer when the
     * first parameter is less than, equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a Comparable (typically an Integer)
     * which is then used for further comparison.
     * <pre class="language-groovy groovyTestCase">
     * // an array with some odd then even numbers
     * Integer[] nums = [5, 9, 1, 7, 3, 4, 8, 6, 0, 2]
     *
     * // sort odds ascending, evens descending
     * assert nums.sort(0..4, false) { it }.sort(5..9, false) { -it }
     *  == [1, 3, 5, 7, 9, 8, 6, 4, 2, 0]
     * // sort odds descending, evens descending
     * assert nums.sort(0..&lt;5, false) { -it }.sort(4&lt;..&lt;10, false) { -it }
     *  == [9, 7, 5, 3, 1, 8, 6, 4, 2, 0]
     * // sort odds descending, evens ascending
     * assert nums.sort(0..&lt;5, false) { -it }.sort(5..-1, false) { it }
     *  == [9, 7, 5, 3, 1, 0, 2, 4, 6, 8]
     * // leave first and last numbers, sort remaining odds ascending, remaining evens descending
     * assert nums.sort(1..4, false) { it }.sort(5..-2, false) { -it }
     *  == [5, 1, 3, 7, 9, 8, 6, 4, 0, 2]
     * // leave first and last numbers, sort remaining odds descending, remaining evens ascending
     * assert nums.sort(1..4, false) { -it }.sort(5..-2, false) { it }
     *  == [5, 9, 7, 3, 1, 0, 4, 6, 8, 2]
     * // leave first and last odds and evens, sort remaining odds ascending, remaining evens descending
     * assert nums.sort(0&lt;..&lt;4, false) { it }.sort(5&lt;..&lt;9, false) { -it }
     *  == [5, 1, 7, 9, 3, 4, 8, 6, 0, 2]
     * // leave first and last odds and evens, sort remaining odds descending, remaining evens ascending
     * assert nums.sort(0&lt;..&lt;4, false) { -it }.sort(5&lt;..&lt;-1, false) { it }
     *  == [5, 9, 7, 1, 3, 4, 0, 6, 8, 2]
     * </pre>
     *
     * @param self    the array to be sorted
     * @param range   the inclusive range of index values over which to sort
     * @param mutate  false causes a new array to be created, true will mutate arrays in place
     * @param closure a Closure used to determine the correct ordering
     * @return the sorted array
     * @since 5.0.0
     */
    public static <T> T[] sort(T[] self, IntRange range, boolean mutate, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        Objects.requireNonNull(self);
        RangeInfo info = range.subListBorders(self.length);
        Objects.checkFromToIndex(info.from, info.to, self.length);
        if (!mutate) self = self.clone();
        Comparator<T> c = closure.getMaximumNumberOfParameters() == 1 ? new OrderBy<>(closure) : new ClosureComparator<>(closure);
        Arrays.sort(self, info.from, info.to, c);
        return self;
    }

    //--------------------------------------------------------------------------
    // split

    /**
     * Splits all items into two collections based on the closure condition.
     * The first list contains all items which match the closure expression.
     * The second list all those that don't.
     *
     * @param self    an Array
     * @param closure a closure condition
     * @return a List whose first item is the accepted values and whose second item is the rejected values
     * @since 2.5.0
     */
    public static <T> Collection<Collection<T>> split(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        List<T> accept = new ArrayList<>(), reject = new ArrayList<>();
        return DefaultGroovyMethods.split(closure, accept, reject, new ArrayIterator<>(self));
    }

    /**
     * Splits all array items into two collections based on the predicate.
     * A "fat-free" variant of {@link #split(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4]
     * assert [[2, 4], [1, 3]] == nums.split(n -&gt; n % 2 == 0)
     * </pre>
     *
     * @param self      an array
     * @param predicate a predicate used to determine the target collection
     * @return a List whose first item is the accepted values and whose second item is the rejected values
     * @since 6.0.0
     */
    public static <T> Collection<Collection<T>> split(T[] self, Predicate<? super T> predicate) {
        List<T> accept = new ArrayList<>(), reject = new ArrayList<>();
        return DefaultGroovyMethods.split(predicate, accept, reject, new ArrayIterator<>(self));
    }

    //--------------------------------------------------------------------------
    // sum

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert (1+2+3+4 as byte) == ([1,2,3,4] as byte[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static byte sum(byte[] self) {
        return sum(self, (byte) 0);
    }

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert (1+2+3+4 as char) == ([1,2,3,4] as char[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static char sum(char[] self) {
        return sum(self, (char) 0);
    }

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert (1+2+3+4 as short) == ([1,2,3,4] as short[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static short sum(short[] self) {
        return sum(self, (short) 0);
    }

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert 1+2+3+4 == ([1,2,3,4] as int[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static int sum(int[] self) {
        return sum(self, 0);
    }

    /**
     * Calculates the sum of values found from applying the operator to members of the int array.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, -20, 30]
     * assert 20 == nums.sum{ n {@code ->} n }
     * assert 60 == nums.sum{ n {@code ->} n.abs() }
     * int[] squares = [1, 4, 9]
     * assert squares.sum(java.util.function.IntUnaryOperator.identity()) == 14
     * assert squares.sum(Math::sqrt) == 6
     * </pre>
     * <p>
     *
     * @param self     an int array
     * @param operator an operator that returns an int used for summing values
     * @return the sum value of all values after applying the operator
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static int sum(int[] self, IntUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "sum");

        int total = 0;
        for (int i : self) {
            total += operator.applyAsInt(i);
        }
        return total;
    }

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert (1+2+3+4 as long) == ([1,2,3,4] as long[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static long sum(long[] self) {
        return sum(self, 0L);
    }

    /**
     * Calculates the sum of values found from applying the operator to members of the int array.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, -20, 30]
     * assert 20 == nums.sum{ n {@code ->} n }
     * assert 60 == nums.sum{ n {@code ->} n.abs() }
     * </pre>
     * <p>
     *
     * @param self     a long array
     * @param operator an operator that returns a long used for summing values
     * @return the sum value of all values after applying the operator
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static long sum(long[] self, LongUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "sum");

        long total = 0;
        for (long i : self) {
            total += operator.applyAsLong(i);
        }
        return total;
    }

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert (1+2+3+4 as float) == ([1,2,3,4] as float[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static float sum(float[] self) {
        return sum(self, 0.0f);
    }

    /**
     * Calculates the sum of values found from applying the operator to members of the float array.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [10f, -20f, 30f]
     * assert 20f == nums.sum{ n {@code ->} n }
     * assert 60f == nums.sum{ n {@code ->} n.abs() }
     * </pre>
     * <p>
     *
     * @param self     a float array
     * @param operator an operator that returns a float used for summing values
     * @return the sum value of all values after applying the operator
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static float sum(float[] self, FloatUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "sum");

        float total = 0;
        for (float i : self) {
            total += operator.applyAsFloat(i);
        }
        return total;
    }

    /**
     * Sums the items in an array.
     * <pre class="language-groovy groovyTestCase">assert (1+2+3+4 as double) == ([1,2,3,4] as double[]).sum()</pre>
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @since 2.4.2
     */
    public static double sum(double[] self) {
        return sum(self, 0.0d);
    }

    /**
     * Calculates the sum of values found from applying the operator to members of the int array.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [10, -20, 30]
     * assert 20 == nums.sum{ n {@code ->} n }
     * assert 60 == nums.sum{ n {@code ->} n.abs() }
     * </pre>
     * <p>
     *
     * @param self     a double array
     * @param operator an operator that returns a double used for summing values
     * @return the sum value of all values after applying the operator
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    @Incubating
    public static double sum(double[] self, DoubleUnaryOperator operator) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "sum");

        double total = 0;
        for (double i : self) {
            total += operator.applyAsDouble(i);
        }
        return total;
    }

    /**
     * Sums the items in an array. This is equivalent to invoking the
     * "plus" method on all items in the array.
     *
     * @param self The array of values to add together
     * @return The sum of all the items
     * @see DefaultGroovyMethods#sum(java.util.Iterator)
     * @since 1.7.1
     */
    public static Object sum(Object[] self) {
        return DefaultGroovyMethods.sum(new ArrayIterator<>(self), null, true);
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert (5+1+2+3+4 as byte) == ([1,2,3,4] as byte[]).sum(5 as byte)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static byte sum(byte[] self, byte initialValue) {
        Objects.requireNonNull(self);
        byte s = initialValue;
        for (byte v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert (5+1+2+3+4 as char) == ([1,2,3,4] as char[]).sum(5 as char)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static char sum(char[] self, char initialValue) {
        Objects.requireNonNull(self);
        char s = initialValue;
        for (char v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert (5+1+2+3+4 as short) == ([1,2,3,4] as short[]).sum(5 as short)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static short sum(short[] self, short initialValue) {
        Objects.requireNonNull(self);
        short s = initialValue;
        for (short v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert 5+1+2+3+4 == ([1,2,3,4] as int[]).sum(5)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static int sum(int[] self, int initialValue) {
        Objects.requireNonNull(self);
        int s = initialValue;
        for (int v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert (5+1+2+3+4 as long) == ([1,2,3,4] as long[]).sum(5)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static long sum(long[] self, long initialValue) {
        Objects.requireNonNull(self);
        long s = initialValue;
        for (long v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert (5+1+2+3+4 as float) == ([1,2,3,4] as float[]).sum(5)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static float sum(float[] self, float initialValue) {
        Objects.requireNonNull(self);
        float s = initialValue;
        for (float v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     * <pre class="language-groovy groovyTestCase">assert (5+1+2+3+4 as double) == ([1,2,3,4] as double[]).sum(5)</pre>
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 2.4.2
     */
    public static double sum(double[] self, double initialValue) {
        Objects.requireNonNull(self);
        double s = initialValue;
        for (double v : self) {
            s += v;
        }
        return s;
    }

    /**
     * Sums the items in an array, adding the result to some initial value.
     *
     * @param self         an array of values to sum
     * @param initialValue the items in the array will be summed to this initial value
     * @return The sum of all the items.
     * @since 1.7.1
     */
    public static Object sum(Object[] self, Object initialValue) {
        return DefaultGroovyMethods.sum(new ArrayIterator<>(self), initialValue, false);
    }

    /**
     * Sums the result of applying a closure to each item of an array.
     * <code>array.sum(closure)</code> is equivalent to:
     * <code>array.collect(closure).sum()</code>.
     *
     * @param self    An array
     * @param closure a single parameter closure that returns a (typically) numeric value.
     * @return The sum of the values returned by applying the closure to each
     *         item of the array.
     * @since 1.7.1
     */
    public static <T> Object sum(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        return DefaultGroovyMethods.sum(new ArrayIterator<>(self), null, closure, true);
    }

    /**
     * Sums the result of applying a closure to each item of an array to some initial value.
     * <code>array.sum(initVal, closure)</code> is equivalent to:
     * <code>array.collect(closure).sum(initVal)</code>.
     *
     * @param self         an array
     * @param closure      a single parameter closure that returns a (typically) numeric value.
     * @param initialValue the closure results will be summed to this initial value
     * @return The sum of the values returned by applying the closure to each
     *         item of the array.
     * @since 1.7.1
     */
    public static <T> Object sum(T[] self, Object initialValue, @ClosureParams(FirstParam.Component.class) Closure<?> closure) {
        return DefaultGroovyMethods.sum(new ArrayIterator<>(self), initialValue, closure, false);
    }

    //--------------------------------------------------------------------------
    // swap

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([false, true, false, true] as boolean[]) == ([false, false, true, true] as boolean[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static boolean[] swap(boolean[] self, int i, int j) {
        Objects.requireNonNull(self);
        boolean tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as byte[]) == ([1, 2, 3, 4] as byte[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static byte[] swap(byte[] self, int i, int j) {
        Objects.requireNonNull(self);
        byte tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as char[]) == ([1, 2, 3, 4] as char[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static char[] swap(char[] self, int i, int j) {
        Objects.requireNonNull(self);
        char tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as short[]) == ([1, 2, 3, 4] as short[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static short[] swap(short[] self, int i, int j) {
        Objects.requireNonNull(self);
        short tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as int[]) == ([1, 2, 3, 4] as int[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static int[] swap(int[] self, int i, int j) {
        Objects.requireNonNull(self);
        int tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as long[]) == ([1, 2, 3, 4] as long[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static long[] swap(long[] self, int i, int j) {
        Objects.requireNonNull(self);
        long tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as float[]) == ([1, 2, 3, 4] as float[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static float[] swap(float[] self, int i, int j) {
        Objects.requireNonNull(self);
        float tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert ([1, 3, 2, 4] as double[]) == ([1, 2, 3, 4] as double[]).swap(1, 2)
     * </pre>
     *
     * @param self a boolean array
     * @param i    a position
     * @param j    a position
     * @return self
     * @since 2.4.0
     */
    public static double[] swap(double[] self, int i, int j) {
        Objects.requireNonNull(self);
        double tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    /**
     * Swaps two elements at the specified positions.
     * <p>
     * Example:
     * <pre class="language-groovy groovyTestCase">
     * assert (["a", "c", "b", "d"] as String[]) == (["a", "b", "c", "d"] as String[]).swap(1, 2)
     * </pre>
     *
     * @param self an array
     * @param i a position
     * @param j a position
     * @return self
     * @since 2.4.0
     */
    public static <T> T[] swap(T[] self, int i, int j) {
        T tmp = self[i];
        self[i] = self[j];
        self[j] = tmp;
        return self;
    }

    //--------------------------------------------------------------------------
    // tail

    /**
     * Returns the items from the boolean array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false, true]
     * def result = array.tail()
     * assert result == [false, true]
     * assert array.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static boolean[] tail(boolean[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the byte array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * byte[] bytes = [1, 2, 3]
     * def result = bytes.tail()
     * assert result == [2, 3]
     * assert bytes.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static byte[] tail(byte[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the char array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * char[] chars = ['a', 'b', 'c']
     * def result = chars.tail()
     * assert result == ['b', 'c']
     * assert chars.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static char[] tail(char[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the short array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * short[] shorts = [10, 20, 30]
     * def result = shorts.tail()
     * assert result == [20, 30]
     * assert shorts.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static short[] tail(short[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the int array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * int[] ints = [1, 3, 5]
     * def result = ints.tail()
     * assert result == [3, 5]
     * assert ints.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static int[] tail(int[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the long array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * long[] longs = [2L, 4L, 6L]
     * def result = longs.tail()
     * assert result == [4L, 6L]
     * assert longs.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static long[] tail(long[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the float array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * float[] floats = [2.0f, 4.0f, 6.0f]
     * def result = floats.tail()
     * assert result == [4.0f, 6.0f]
     * assert floats.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static float[] tail(float[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the double array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * double[] doubles = [10.0d, 20.0d, 30.0d]
     * def result = doubles.tail()
     * assert result == [20.0d, 30.0d]
     * assert doubles.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 5.0.0
     */
    public static double[] tail(double[] self) {
        Objects.requireNonNull(self);
        throwUnsupportedOperationIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    /**
     * Returns the items from the array excluding the first item.
     * <pre class="language-groovy groovyTestCase">
     * String[] strings = ["a", "b", "c"]
     * def result = strings.tail()
     * assert result.class.componentType == String
     * String[] expected = ["b", "c"]
     * assert result == expected
     * </pre>
     *
     * @param self an array
     * @return an array without its first element
     * @throws UnsupportedOperationException if the array is empty
     * @since 1.7.3
     */
    public static <T> T[] tail(T[] self) {
        Objects.requireNonNull(self);
        throwNoSuchElementIfEmpty(self.length, "tail");
        return Arrays.copyOfRange(self, 1, self.length);
    }

    //--------------------------------------------------------------------------
    // take

    /**
     * Returns the first <code>num</code> elements from the head of this array.
     * <pre class="language-groovy groovyTestCase">
     * String[] strings = [ 'a', 'b', 'c' ]
     * assert strings.take( 0 ) == [] as String[]
     * assert strings.take( 2 ) == [ 'a', 'b' ] as String[]
     * assert strings.take( 5 ) == [ 'a', 'b', 'c' ] as String[]
     * </pre>
     *
     * @param self the original array
     * @param num  the number of elements to take from this array
     * @return an array consisting of the first <code>num</code> elements of this array,
     *         or else the whole array if it has less than <code>num</code> elements.
     * @since 1.8.1
     */
    public static <T> T[] take(T[] self, int num) {
        if (self.length == 0 || num <= 0) {
            return createSimilarArray(self, 0);
        }

        if (self.length <= num) {
            T[] ret = createSimilarArray(self, self.length);
            System.arraycopy(self, 0, ret, 0, self.length);
            return ret;
        }

        T[] ret = createSimilarArray(self, num);
        System.arraycopy(self, 0, ret, 0, num);
        return ret;
    }

    //--------------------------------------------------------------------------
    // takeRight

    /**
     * Returns the last <code>num</code> elements from the tail of this array.
     * <pre class="language-groovy groovyTestCase">
     * String[] strings = [ 'a', 'b', 'c' ]
     * assert strings.takeRight( 0 ) == [] as String[]
     * assert strings.takeRight( 2 ) == [ 'b', 'c' ] as String[]
     * assert strings.takeRight( 5 ) == [ 'a', 'b', 'c' ] as String[]
     * </pre>
     *
     * @param self the original array
     * @param num  the number of elements to take from this array
     * @return an array consisting of the last <code>num</code> elements of this array,
     *         or else the whole array if it has less than <code>num</code> elements.
     * @since 2.4.0
     */
    public static <T> T[] takeRight(T[] self, int num) {
        if (self.length == 0 || num <= 0) {
            return createSimilarArray(self, 0);
        }

        if (self.length <= num) {
            T[] ret = createSimilarArray(self, self.length);
            System.arraycopy(self, 0, ret, 0, self.length);
            return ret;
        }

        T[] ret = createSimilarArray(self, num);
        System.arraycopy(self, self.length - num, ret, 0, num);
        return ret;
    }

    //--------------------------------------------------------------------------
    // takeWhile

    /**
     * Returns the longest prefix of this array where each element
     * passed to the given closure evaluates to true.
     * <pre class="language-groovy groovyTestCase">
     * def nums = [ 1, 3, 2 ] as Integer[]
     * assert nums.takeWhile{ it {@code <} 1 } == [] as Integer[]
     * assert nums.takeWhile{ it {@code <} 3 } == [ 1 ] as Integer[]
     * assert nums.takeWhile{ it {@code <} 4 } == [ 1, 3, 2 ] as Integer[]
     * </pre>
     *
     * @param self      the original array
     * @param condition the closure that must evaluate to true to
     *                  continue taking elements
     * @return A prefix of the given array where each element passed to
     *         the given closure evaluates to true.
     * @since 1.8.7
     */
    public static <T> T[] takeWhile(T[] self, @ClosureParams(FirstParam.Component.class) Closure<?> condition) {
        int num = 0;
        BooleanClosureWrapper bcw = new BooleanClosureWrapper(condition);
        while (num < self.length) {
            T value = self[num];
            if (bcw.call(value)) {
                num += 1;
            } else {
                break;
            }
        }
        return take(self, num);
    }

    /**
     * Returns the longest prefix of an array where each element passes the given predicate.
     * A "fat-free" variant of {@link #takeWhile(Object[], Closure)} accepting a {@link Predicate}.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 0, 4]
     * assert nums.takeWhile(n -&gt; n &lt; 3).toList() == [1, 2]
     * </pre>
     *
     * @param self      the original array
     * @param condition the predicate that must evaluate to true to continue taking elements
     * @return a prefix of the given array where each element passes the given predicate
     * @since 6.0.0
     */
    public static <T> T[] takeWhile(T[] self, Predicate<? super T> condition) {
        int num = 0;
        while (num < self.length) {
            T value = self[num];
            if (condition.test(value)) {
                num += 1;
            } else {
                break;
            }
        }
        return take(self, num);
    }

    //--------------------------------------------------------------------------
    // toList

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a boolean array
     * @return A list containing the contents of this array.
     * @since 1.6.0
     */
    @SuppressWarnings("unchecked")
    public static List<Boolean> toList(boolean[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a byte array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Byte> toList(byte[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a char array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Character> toList(char[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a short array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Short> toList(short[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self an int array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Integer> toList(int[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a long array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Long> toList(long[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a float array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Float> toList(float[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self a double array
     * @return A list containing the contents of this array.
     * @since 1.0
     */
    @SuppressWarnings("unchecked")
    public static List<Double> toList(double[] self) {
        return DefaultTypeTransformation.primitiveArrayToList(self);
    }

    /**
     * Converts this array to a List of the same size, with each element
     * added to the list.
     *
     * @param self an object array
     * @return A mutable list containing the contents of this array.
     * @since 1.0
     */
    public static <T> List<T> toList(T[] self) {
        return new ArrayList<>(Arrays.asList(self));
    }

    //--------------------------------------------------------------------------
    // toImmutableList

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a boolean array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Boolean> toImmutableList(boolean[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a byte array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Byte> toImmutableList(byte[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a char array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Character> toImmutableList(char[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a short array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Short> toImmutableList(short[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self an int array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Integer> toImmutableList(int[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a long array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Long> toImmutableList(long[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a float array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Float> toImmutableList(float[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list.
     *
     * @param self a double array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static List<Double> toImmutableList(double[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(toList(self));
    }

    /**
     * Converts this array to an immutable List of the same size, with each
     * element added to the list. Null elements are preserved (unlike
     * {@link List#of(Object[])}, which rejects nulls). The returned list is
     * unmodifiable; mutation attempts throw {@link UnsupportedOperationException}.
     * Returns the canonical empty list ({@link Collections#emptyList()}) when
     * the array is empty.
     * <pre class="language-groovy groovyTestCase">
     * import static groovy.test.GroovyAssert.shouldFail
     * String[] arr = ['a', null, 'b']
     * def list = arr.toImmutableList()
     * assert list == ['a', null, 'b']
     * shouldFail(UnsupportedOperationException) { list &lt;&lt; 'c' }
     * assert (new String[0]).toImmutableList() === Collections.emptyList()
     * </pre>
     *
     * @param self an object array
     * @return An immutable list containing the contents of this array.
     * @since 6.0.0
     */
    public static <T> List<T> toImmutableList(T[] self) {
        if (self.length == 0) return Collections.emptyList();
        return Collections.unmodifiableList(Arrays.asList(self));
    }

    //--------------------------------------------------------------------------
    // toSet

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false, true]
     * Set expected = [true, false]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a boolean array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Boolean> toSet(boolean[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a byte array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Byte> toSet(byte[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'xyzzy'.chars
     * Set expected = ['x', 'y', 'z']
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a char array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Character> toSet(char[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a short array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Short> toSet(short[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self an int array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Integer> toSet(int[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a long array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Long> toSet(long[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [1.0f, 2.0f, 3.0f, 2.0f, 1.0f]
     * Set expected = [1.0f, 2.0f, 3.0f]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a float array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Float> toSet(float[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [1.0d, 2.0d, 3.0d, 2.0d, 1.0d]
     * Set expected = [1.0d, 2.0d, 3.0d]
     * assert array.toSet() == expected
     * </pre>
     *
     * @param self a double array
     * @return A set containing the unique contents of this array.
     * @since 1.8.0
     */
    @SuppressWarnings("unchecked")
    public static Set<Double> toSet(double[] self) {
        return DefaultGroovyMethods.toSet(DefaultTypeTransformation.primitiveArrayToUnmodifiableList(self));
    }

    /**
     * Converts this array to a Set, with each unique element added to the set.
     *
     * @param self an object array
     * @return A set containing the unique contents of this array.
     * @since 5.0.0
     */
    public static <T> Set<T> toSet(T[] self) {
        return DefaultGroovyMethods.toSet(Arrays.asList(self));
    }

    //--------------------------------------------------------------------------
    // toImmutableSet

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [true, false, true]
     * Set expected = [true, false]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a boolean array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Boolean> toImmutableSet(boolean[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a byte array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Byte> toImmutableSet(byte[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'xyzzy'.chars
     * Set expected = ['x', 'y', 'z']
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a char array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Character> toImmutableSet(char[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a short array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Short> toImmutableSet(short[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self an int array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Integer> toImmutableSet(int[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [1, 2, 3, 2, 1]
     * Set expected = [1, 2, 3]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a long array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Long> toImmutableSet(long[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [1.0f, 2.0f, 3.0f, 2.0f, 1.0f]
     * Set expected = [1.0f, 2.0f, 3.0f]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a float array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Float> toImmutableSet(float[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added to the set.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [1.0d, 2.0d, 3.0d, 2.0d, 1.0d]
     * Set expected = [1.0d, 2.0d, 3.0d]
     * assert array.toImmutableSet() == expected
     * </pre>
     *
     * @param self a double array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static Set<Double> toImmutableSet(double[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    /**
     * Converts this array to an immutable Set, with each unique element added
     * to the set. Null elements are preserved (unlike {@link Set#copyOf(java.util.Collection)},
     * which rejects nulls). The returned set is unmodifiable; mutation attempts
     * throw {@link UnsupportedOperationException}. Returns the canonical empty
     * set ({@link Collections#emptySet()}) when the array is empty.
     * <pre class="language-groovy groovyTestCase">
     * import static groovy.test.GroovyAssert.shouldFail
     * String[] arr = ['a', null, 'b', 'a']
     * def set = arr.toImmutableSet()
     * assert set == ['a', null, 'b'] as Set
     * shouldFail(UnsupportedOperationException) { set &lt;&lt; 'c' }
     * assert (new String[0]).toImmutableSet() === Collections.emptySet()
     * </pre>
     *
     * @param self an object array
     * @return An immutable set containing the unique contents of this array.
     * @since 6.0.0
     */
    public static <T> Set<T> toImmutableSet(T[] self) {
        if (self.length == 0) return Collections.emptySet();
        return Collections.unmodifiableSet(toSet(self));
    }

    //--------------------------------------------------------------------------
    // toSorted

    /**
     * Returns a sorted version of the given array using the supplied comparator.
     *
     * @param self the array to be sorted
     * @return the sorted array
     * @see #toSorted(Object[], Comparator)
     * @since 2.4.0
     */
    public static <T> T[] toSorted(T[] self) {
        return toSorted(self, new NumberAwareComparator<>());
    }

    /**
     * Returns a sorted version of the given array using the supplied comparator to determine the resulting order.
     * <pre class="language-groovy groovyTestCase">
     * def sumDigitsComparator = [compare: { num1, num2 {@code ->} num1.toString().toList()*.toInteger().sum() {@code <=>} num2.toString().toList()*.toInteger().sum() }] as Comparator
     * Integer[] nums = [9, 44, 222, 7000]
     * def result = nums.toSorted(sumDigitsComparator)
     * assert result instanceof Integer[]
     * assert result == [222, 7000, 44, 9]
     * </pre>
     *
     * @param self the array to be sorted
     * @param comparator a Comparator used for the comparison
     * @return the sorted array
     * @since 2.4.0
     */
    public static <T> T[] toSorted(T[] self, Comparator<? super T> comparator) {
        T[] answer = self.clone();
        Arrays.sort(answer, comparator);
        return answer;
    }

    /**
     * Sorts the elements from this array into a newly created array using
     * the Closure to determine the correct ordering.
     * <p>
     * If the closure has two parameters it is used like a traditional Comparator. I.e. it should compare
     * its two parameters for order, returning a negative integer, zero, or a positive integer when the
     * first parameter is less than, equal to, or greater than the second respectively. Otherwise,
     * the Closure is assumed to take a single parameter and return a Comparable (typically an Integer)
     * which is then used for further comparison.
     *
     * @param self the array containing the elements to be sorted
     * @param closure a Closure used to determine the correct ordering
     * @return a sorted array
     * @see #toSorted(Object[], Comparator)
     * @since 2.4.0
     */
    public static <T> T[] toSorted(T[] self, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        return sort(self, false, closure);
    }

    //--------------------------------------------------------------------------
    // toSpreadMap

    /**
     * Creates a spreadable map from this array.
     * <p>
     * @param self an object array
     * @return a newly created SpreadMap
     * @see groovy.lang.SpreadMap#SpreadMap(java.lang.Object[])
     * @since 1.0
     */
    public static SpreadMap toSpreadMap(Object[] self) {
        if (self == null)
            throw new GroovyRuntimeException("Fail to convert Object[] to SpreadMap, because it is null.");
        else if (self.length % 2 != 0)
            throw new GroovyRuntimeException("Fail to convert Object[] to SpreadMap, because its size is not even.");
        else
            return new SpreadMap(self);
    }

    //--------------------------------------------------------------------------
    // toString

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * boolean[] array = [false, true, false]
     * assert array.toString() == '[false, true, false]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(boolean[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * byte[] array = [1, 2, 3, 2, 1]
     * assert array.toString() == '[1, 2, 3, 2, 1]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(byte[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * char[] array = 'abcd'.chars
     * assert array instanceof char[]
     * assert array.toString() == 'abcd'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(char[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * short[] array = [1, 2, 3, 2, 1]
     * assert array.toString() == '[1, 2, 3, 2, 1]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(short[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * int[] array = [1, 2, 3, 2, 1]
     * assert array.toString() == '[1, 2, 3, 2, 1]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(int[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * long[] array = [1, 2, 3, 2, 1]
     * assert array.toString() == '[1, 2, 3, 2, 1]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(long[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * float[] array = [1, 2, 3, 2, 1]
     * assert array.toString() == '[1.0, 2.0, 3.0, 2.0, 1.0]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(float[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     * <pre class="language-groovy groovyTestCase">
     * double[] array = [1, 2, 3, 2, 1]
     * assert array.toString() == '[1.0, 2.0, 3.0, 2.0, 1.0]'
     * </pre>
     *
     * @param self an array
     * @return the string representation
     * @since 1.6.0
     */
    public static String toString(double[] self) {
        return FormatHelper.toString(self);
    }

    /**
     * Returns the string representation of the given array.
     *
     * @param self an array
     * @return the string representation
     * @since 1.0
     */
    public static String toString(Object[] self) {
        return FormatHelper.toArrayString(self);
    }

    //--------------------------------------------------------------------------
    // toUnique

    /**
     * Returns a new Array containing the items from the original Array but with duplicates removed using the
     * natural ordering of the items in the array.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['c', 'a', 't', 's', 'a', 't', 'h', 'a', 't']
     * String[] expected = ['c', 'a', 't', 's', 'h']
     * def result = letters.toUnique()
     * assert result == expected
     * assert result.class.componentType == String
     * </pre>
     *
     * @param self an array
     * @return the unique items from the array
     * @since 2.4.0
     */
    public static <T> T[] toUnique(T[] self) {
        return toUnique(self, (Comparator<T>) null);
    }

    /**
     * Returns a new Array containing the items from the original Array but with duplicates removed with the supplied
     * comparator determining which items are unique.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['c', 'a', 't', 's', 'A', 't', 'h', 'a', 'T']
     * String[] lower = ['c', 'a', 't', 's', 'h']
     * class LowerComparator implements Comparator {
     *     int compare(a, b) { a.toLowerCase() {@code <=>} b.toLowerCase() }
     * }
     * assert letters.toUnique(new LowerComparator()) == lower
     * </pre>
     *
     * @param self an array
     * @param comparator a Comparator used to determine unique (equal) items
     *        If {@code null}, the Comparable natural ordering of the elements will be used.
     * @return the unique items from the array
     * @since 2.4.0
     */
    public static <T> T[] toUnique(T[] self, Comparator<? super T> comparator) {
        Collection<T> items = DefaultGroovyMethods.toUnique(new ArrayIterable<>(self), comparator);
        return items.toArray(createSimilarArray(self, items.size()));
    }

    /**
     * Returns a new Array containing the items from the original Array but with duplicates removed with the supplied
     * closure determining which items are unique.
     * <p>
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['c', 'a', 't', 's', 'A', 't', 'h', 'a', 'T']
     * String[] expected = ['c', 'a', 't', 's', 'h']
     * assert letters.toUnique{ p1, p2 {@code ->} p1.toLowerCase() {@code <=>} p2.toLowerCase() } == expected
     * assert letters.toUnique{ it.toLowerCase() } == expected
     * </pre>
     *
     * @param self an array
     * @param closure a Closure used to determine unique items
     * @return the unique items from the array
     * @since 2.4.0
     */
    public static <T> T[] toUnique(T[] self, @ClosureParams(value=FromString.class,options={"T","T,T"}) Closure<?> closure) {
        Comparator<T> comparator = closure.getMaximumNumberOfParameters() == 1
                ? new OrderBy<>(closure, true)
                : new ClosureComparator<>(closure);
        return toUnique(self, comparator);
    }

    //--------------------------------------------------------------------------
    // transpose

    /**
     * A transpose method for 2D boolean arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * boolean[][] array = [[false, false], [true, true]]
     * boolean[][] expected = [[false, true], [false, true]]
     * def result = array.transpose()
     * assert result == expected
     * assert array.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D boolean array
     * @return the transposed 2D boolean array
     * @since 5.0.0
     */
    public static boolean[][] transpose(boolean[][] self) {
        Objects.requireNonNull(self);
        boolean[][] result = new boolean[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D byte arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * byte[][] bytes = [[1, 10], [2, 20]]
     * byte[][] expected = [[1, 2], [10, 20]]
     * def result = bytes.transpose()
     * assert result == expected
     * assert bytes.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D byte array
     * @return the transposed 2D byte array
     * @since 5.0.0
     */
    public static byte[][] transpose(byte[][] self) {
        Objects.requireNonNull(self);
        byte[][] result = new byte[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D char arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * char[][] chars = [['a', 'b'], ['A', 'B']]
     * char[][] expected = [['a', 'A'], ['b', 'B']]
     * def result = chars.transpose()
     * assert result == expected
     * assert chars.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D char array
     * @return the transposed 2D char array
     * @since 5.0.0
     */
    public static char[][] transpose(char[][] self) {
        Objects.requireNonNull(self);
        char[][] result = new char[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D short arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * short[][] shorts = [[1, 10], [100, 1000]]
     * short[][] expected = [[1, 100], [10, 1000]]
     * def result = shorts.transpose()
     * assert result == expected
     * assert shorts.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D short array
     * @return the transposed 2D short array
     * @since 5.0.0
     */
    public static short[][] transpose(short[][] self) {
        Objects.requireNonNull(self);
        short[][] result = new short[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D int arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[][] nums = [[10, 15, 20], [30, 35, 40]]
     * int[][] expected = [[10, 30], [15, 35], [20, 40]]
     * assert nums.transpose() == expected
     * </pre>
     *
     * @param self a 2D int array
     * @return the transposed 2D int array
     * @since 3.0.8
     */
    public static int[][] transpose(int[][] self) {
        Objects.requireNonNull(self);
        int[][] result = new int[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D long arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[][] longs = [[1L, 3L, 5L], [2L, 4L, 6L]]
     * long[][] expected = [[1L, 2L], [3L, 4L], [5L, 6L]]
     * def result = longs.transpose()
     * assert result == expected
     * assert longs.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D long array
     * @return the transposed 2D long array
     * @since 3.0.8
     */
    public static long[][] transpose(long[][] self) {
        Objects.requireNonNull(self);
        long[][] result = new long[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D float arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[][] floats = [[1.0f, 10.0f], [2.0f, 20.0f]]
     * float[][] expected = [[1.0f, 2.0f], [10.0f, 20.0f]]
     * def result = floats.transpose()
     * assert result == expected
     * assert floats.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D float array
     * @return the transposed 2D float array
     * @since 5.0.0
     */
    public static float[][] transpose(float[][] self) {
        Objects.requireNonNull(self);
        float[][] result = new float[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    /**
     * A transpose method for 2D double arrays.
     * <p>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[][] doubles = [[1.0d, 10.0d], [2.0d, 20.0d]]
     * double[][] expected = [[1.0d, 2.0d], [10.0d, 20.0d]]
     * def result = doubles.transpose()
     * assert result == expected
     * assert doubles.class.componentType == result.class.componentType
     * </pre>
     *
     * @param self a 2D double array
     * @return the transposed 2D double array
     * @since 3.0.8
     */
    public static double[][] transpose(double[][] self) {
        Objects.requireNonNull(self);
        double[][] result = new double[self[0].length][self.length];
        for (int i = 0; i < self.length; i++) {
            for (int j = 0; j < self[i].length; j++) {
                result[j][i] = self[i][j];
            }
        }
        return result;
    }

    //--------------------------------------------------------------------------
    // transposing

    /**
     * An iterator of the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * double[][] nums = [[1.0d, 2.0d], [10.0d, 20.0d]]
     * assert nums.transpose() == nums.transposing().toList()
     * </pre>
     *
     * @param self a double[][]
     * @return the iterator
     * @since 5.0.0
     */
    public static Iterator<double[]> transposing(double[][] self) {
        return new DoubleDoubleArrayColumnIterator(self);
    }

    /**
     * An iterator of the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * float[][] nums = [[1.0f, 2.0f], [10.0f, 20.0f]]
     * assert nums.transpose() == nums.transposing().toList()
     * </pre>
     *
     * @param self a float[][]
     * @return the iterator
     * @since 5.0.0
     */
    public static Iterator<float[]> transposing(float[][] self) {
        return new FloatFloatArrayColumnIterator(self);
    }

    /**
     * An iterator of the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * int[][] nums = [[1, 2], [10, 20]]
     * assert nums.transpose() == nums.transposing().toList()
     * assert nums.transposing().collect{ int[] col -> col.sum() } == [11, 22]
     * </pre>
     *
     * @param self an int[][]
     * @return the iterator
     * @since 5.0.0
     */
    public static Iterator<int[]> transposing(int[][] self) {
        return new IntIntArrayColumnIterator(self);
    }

    /**
     * An iterator of the columns of the array.
     * <pre class="language-groovy groovyTestCase">
     * long[][] nums = [[1L, 2L], [10L, 20L]]
     * assert nums.transpose() == nums.transposing().toList()
     * assert nums.transposing().collect{ long[] col -> col.sum() } == [11L, 22L]
     * </pre>
     *
     * @param self a long[][]
     * @return the iterator
     * @since 5.0.0
     */
    public static Iterator<long[]> transposing(long[][] self) {
        return new LongLongArrayColumnIterator(self);
    }

    //--------------------------------------------------------------------------
    // union

    /**
     * Creates an object array containing elements from an original array plus those from a Collection.
     * This is similar to {@link #plus(Object[], Collection)} but always return an Object array
     * and so might be more applicable when adding heterogeneous arrays.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] a = [1, 2, 3]
     * def result = a.union(['foo', 'bar'])
     * assert result.class == Object[]
     * assert result == new Object[]{1, 2, 3, 'foo', 'bar'}
     * </pre>
     *
     * @param left  the array
     * @param right a Collection to be appended
     * @return A new Object array containing left with right appended to it.
     * @since 4.0.0
     */
    public static Object[] union(Object[] left, Collection<?> right) {
        Object[] result = new Object[left.length + right.size()];
        System.arraycopy(left, 0, result, 0, left.length);
        int i = left.length;
        for (Object t : right) {
            result[i] = t;
            i += 1;
        }
        return result;
    }

    /**
     * Creates an Object array containing elements from an original array plus those from an Iterable.
     * This is similar to {@link #plus(Object[], Iterable)} but always return an Object array
     * and so might be more applicable when adding heterogeneous arrays.
     * <pre class="language-groovy groovyTestCase">
     * class AbcIterable implements Iterable<String> {
     *     Iterator<String> iterator() { "abc".iterator() }
     * }
     * String[] array = ['x', 'y', 'z']
     * def result = array.union(new AbcIterable())
     * assert result.class == Object[]
     * assert result == new Object[]{'x', 'y', 'z', 'a', 'b', 'c'}
     * </pre>
     *
     * @param left  the array
     * @param right an Iterable to be appended
     * @return A new Object array containing elements from left with those from right appended.
     * @since 4.0.0
     */
    public static Object[] union(Object[] left, Iterable<?> right) {
        return union(left, DefaultGroovyMethods.toList(right));
    }

    /**
     * Creates an Object array as a union of two arrays.
     * This is similar to {@link #plus(Object[], Object[])} but always return an Object array
     * and so might be more applicable when adding heterogeneous arrays.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] a = [1, 2, 3]
     * String[] b = ['foo', 'bar']
     * def result = a.union(b)
     * assert result.class == Object[]
     * assert result == new Object[]{1, 2, 3, 'foo', 'bar'}
     * </pre>
     *
     * @param left  the left Array
     * @param right the right Array
     * @return A new Object array containing right appended to left.
     * @since 4.0.0
     */
    public static Object[] union(Object[] left, Object[] right) {
        Object[] result = new Object[left.length + right.length];
        System.arraycopy(left, 0, result, 0, left.length);
        System.arraycopy(right, 0, result, left.length, right.length);
        return result;
    }

    /**
     * Creates an Object array containing elements from an original array plus an additional appended element.
     * This is similar to {@link #plus(Object[], Object)} but always return an Object array
     * and so might be more applicable when adding heterogeneous arrays.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] a = [1, 2, 3]
     * def result = a.union('foo')
     * assert result.class == Object[]
     * assert result == new Object[]{1, 2, 3, 'foo'}
     * </pre>
     *
     * @param left  the array
     * @param right the value to append
     * @return A new Object array containing left with right appended to it.
     * @since 4.0.0
     */
    public static Object[] union(Object[] left, Object right) {
        Object[] result = new Object[left.length + 1];
        System.arraycopy(left, 0, result, 0, left.length);
        result[left.length] = right;
        return result;
    }

    //--------------------------------------------------------------------------
    // withCollectedKeys

    /**
     * A variant of withCollectedKeys for arrays.
     *
     * @param values       an array
     * @param keyTransform a function for transforming array elements into values
     * @return the collector with all transformed values added to it
     * @see DefaultGroovyMethods#withCollectedKeys(Iterable, Function)
     * @since 5.0.0
     */
    public static <K, V> Map<K, V> withCollectedKeys(V[] values, Function<? super V, K> keyTransform) {
        return DefaultGroovyMethods.withCollectedKeys(new ArrayIterator<>(values), new LinkedHashMap<>(), keyTransform);
    }

    /**
     * A variant of withCollectedKeys for arrays.
     *
     * @param values       an array
     * @param collector    the Map into which the transformed entries are put
     * @param keyTransform a function for transforming array elements into values
     * @return the collector with all transformed values added to it
     * @see DefaultGroovyMethods#withCollectedKeys(Iterable, Map, Function)
     * @since 5.0.0
     */
    public static <K, V> Map<K, V> withCollectedKeys(V[] values, Map<K, V> collector, Function<? super V, K> keyTransform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterator<>(values), collector, keyTransform, Function.identity());
    }

    //--------------------------------------------------------------------------
    // withCollectedValues

    /**
     * A variant of withCollectedValues for arrays.
     *
     * @param keys           an array
     * @param valueTransform a function for transforming array elements into values
     * @return A map of the transformed entries.
     * @since 5.0.0
     */
    public static <K, V> Map<K, V> withCollectedValues(K[] keys, Function<? super K, V> valueTransform) {
        return DefaultGroovyMethods.withCollectedValues(new ArrayIterator<>(keys), new LinkedHashMap<>(), valueTransform);
    }

    /**
     * A variant of withCollectedValues for arrays.
     *
     * @param keys           an array
     * @param collector      the Map into which the transformed entries are put
     * @param valueTransform a function for transforming array elements into values
     * @return The collector with all transformed values added to it.
     * @since 5.0.0
     */
    public static <K, V> Map<K, V> withCollectedValues(K[] keys, Map<K, V> collector, Function<? super K, V> valueTransform) {
        return DefaultGroovyMethods.collectEntries(new ArrayIterator<>(keys), collector, Function.identity(), valueTransform);
    }

    //--------------------------------------------------------------------------
    // withIndex

    /**
     * Zips an int array with indices in (value, index) order.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [42, -1]
     * assert [[42, 0], [-1, 1]] == nums.withIndex()
     * assert ["0: 42", "1: -1"] == nums.withIndex().collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self an int array
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Integer, Integer>> withIndex(int[] self) {
        return withIndex(self, 0);
    }

    /**
     * Zips an int array with indices in (value, index) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * int[] nums = [42, -1]
     * assert [[42, 5], [-1, 6]] == nums.withIndex(5)
     * assert ["5: 42", "6: -1"] == nums.withIndex(5).collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self an int array
     * @param offset an index to start from
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable, int)
     * @since 5.0.0
     */
    public static List<Tuple2<Integer, Integer>> withIndex(int[] self, int offset) {
        return DefaultGroovyMethods.withIndex(new IntArrayIterable(self), offset);
    }

    /**
     * Zips a long array with indices in (value, index) order.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [42L, -1L]
     * assert [[42L, 0], [-1L, 1]] == nums.withIndex()
     * assert ["0: 42", "1: -1"] == nums.withIndex().collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self a long array
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Long, Integer>> withIndex(long[] self) {
        return withIndex(self, 0);
    }

    /**
     * Zips a long array with indices in (value, index) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * long[] nums = [42L, -1L]
     * assert [[42L, 5], [-1L, 6]] == nums.withIndex(5)
     * assert ["5: 42", "6: -1"] == nums.withIndex(5).collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self a long array
     * @param offset an index to start from
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Long, Integer>> withIndex(long[] self, int offset) {
        return DefaultGroovyMethods.withIndex(new LongArrayIterable(self), offset);
    }

    /**
     * Zips a float array with indices in (value, index) order.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [42.0f, -1.0f]
     * assert [[42.0f, 0], [-1.0f, 1]] == nums.withIndex()
     * assert ["0: 42.0", "1: -1.0"] == nums.withIndex().collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self a float array
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Float, Integer>> withIndex(float[] self) {
        return withIndex(self, 0);
    }

    /**
     * Zips a float array with indices in (value, index) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * float[] nums = [42.0f, -1.0f]
     * assert [[42.0f, 5], [-1.0f, 6]] == nums.withIndex(5)
     * assert ["5: 42.0", "6: -1.0"] == nums.withIndex(5).collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self a float array
     * @param offset an index to start from
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Float, Integer>> withIndex(float[] self, int offset) {
        return DefaultGroovyMethods.withIndex(new FloatArrayIterable(self), offset);
    }

    /**
     * Zips a double array with indices in (value, index) order.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [42.0d, -1.0d]
     * assert [[42.0d, 0], [-1.0d, 1]] == nums.withIndex()
     * assert ["0: 42.0", "1: -1.0"] == nums.withIndex().collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self a double array
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Double, Integer>> withIndex(double[] self) {
        return withIndex(self, 0);
    }

    /**
     * Zips a double array with indices in (value, index) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * double[] nums = [42.0d, -1.0d]
     * assert [[42.0d, 5], [-1.0d, 6]] == nums.withIndex(5)
     * assert ["5: 42.0", "6: -1.0"] == nums.withIndex(5).collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self a double array
     * @param offset an index to start from
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static List<Tuple2<Double, Integer>> withIndex(double[] self, int offset) {
        return DefaultGroovyMethods.withIndex(new DoubleArrayIterable(self), offset);
    }

    /**
     * Zips an object array with indices in (value, index) order.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['a', 'z']
     * assert [['a', 0], ['z', 1]] == letters.withIndex()
     * </pre>
     *
     * @param self an object array
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable)
     * @since 5.0.0
     */
    public static <T> List<Tuple2<T, Integer>> withIndex(T[] self) {
        return withIndex(self, 0);
    }

    /**
     * Zips an object array with indices in (value, index) order starting from a given index.
     * <p/>
     * Example usage:
     * <pre class="language-groovy groovyTestCase">
     * String[] letters = ['a', 'z']
     * assert [['a', 5], ['z', 6]] == letters.withIndex(5)
     * assert ["5: a", "6: z"] == letters.withIndex(5).collect { n, idx {@code ->} "$idx: $n" }
     * </pre>
     *
     * @param self an object array
     * @param offset an index to start from
     * @return a zipped list with indices
     * @see DefaultGroovyMethods#withIndex(Iterable, int)
     * @since 5.0.0
     */
    public static <T> List<Tuple2<T, Integer>> withIndex(T[] self, int offset) {
        return DefaultGroovyMethods.withIndex(new ArrayIterable<>(self), offset);
    }

    //--------------------------------------------------------------------------
    // zip

    /**
     * A list of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * double[] small = [1.0d, 2.0d, 3.0d]
     * double[] large = [100d, 200d, 300d]
     * assert [small, large].transpose() == small.zip(large)
     * </pre>
     *
     * @param self a double[]
     * @param other another double[]
     * @return a list of all the pairs from self and other
     * @since 5.0.0
     */
    public static List<Tuple2<Double, Double>> zip(double[] self, double[] other) {
        return DefaultGroovyMethods.zip(new DoubleArrayIterable(self), new DoubleArrayIterable(other));
    }

    /**
     * An iterator of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * double[] small = [1.0d, 2.0d, 3.0d]
     * double[] large = [100d, 200d, 300d]
     * assert [small, large].transpose() == small.zipping(large).toList()
     * </pre>
     *
     * @param self a double[]
     * @param other another double[]
     * @return an iterator of all the pairs from self and other
     * @since 5.0.0
     */
    public static Iterator<Tuple2<Double, Double>> zipping(double[] self, double[] other) {
        return DefaultGroovyMethods.zip(new DoubleArrayIterator(self), new DoubleArrayIterator(other));
    }

    /**
     * A list of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * float[] small = [1.0f, 2.0f, 3.0f]
     * float[] large = [100f, 200f, 300f]
     * assert [small, large].transpose() == small.zip(large)
     * </pre>
     *
     * @param self a float[]
     * @param other another float[]
     * @return a list of all the pairs from self and other
     * @since 5.0.0
     */
    public static List<Tuple2<Float, Float>> zip(float[] self, float[] other) {
        return DefaultGroovyMethods.zip(new FloatArrayIterable(self), new FloatArrayIterable(other));
    }

    /**
     * An iterator of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * float[] small = [1.0f, 2.0f, 3.0f]
     * float[] large = [100f, 200f, 300f]
     * assert [small, large].transpose() == small.zipping(large).toList()
     * </pre>
     *
     * @param self a float[]
     * @param other another float[]
     * @return an iterator of all the pairs from self and other
     * @since 5.0.0
     */
    public static Iterator<Tuple2<Float, Float>> zipping(float[] self, float[] other) {
        return DefaultGroovyMethods.zip(new FloatArrayIterator(self), new FloatArrayIterator(other));
    }

    /**
     * A list of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * int[] small = [1, 2, 3]
     * int[] large = [100, 200, 300]
     * assert [101, 202, 303] == small.zip(large).collect{ a, b -> a + b }
     * assert [small, large].transpose() == small.zip(large)
     * </pre>
     *
     * @param self an int[]
     * @param other another int[]
     * @return a list of all the pairs from self and other
     * @since 5.0.0
     */
    public static List<Tuple2<Integer, Integer>> zip(int[] self, int[] other) {
        return DefaultGroovyMethods.zip(new IntArrayIterable(self), new IntArrayIterable(other));
    }

    /**
     * An iterator of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * int[] small = [1, 2, 3]
     * int[] large = [100, 200, 300]
     * assert [101, 202, 303] == small.zipping(large).collect{ a, b -> a + b }
     * assert [small, large].transpose() == small.zipping(large).toList()
     * </pre>
     *
     * @param self an int[]
     * @param other another int[]
     * @return an iterator of all the pairs from self and other
     * @since 5.0.0
     */
    public static Iterator<Tuple2<Integer, Integer>> zipping(int[] self, int[] other) {
        return DefaultGroovyMethods.zip(new IntArrayIterator(self), new IntArrayIterator(other));
    }

    /**
     * A list of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * long[] small = [1L, 2L, 3L]
     * long[] large = [100L, 200L, 300L]
     * assert [101L, 202L, 303L] == small.zip(large).collect{ a, b -> a + b }
     * assert [small, large].transpose() == small.zip(large)
     * </pre>
     *
     * @param self a long[]
     * @param other another long[]
     * @return a list of all the pairs from self and other
     * @since 5.0.0
     */
    public static List<Tuple2<Long, Long>> zip(long[] self, long[] other) {
        return DefaultGroovyMethods.zip(new LongArrayIterable(self), new LongArrayIterable(other));
    }

    /**
     * An iterator of all the pairs from two arrays.
     * <pre class="language-groovy groovyTestCase">
     * long[] small = [1L, 2L, 3L]
     * long[] large = [100L, 200L, 300L]
     * assert [101L, 202L, 303L] == small.zipping(large).collect{ a, b -> a + b }
     * assert [small, large].transpose() == small.zipping(large).toList()
     * </pre>
     *
     * @param self a long[]
     * @param other another long[]
     * @return an iterator of all the pairs from self and other
     * @since 5.0.0
     */
    public static Iterator<Tuple2<Long, Long>> zipping(long[] self, long[] other) {
        return DefaultGroovyMethods.zip(new LongArrayIterator(self), new LongArrayIterator(other));
    }

    //--------------------------------------------------------------------------
    // groupConsecutive

    /**
     * Splits this array into a list of sublists, each a maximal run of
     * adjacent elements considered equal (number-aware coercion).
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 1, 2, 2, 2, 3, 1, 1]
     * assert nums.groupConsecutive() == [[1, 1], [2, 2, 2], [3], [1, 1]]
     * </pre>
     *
     * @param self an array
     * @return a list of the runs of adjacent equal elements
     * @see DefaultGroovyMethods#groupConsecutive(Iterable)
     * @since 6.0.0
     */
    public static <T> List<List<T>> groupConsecutive(T[] self) {
        return DefaultGroovyMethods.groupConsecutive(new ArrayIterable<>(self));
    }

    /**
     * Splits this array into runs of adjacent elements whose key, as computed
     * by the given function, is equal (number-aware coercion).
     * <pre class="language-groovy groovyTestCase">
     * String[] fruit = ['apple', 'avocado', 'banana', 'cherry', 'citrus', 'date']
     * assert fruit.groupConsecutive{ it[0] } == [['apple', 'avocado'], ['banana'], ['cherry', 'citrus'], ['date']]
     * </pre>
     *
     * @param self an array
     * @param keyFn extracts the grouping key for each element
     * @return a list of the runs of adjacent key-equal elements
     * @see DefaultGroovyMethods#groupConsecutive(Iterable, java.util.function.Function)
     * @since 6.0.0
     */
    public static <T, K> List<List<T>> groupConsecutive(T[] self, Function<? super T, ? extends K> keyFn) {
        return DefaultGroovyMethods.groupConsecutive(new ArrayIterable<>(self), keyFn);
    }

    /**
     * Splits this array into runs where the given predicate, applied to the
     * current run's previous element and the next element, holds. Use this to
     * opt out of the default number-aware equality.
     * <pre class="language-groovy groovyTestCase">
     * Number[] ns = [1, 1L, 1.0, 2, 2]
     * assert ns.groupConsecutive{ a, b {@code ->} a.equals(b) } == [[1], [1L], [1.0], [2, 2]]
     * </pre>
     *
     * @param self an array
     * @param sameRun tests whether the next element continues the current run
     * @return a list of the runs
     * @see DefaultGroovyMethods#groupConsecutive(Iterable, java.util.function.BiPredicate)
     * @since 6.0.0
     */
    public static <T> List<List<T>> groupConsecutive(T[] self, BiPredicate<? super T, ? super T> sameRun) {
        return DefaultGroovyMethods.groupConsecutive(new ArrayIterable<>(self), sameRun);
    }

    //--------------------------------------------------------------------------
    // zipWithNext

    /**
     * Returns a list of all the successive adjacent pairs from this array
     * (a sliding window of size 2, step 1).
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4]
     * assert nums.zipWithNext() == [[1, 2], [2, 3], [3, 4]]
     * </pre>
     *
     * @param self an array
     * @return a list of the adjacent pairs
     * @see DefaultGroovyMethods#zipWithNext(Iterable)
     * @since 6.0.0
     */
    public static <T> List<Tuple2<T, T>> zipWithNext(T[] self) {
        return DefaultGroovyMethods.zipWithNext(new ArrayIterable<>(self));
    }

    /**
     * Applies the combiner to each successive adjacent pair from this array,
     * returning the list of results.
     * <pre class="language-groovy groovyTestCase">
     * Integer[] nums = [1, 2, 3, 4]
     * assert nums.zipWithNext{ a, b {@code ->} b - a } == [1, 1, 1]
     * String[] letters = ['a', 'b', 'c', 'd']
     * assert letters.zipWithNext{ a, b {@code ->} a + b } == ['ab', 'bc', 'cd']
     * </pre>
     *
     * @param self an array
     * @param combiner a function applied to each adjacent pair
     * @return a list of the combined adjacent pairs
     * @see DefaultGroovyMethods#zipWithNext(Iterable, java.util.function.BiFunction)
     * @since 6.0.0
     */
    public static <T, R> List<R> zipWithNext(T[] self, BiFunction<? super T, ? super T, ? extends R> combiner) {
        return DefaultGroovyMethods.zipWithNext(new ArrayIterable<>(self), combiner);
    }

    //--------------------------------------------------------------------------

    /**
     * Implements the getAt(int) method for primitive type arrays.
     *
     * @param self an array object
     * @param index  the index of interest
     * @return the returned value from the array
     * @since 1.5.0
     */
    private static Object primitiveArrayGet(final Object self, final int index) {
        return Array.get(self, normaliseIndex(index, Array.getLength(self)));
    }

    /**
     * Implements the getAt(Range) method for primitive type arrays.
     *
     * @param self  an array object
     * @param range the range of indices of interest
     * @return the returned values from the array corresponding to the range
     * @since 1.5.0
     */
    @SuppressWarnings({"unchecked", "rawtypes"})
    private static List primitiveArrayGet(final Object self, final Range range) {
        List answer = new ArrayList<>();
        for (Object next : range) {
            int idx = DefaultTypeTransformation.intUnbox(next);
            answer.add(primitiveArrayGet(self, idx));
        }
        return answer;
    }

    /**
     * Implements the getAt(Collection) method for primitive type arrays.  Each
     * value in the collection argument is assumed to be a valid array index.
     * The value at each index is then added to a list which is returned.
     *
     * @param self    an array object
     * @param indices the indices of interest
     * @return the returned values from the array
     * @since 1.0
     */
    @SuppressWarnings({"unchecked", "rawtypes"})
    private static List primitiveArrayGet(final Object self, final Collection indices) {
        List answer = new ArrayList<>();
        for (Object value : indices) {
            if (value instanceof Range) {
                answer.addAll(primitiveArrayGet(self, (Range) value));
            } else if (value instanceof List) {
                answer.addAll(primitiveArrayGet(self, (List) value));
            } else {
                int idx = DefaultTypeTransformation.intUnbox(value);
                answer.add(primitiveArrayGet(self, idx));
            }
        }
        return answer;
    }

    private static void throwNoSuchElementIfEmpty(final int size, final String method) {
        if (size == 0) {
            throw new NoSuchElementException("Cannot access " + method + "() for an empty array");
        }
    }

    private static void throwUnsupportedOperationIfEmpty(final int size, final String method) {
        if (size == 0) {
            throw new UnsupportedOperationException("Accessing " + method + "() is unsupported for an empty array");
        }
    }
}
