voku / Arrayy

     * @psalm-return static<TKey,T>

     * @psalm-mutation-free

     */

    public function invoke($callable, $arguments = []): self

    {

        // If one argument given for each iteration, create an array for it.

        if (\is_array($arguments) === false) {

            $arguments = \array_fill(

                0,

                $this->count(),

                $arguments

            );

        }

        // If the callable has arguments, pass them.

        if ($arguments) {

            $array = \array_map($callable, $this->toArray(), $arguments);

        } else {

            $array = $this->map($callable);

        }

        return static::create(

            $array,

            $this->iteratorClass,

            false

        );

    }

    /**

     * Check whether array is associative or not.

     * @psalm-return static<int|TKey,T>

     * @psalm-mutation-free

     */

    public function mergeAppendKeepIndex(array $array = [], bool $recursive = false): self

    {

        if ($recursive === true) {

            $array = $this->getArrayRecursiveHelperArrayy($array);

            $result = \array_replace_recursive($this->toArray(), $array);

        } else {

            $result = \array_replace($this->toArray(), $array);

        }

        return static::create(

            $result,

            $this->iteratorClass,

            false

        );

    }

    /**

     * Merge the new $array into the current array.

     * @psalm-return static<TKey,T>

     * @psalm-mutation-free

     */

    public function mergeAppendNewIndex(array $array = [], bool $recursive = false): self

    {

        if ($recursive === true) {

            $array = $this->getArrayRecursiveHelperArrayy($array);

            $result = \array_merge_recursive($this->toArray(), $array);

        } else {

            $result = \array_merge($this->toArray(), $array);

        }

        return static::create(

            $result,

            $this->iteratorClass,

            false

        );

    }

    /**

     * Merge the the current array into the $array.

     * @psalm-return static<TKey,T>

     * @psalm-mutation-free

     */

    public function mergePrependKeepIndex(array $array = [], bool $recursive = false): self

    {

        if ($recursive === true) {

            $array = $this->getArrayRecursiveHelperArrayy($array);

            $result = \array_replace_recursive($array, $this->toArray());

        } else {

            $result = \array_replace($array, $this->toArray());

        }

        return static::create(

            $result,

            $this->iteratorClass,

            false

        );

    }

    /**

     * Merge the current array into the new $array.

     * @psalm-return static<TKey,T>

     * @psalm-mutation-free

     */

    public function mergePrependNewIndex(array $array = [], bool $recursive = false): self

    {

        if ($recursive === true) {

            $array = $this->getArrayRecursiveHelperArrayy($array);

            $result = \array_merge_recursive($array, $this->toArray());

        } else {

            $result = \array_merge($array, $this->toArray());

        }

        return static::create(

            $result,

            $this->iteratorClass,

            false

        );

    }

    /**

     * @return ArrayyMeta|static