import kotlinx.io.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val buffer = Buffer()

buffer.writeString("hello", startIndex = 1, endIndex = 4)
assertContentEquals(
    byteArrayOf(
        'e'.code.toByte(),
        'l'.code.toByte(),
        'l'.code.toByte()
    ), buffer.readByteArray()
)

buffer.writeString("Δ")
assertContentEquals(byteArrayOf(0xce.toByte(), 0x94.toByte()), buffer.readByteArray()) 
   //sampleEnd
}
xxxxxxxxxx
 
val buffer = Buffer()
buffer.writeString("hello", startIndex = 1, endIndex = 4)
assertContentEquals(
    byteArrayOf(
        'e'.code.toByte(),
        'l'.code.toByte(),
        'l'.code.toByte()
    ), buffer.readByteArray()
)
buffer.writeString("Δ")
assertContentEquals(byteArrayOf(0xce.toByte(), 0x94.toByte()), buffer.readByteArray()) 
Open in Playground →
Target: JVMRunning on v.2.1.10

fun Sink.writeString(chars: CharSequence, startIndex: Int = 0, endIndex: Int = chars.length)(source)

Encodes the characters at startIndex up to endIndex from chars in UTF-8 and writes it to this sink.

Parameters

chars

the string to be encoded.

startIndex

the index (inclusive) of the first character to encode, 0 by default.

endIndex

the index (exclusive) of a character past to a last character to encode, chars.length by default.

Throws

IndexOutOfBoundsException

when startIndex or endIndex is out of range of chars indices.

IllegalArgumentException

when startIndex > endIndex.

IllegalStateException

when the sink is closed.

IOException

when some I/O error occurs.

Samples

import kotlinx.io.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val buffer = Buffer()

buffer.writeString(StringBuilder("hello"), startIndex = 1, endIndex = 4)
assertContentEquals(
    byteArrayOf(
        'e'.code.toByte(),
        'l'.code.toByte(),
        'l'.code.toByte()
    ), buffer.readByteArray()
)

buffer.writeString(StringBuilder("Δ"))
assertContentEquals(byteArrayOf(0xce.toByte(), 0x94.toByte()), buffer.readByteArray()) 
   //sampleEnd
}
xxxxxxxxxx
 
val buffer = Buffer()
buffer.writeString(StringBuilder("hello"), startIndex = 1, endIndex = 4)
assertContentEquals(
    byteArrayOf(
        'e'.code.toByte(),
        'l'.code.toByte(),
        'l'.code.toByte()
    ), buffer.readByteArray()
)
buffer.writeString(StringBuilder("Δ"))
assertContentEquals(byteArrayOf(0xce.toByte(), 0x94.toByte()), buffer.readByteArray()) 
Open in Playground →
Target: JVMRunning on v.2.1.10

fun Sink.writeString(string: String, charset: Charset, startIndex: Int = 0, endIndex: Int = string.length)(source)

Encodes substring of string starting at startIndex and ending at endIndex using charset and writes into this sink.

Parameters

string

the string to encode into this sink.

charset

the Charset to use for encoding.