copyOf

inline fun UIntArray.copyOf(): UIntArray
inline fun ULongArray.copyOf(): ULongArray
inline fun UByteArray.copyOf(): UByteArray
inline fun UShortArray.copyOf(): UShortArray

Returns new array which is a copy of the original array.

Since Kotlin

1.3

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopy = array.copyOf()
assertPrints(arrayCopy.contentToString(), "[apples, oranges, limes]") 
   //sampleEnd
}

inline fun UIntArray.copyOf(newSize: Int): UIntArray
inline fun ULongArray.copyOf(newSize: Int): ULongArray
inline fun UByteArray.copyOf(newSize: Int): UByteArray
inline fun UShortArray.copyOf(newSize: Int): UShortArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with zero values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with zero values.

Since Kotlin

1.3

expect fun <T> Array<T>.copyOf(): Array<T>
expect fun ByteArray.copyOf(): ByteArray
expect fun ShortArray.copyOf(): ShortArray
expect fun IntArray.copyOf(): IntArray
expect fun LongArray.copyOf(): LongArray
expect fun FloatArray.copyOf(): FloatArray
expect fun DoubleArray.copyOf(): DoubleArray
expect fun BooleanArray.copyOf(): BooleanArray
expect fun CharArray.copyOf(): CharArray

Returns new array which is a copy of the original array.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopy = array.copyOf()
assertPrints(arrayCopy.contentToString(), "[apples, oranges, limes]") 
   //sampleEnd
}

expect fun ByteArray.copyOf(newSize: Int): ByteArray
expect fun ShortArray.copyOf(newSize: Int): ShortArray
expect fun IntArray.copyOf(newSize: Int): IntArray
expect fun LongArray.copyOf(newSize: Int): LongArray
expect fun FloatArray.copyOf(newSize: Int): FloatArray
expect fun DoubleArray.copyOf(newSize: Int): DoubleArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with zero values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with zero values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

expect fun BooleanArray.copyOf(newSize: Int): BooleanArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with false values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with false values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

expect fun CharArray.copyOf(newSize: Int): CharArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null char (\u0000) values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null char (\u0000) values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

expect fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[apples, oranges, limes, null, null]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[apples, oranges]") 
   //sampleEnd
}
actual inline fun <T> Array<T>.copyOf(): Array<T>
actual inline fun ByteArray.copyOf(): ByteArray
actual inline fun ShortArray.copyOf(): ShortArray
actual inline fun IntArray.copyOf(): IntArray
actual inline fun LongArray.copyOf(): LongArray
actual inline fun FloatArray.copyOf(): FloatArray
actual inline fun DoubleArray.copyOf(): DoubleArray
actual inline fun BooleanArray.copyOf(): BooleanArray
actual inline fun CharArray.copyOf(): CharArray

Returns new array which is a copy of the original array.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopy = array.copyOf()
assertPrints(arrayCopy.contentToString(), "[apples, oranges, limes]") 
   //sampleEnd
}

actual inline fun ByteArray.copyOf(newSize: Int): ByteArray
actual inline fun ShortArray.copyOf(newSize: Int): ShortArray
actual inline fun IntArray.copyOf(newSize: Int): IntArray
actual inline fun LongArray.copyOf(newSize: Int): LongArray
actual inline fun FloatArray.copyOf(newSize: Int): FloatArray
actual inline fun DoubleArray.copyOf(newSize: Int): DoubleArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with zero values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with zero values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual inline fun BooleanArray.copyOf(newSize: Int): BooleanArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with false values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with false values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual inline fun CharArray.copyOf(newSize: Int): CharArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null char (\u0000) values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null char (\u0000) values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual inline fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[apples, oranges, limes, null, null]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[apples, oranges]") 
   //sampleEnd
}
actual inline fun <T> Array<T>.copyOf(): Array<T>
actual inline fun ByteArray.copyOf(): ByteArray
actual inline fun ShortArray.copyOf(): ShortArray
actual inline fun IntArray.copyOf(): IntArray
actual fun LongArray.copyOf(): LongArray
actual inline fun FloatArray.copyOf(): FloatArray
actual inline fun DoubleArray.copyOf(): DoubleArray
actual fun BooleanArray.copyOf(): BooleanArray
actual fun CharArray.copyOf(): CharArray

Returns new array which is a copy of the original array.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopy = array.copyOf()
assertPrints(arrayCopy.contentToString(), "[apples, oranges, limes]") 
   //sampleEnd
}

actual fun ByteArray.copyOf(newSize: Int): ByteArray
actual fun ShortArray.copyOf(newSize: Int): ShortArray
actual fun IntArray.copyOf(newSize: Int): IntArray
actual fun LongArray.copyOf(newSize: Int): LongArray
actual fun FloatArray.copyOf(newSize: Int): FloatArray
actual fun DoubleArray.copyOf(newSize: Int): DoubleArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with zero values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with zero values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual fun BooleanArray.copyOf(newSize: Int): BooleanArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with false values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with false values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual fun CharArray.copyOf(newSize: Int): CharArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null char (\u0000) values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null char (\u0000) values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[apples, oranges, limes, null, null]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[apples, oranges]") 
   //sampleEnd
}
actual fun <T> Array<T>.copyOf(): Array<T>
actual fun ByteArray.copyOf(): ByteArray
actual fun ShortArray.copyOf(): ShortArray
actual fun IntArray.copyOf(): IntArray
actual fun LongArray.copyOf(): LongArray
actual fun FloatArray.copyOf(): FloatArray
actual fun DoubleArray.copyOf(): DoubleArray
actual fun BooleanArray.copyOf(): BooleanArray
actual fun CharArray.copyOf(): CharArray

Returns new array which is a copy of the original array.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopy = array.copyOf()
assertPrints(arrayCopy.contentToString(), "[apples, oranges, limes]") 
   //sampleEnd
}

actual fun ByteArray.copyOf(newSize: Int): ByteArray
actual fun ShortArray.copyOf(newSize: Int): ShortArray
actual fun IntArray.copyOf(newSize: Int): IntArray
actual fun LongArray.copyOf(newSize: Int): LongArray
actual fun FloatArray.copyOf(newSize: Int): FloatArray
actual fun DoubleArray.copyOf(newSize: Int): DoubleArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with zero values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with zero values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual fun BooleanArray.copyOf(newSize: Int): BooleanArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with false values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with false values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual fun CharArray.copyOf(newSize: Int): CharArray

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null char (\u0000) values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null char (\u0000) values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = intArrayOf(1, 2, 3)
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[1, 2, 3, 0, 0]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[1, 2]") 
   //sampleEnd
}

actual fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

Returns new array which is a copy of the original array, resized to the given newSize. The copy is either truncated or padded at the end with null values if necessary.

  • If newSize is less than the size of the original array, the copy array is truncated to the newSize.

  • If newSize is greater than the size of the original array, the extra elements in the copy array are filled with null values.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val array = arrayOf("apples", "oranges", "limes")
val arrayCopyPadded = array.copyOf(5)
assertPrints(arrayCopyPadded.contentToString(), "[apples, oranges, limes, null, null]")
val arrayCopyTruncated = array.copyOf(2)
assertPrints(arrayCopyTruncated.contentToString(), "[apples, oranges]") 
   //sampleEnd
}