Document empty bytestring factory (#396)

Author: fzhinkin

bytestring/common/src/ByteString.kt

@@ -55,6 +55,11 @@ public fun ByteString(vararg bytes: UByte): ByteString = if (bytes.isEmpty()) {
     ByteString.wrap(bytes.asByteArray())
 }
 
+/**
+ * Returns an empty [ByteString].
+ *
+ * @sample kotlinx.io.bytestring.samples.ByteStringSamples.constructEmpty
+ */
 @JsName("EmptyByteString")
 public fun ByteString(): ByteString = ByteString.EMPTY
 

bytestring/common/test/samples/samples.kt

@@ -247,4 +247,11 @@ class ByteStringSamples {
 
         assertEquals(ByteString(3, 4, 5, 6), byteString)
     }
+
+    @Test
+    fun constructEmpty() {
+        val byteString = ByteString()
+        assertTrue(byteString.isEmpty())
+        assertContentEquals(ByteArray(0), byteString.toByteArray())
+    }
 }