KT-20357: Rename and enhance sample usages for array constructor functions in standard library

Related issue: KT-20357

Author: oscarArismendi

libraries/stdlib/jvm/builtins/Library.kt

@@ -35,41 +35,57 @@ public actual inline fun <reified T> arrayOf(vararg elements: T): Array<T>
 
 /**
  * Returns an array containing the specified [Double] numbers.
+ *
+ * @sample samples.collections.Arrays.Constructors.doubleArrayOfSampl
  */
 public actual fun doubleArrayOf(vararg elements: Double): DoubleArray
 
 /**
  * Returns an array containing the specified [Float] numbers.
+ *
+ * @sample samples.collections.Arrays.Constructors.floatArrayOfSample
  */
 public actual fun floatArrayOf(vararg elements: Float): FloatArray
 
 /**
  * Returns an array containing the specified [Long] numbers.
+ *
+ * @sample samples.collections.Arrays.Constructors.longArrayOfSample
  */
 public actual fun longArrayOf(vararg elements: Long): LongArray
 
 /**
  * Returns an array containing the specified [Int] numbers.
+ *
+ * @sample samples.collections.Arrays.Constructors.intArrayOfSample
  */
 public actual fun intArrayOf(vararg elements: Int): IntArray
 
 /**
  * Returns an array containing the specified characters.
+ *
+ * @sample samples.collections.Arrays.Constructors.charArrayOfSample
  */
 public actual fun charArrayOf(vararg elements: Char): CharArray
 
 /**
  * Returns an array containing the specified [Short] numbers.
+ *
+ * @sample samples.collections.Arrays.Constructors.shortArrayOfSample
  */
 public actual fun shortArrayOf(vararg elements: Short): ShortArray
 
 /**
  * Returns an array containing the specified [Byte] numbers.
+ *
+ * @sample samples.collections.Arrays.Constructors.byteArrayOfSample
  */
 public actual fun byteArrayOf(vararg elements: Byte): ByteArray
 
 /**
  * Returns an array containing the specified boolean values.
+ *
+ * @sample samples.collections.Arrays.Constructors.booleanArrayOfSample
  */
 public actual fun booleanArrayOf(vararg elements: Boolean): BooleanArray
 

libraries/stdlib/samples/test/samples/collections/arrays.kt

