Merge pull request #22 from cketti/appendable

Change `StringBuilderExtensions` to `AppendableExtensions`

Author: cketti

kotlin-codepoints-deluxe/src/commonMain/kotlin/AppendableExtensions.kt

@@ -0,0 +1,14 @@
+package de.cketti.codepoints.deluxe
+
+import de.cketti.codepoints.CodePoints
+import de.cketti.codepoints.appendCodePoint as intAppendCodePoint
+
+/**
+ * Appends the string representation of the [codePoint] argument to this Appendable and returns this instance.
+ *
+ * To append the codepoint, [Appendable.append(Char)][Appendable.append] is called [CodePoints.charCount] times.
+ *
+ * The overall effect is exactly as if the argument were converted to a char array by the function
+ * [CodePoints.toChars] and the characters in that array were then appended to this Appendable.
+ */
+fun <T : Appendable> T.appendCodePoint(codePoint: CodePoint): T = intAppendCodePoint(codePoint.value)

kotlin-codepoints-deluxe/src/commonMain/kotlin/StringBuilderExtensions.kt

@@ -3,7 +3,7 @@ package de.cketti.codepoints.deluxe
 import kotlin.test.assertEquals
 import kotlin.test.Test
 
-class StringBuilderExtensionsTest {
+class AppendableExtensionsTest {
     @Test
     fun appendCodePoint() {
         val actual = buildString {

…st/kotlin/StringBuilderExtensionsTest.kt …nTest/kotlin/AppendableExtensionsTest.ktkotlin-codepoints-deluxe/src/commonTest/kotlin/StringBuilderExtensionsTest.kt renamed to kotlin-codepoints-deluxe/src/commonTest/kotlin/AppendableExtensionsTest.kt kotlin-codepoints-deluxe/src/commonTest/kotlin/StringBuilderExtensionsTest.kt renamed to kotlin-codepoints-deluxe/src/commonTest/kotlin/AppendableExtensionsTest.kt

@@ -0,0 +1,22 @@
+package de.cketti.codepoints
+
+import de.cketti.codepoints.CodePoints.highSurrogate
+import de.cketti.codepoints.CodePoints.isBmpCodePoint
+import de.cketti.codepoints.CodePoints.lowSurrogate
+
+/**
+ * Appends the string representation of the [codePoint] argument to this Appendable and returns this instance.
+ *
+ * To append the codepoint, [Appendable.append(Char)][Appendable.append] is called [CodePoints.charCount] times.
+ *
+ * The overall effect is exactly as if the argument were converted to a char array by the function
+ * [CodePoints.toChars] and the characters in that array were then appended to this Appendable.
+ */
+fun <T : Appendable> T.appendCodePoint(codePoint: Int): T = apply {
+    if (isBmpCodePoint(codePoint)) {
+        append(codePoint.toChar())
+    } else {
+        append(highSurrogate(codePoint))
+        append(lowSurrogate(codePoint))
+    }
+}

kotlin-codepoints/src/commonImplementation/kotlin/StringBuilderExtensions.kt

@@ -3,7 +3,7 @@ package de.cketti.codepoints
 import kotlin.test.assertEquals
 import kotlin.test.Test
 
-class StringBuilderExtensionsTest {
+class AppendableExtensionsTest {
     @Test
     fun appendCodePoint() {
         val actual = buildString {