diff --git a/libraries/stdlib/src/kotlin/collections/AbstractCollection.kt b/libraries/stdlib/src/kotlin/collections/AbstractCollection.kt index a8cfa7a8daf..4b4d7f31511 100644 --- a/libraries/stdlib/src/kotlin/collections/AbstractCollection.kt +++ b/libraries/stdlib/src/kotlin/collections/AbstractCollection.kt @@ -36,6 +36,14 @@ public abstract class AbstractCollection protected constructor() : Collec /** * Fills the provided [array] or creates new array of the same type * and fills it with the elements of this collection. + * + * If this collection doesn't fit in the provided [array], + * a new array is created with the same array type and the size of this collection, + * and filled with this collection elements. + * Otherwise, the specified [array] is filled starting from index 0. + * The value of the elements following the collection elements is unspecified. + * + * @return An array containing all elements of this collection. */ protected open fun toArray(array: Array): Array = copyToArrayImpl(this, array) }