@@ -536,49 +536,73 @@ class Arrays {
 
     class Constructors {
         @Sample
-        fun doubleArrayOf() {
+        fun doubleArrayOfSample() {
+            val emptyDoubleArray = doubleArrayOf()
+            assertPrints(emptyDoubleArray.contentToString(), "[]")
+
             val doubleArray = doubleArrayOf(1.0, 2.5, 3.14)
             assertPrints(doubleArray.contentToString(), "[1.0, 2.5, 3.14]")
         }
 
         @Sample
-        fun floatArrayOf() {
+        fun floatArrayOfSample() {
+            val emptyFloatArray = floatArrayOf()
+            assertPrints(emptyFloatArray.contentToString(), "[]")
+
             val floatArray = floatArrayOf(1.0f, 2.5f, 3.14f)
             assertPrints(floatArray.contentToString(), "[1.0, 2.5, 3.14]")
         }
 
         @Sample
-        fun longArrayOf() {
+        fun longArrayOfSample() {
+            val emptyLongArray = longArrayOf()
+            assertPrints(emptyLongArray.contentToString(), "[]")
+
             val longArray = longArrayOf(1L, 2L, 3L)
             assertPrints(longArray.contentToString(), "[1, 2, 3]")
         }
 
         @Sample
-        fun intArrayOf() {
+        fun intArrayOfSample() {
+            val emptyIntArray = intArrayOf()
+            assertPrints(emptyIntArray.contentToString(), "[]")
+
             val intArray = intArrayOf(1, 2, 3)
             assertPrints(intArray.contentToString(), "[1, 2, 3]")
         }
 
         @Sample
-        fun charArrayOf() {
-            val chars = charArrayOf('a', 'b', 'c')
-            assertPrints(chars.contentToString(), "[a, b, c]")
+        fun charArrayOfSample() {
+            val emptyCharArray = charArrayOf()
+            assertPrints(emptyCharArray.contentToString(), "[]")
+
+            val charArray = charArrayOf('a', 'b', 'c')
+            assertPrints(charArray.contentToString(), "[a, b, c]")
         }
 
         @Sample
-        fun shortArrayOf() {
+        fun shortArrayOfSample() {
+            val emptyShortArray = shortArrayOf()
+            assertPrints(emptyShortArray.contentToString(), "[]")
+
             val shortArray = shortArrayOf(1, 2, 3)
             assertPrints(shortArray.contentToString(), "[1, 2, 3]")
         }
 
         @Sample
-        fun byteArrayOf() {
+        fun byteArrayOfSample() {
+            val emptyByteArray = byteArrayOf()
+            assertPrints(emptyByteArray.contentToString(), "[]")
+
             val byteArray = byteArrayOf(1, 2, 3)
             assertPrints(byteArray.contentToString(), "[1, 2, 3]")
         }
 
         @Sample
-        fun booleanArrayOf() {
+        fun booleanArrayOfSample() {
+            val emptyBooleanArray = booleanArrayOf()
+            assertPrints(emptyBooleanArray.contentToString(), "[]")
+
             val booleanArray = booleanArrayOf(true, false, true)
             assertPrints(booleanArray.contentToString(), "[true, false, true]")
         }

libraries/stdlib/src/kotlin/Library.kt

@@ -34,56 +34,56 @@ public expect inline fun <reified T> arrayOf(vararg elements: T): Array<T>
 /**
  * Returns an array containing the specified [Double] numbers.
  *
- * @sample samples.collections.Arrays.Constructors.doubleArrayOf
+ * @sample samples.collections.Arrays.Constructors.doubleArrayOfSample
  */
 public expect fun doubleArrayOf(vararg elements: Double): DoubleArray
 
 /**
  * Returns an array containing the specified [Float] numbers.
  *
- * @sample samples.collections.Arrays.Constructors.floatArrayOf
+ * @sample samples.collections.Arrays.Constructors.floatArrayOfSample
  */
 public expect fun floatArrayOf(vararg elements: Float): FloatArray
 
 /**
  * Returns an array containing the specified [Long] numbers.
  *
- * @sample samples.collections.Arrays.Constructors.longArrayOf
+ * @sample samples.collections.Arrays.Constructors.longArrayOfSample
  */
 public expect fun longArrayOf(vararg elements: Long): LongArray
 
 /**
  * Returns an array containing the specified [Int] numbers.
  *
- * @sample samples.collections.Arrays.Constructors.intArrayOf
+ * @sample samples.collections.Arrays.Constructors.intArrayOfSample
  */
 public expect fun intArrayOf(vararg elements: Int): IntArray
 
 /**
  * Returns an array containing the specified characters.
  *
- * @sample samples.collections.Arrays.Constructors.charArrayOf
+ * @sample samples.collections.Arrays.Constructors.charArrayOfSample
  */
 public expect fun charArrayOf(vararg elements: Char): CharArray
 
 /**
  * Returns an array containing the specified [Short] numbers.
  *
- * @sample samples.collections.Arrays.Constructors.shortArrayOf
+ * @sample samples.collections.Arrays.Constructors.shortArrayOfSample
  */
 public expect fun shortArrayOf(vararg elements: Short): ShortArray
 
 /**
  * Returns an array containing the specified [Byte] numbers.
  *
- * @sample samples.collections.Arrays.Constructors.byteArrayOf
+ * @sample samples.collections.Arrays.Constructors.byteArrayOfSample
  */
 public expect fun byteArrayOf(vararg elements: Byte): ByteArray
 
 /**
  * Returns an array containing the specified boolean values.
  *
- * @sample samples.collections.Arrays.Constructors.booleanArrayOf
+ * @sample samples.collections.Arrays.Constructors.booleanArrayOfSample
  */
 public expect fun booleanArrayOf(vararg elements: Boolean): BooleanArray