/*
 * Copyright 2010-2024 JetBrains s.r.o. and Kotlin Programming Language contributors.
 * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
 */

// Auto-generated file. DO NOT EDIT!
// Generated by org.jetbrains.kotlin.generators.builtins.arrays.GenerateWasmArrays

@file:Suppress("UNUSED_PARAMETER")

package kotlin

import kotlin.wasm.internal.*

/**
 * A generic array of objects.
 * Array instances can be created using the [arrayOf], [arrayOfNulls] and [emptyArray]
 * standard library functions.
 *
 * See [Kotlin language documentation](https://kotlinlang.org/docs/arrays.html)
 * for more information on arrays.
 */
public actual class Array<T>
@PublishedApi
internal constructor(size: Int) {
    /**
     * Creates a new array of the specified [size], where each element is calculated by calling the specified
     * [init] function.
     *
     * The function [init] is called for each array element sequentially starting from the first one.
     * It should return the value for an array element given its index.
     *
     * @throws RuntimeException if the specified [size] is negative.
     */
    @Suppress("WRONG_MODIFIER_TARGET", "TYPE_PARAMETER_AS_REIFIED")
    public actual inline constructor(size: Int, init: (Int) -> T) : this(size)

    internal val storage: WasmAnyArray

    init {
        if (size < 0) throw IllegalArgumentException("Negative array size")
        storage = WasmAnyArray(size)
    }

    @WasmPrimitiveConstructor
    @Suppress("PRIMARY_CONSTRUCTOR_DELEGATION_CALL_EXPECTED")
    internal constructor(storage: WasmAnyArray)

    /**
     * Returns the array element at the given [index].
     *
     * This method can be called using the index operator:
     * ```
     * value = array[index]
     * ```
     *
     * If the [index] is out of bounds of this array, a [trap](https://webassembly.github.io/spec/core/intro/overview.html#trap) will be raised
     * unless `-Xwasm-enable-array-range-checks` compiler flag was specified when linking an executable.
     * With the `-Xwasm-enable-array-range-checks` an [IndexOutOfBoundsException] will be thrown.
     */
    public actual operator fun get(index: Int): T {
        rangeCheck(index, storage.len())
        @Suppress("UNCHECKED_CAST") return storage.get(index) as T
    }

    /**
     * Sets the array element at the given [index] to the given [value].
     *
     * This method can be called using the index operator:
     * ```
     * array[index] = value
     * ```
     *
     * If the [index] is out of bounds of this array, a [trap](https://webassembly.github.io/spec/core/intro/overview.html#trap) will be raised
     * unless `-Xwasm-enable-array-range-checks` compiler flag was specified when linking an executable.
     * With the `-Xwasm-enable-array-range-checks` an [IndexOutOfBoundsException] will be thrown.
     */
    public actual operator fun set(index: Int, value: T): Unit {
        rangeCheck(index, storage.len())
        storage.set(index, value)
    }

    /**
     * Returns the number of elements in the array.
     */
    public actual val size: Int
        get() = storage.len()

    /** Creates an [Iterator] for iterating over the elements of the array. */
    public actual operator fun iterator(): Iterator<T> =
        ArrayIterator(this)
}

private class ArrayIterator<T> constructor(val array: Array<T>) : Iterator<T> {
    private var index = 0
    override fun hasNext() = index < array.size
    override fun next() = if (index < array.size) array[index++] else throw NoSuchElementException("$index")
}
