Builds new byte string by populating newly created ByteStringBuilder initialized with the given capacity using provided builderAction and then converting it to ByteString.

ByteString

fun ByteString(): ByteString

Returns an empty ByteString.

fun ByteString(vararg bytes: Byte): ByteString

fun ByteString(vararg bytes: UByte): ByteString

Wraps given bytes into a byte string.

contentEquals

fun ByteString.contentEquals(array: ByteArray): Boolean

Returns true if the content of this byte string equals to the array.

decode

@ExperimentalEncodingApi

fun Base64.decode(source: ByteString, startIndex: Int = 0, endIndex: Int = source.size): ByteArray

Decodes symbols from the specified source byte string or its subrange. Returns a ByteArray containing the resulting bytes.

decodeIntoByteArray

@ExperimentalEncodingApi

fun Base64.decodeIntoByteArray(source: ByteString, destination: ByteArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = source.size): Int

Decodes symbols from the specified source byte string or its subrange and writes resulting bytes into the destination array. Returns the number of bytes written.

decodeToByteString

@ExperimentalEncodingApi

fun Base64.decodeToByteString(source: ByteArray, startIndex: Int = 0, endIndex: Int = source.size): ByteString

@ExperimentalEncodingApi

fun Base64.decodeToByteString(source: ByteString, startIndex: Int = 0, endIndex: Int = source.size): ByteString

Decodes symbols from the specified source byte string or its subrange. Returns a ByteString containing the resulting bytes.

@ExperimentalEncodingApi

fun Base64.decodeToByteString(source: CharSequence, startIndex: Int = 0, endIndex: Int = source.length): ByteString

Decodes symbols from the specified source char sequence or its substring. Returns a ByteString containing the resulting bytes.

decodeToString

fun ByteString.decodeToString(): String

Decodes content of a byte string into a string using UTF-8 encoding.

fun ByteString.decodeToString(charset: Charset): String

Decodes the content of a byte string to a string using given charset.

encode

@ExperimentalEncodingApi

fun Base64.encode(source: ByteString, startIndex: Int = 0, endIndex: Int = source.size): String

Encodes bytes from the specified source byte string or its subrange. Returns a string with the resulting symbols.

encodeIntoByteArray

@ExperimentalEncodingApi

fun Base64.encodeIntoByteArray(source: ByteString, destination: ByteArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = source.size): Int

Encodes bytes from the specified source byte string or its subrange and writes resulting symbols into the destination array. Returns the number of symbols written.

encodeToAppendable

@ExperimentalEncodingApi

fun <A : Appendable> Base64.encodeToAppendable(source: ByteString, destination: A, startIndex: Int = 0, endIndex: Int = source.size): A

Encodes bytes from the specified source byte string or its subrange and appends resulting symbols to the destination appendable. Returns the destination appendable.

encodeToByteArray

@ExperimentalEncodingApi

fun Base64.encodeToByteArray(source: ByteString, startIndex: Int = 0, endIndex: Int = source.size): ByteArray

Encodes bytes from the specified source byte string or its subrange. Returns a ByteArray containing the resulting symbols.

encodeToByteString

fun String.encodeToByteString(): ByteString

Encodes a string into a byte sequence using UTF8-encoding and wraps it into a byte string.

fun String.encodeToByteString(charset: Charset): ByteString

Encodes a string into a byte string using charset.

endsWith

fun ByteString.endsWith(byteArray: ByteArray): Boolean

Returns true if this byte string ends with the suffix specified by the byteArray.

fun ByteString.endsWith(byteString: ByteString): Boolean

Returns true if this byte string ends with the suffix specified by the byteString.

getByteString

fun ByteBuffer.getByteString(length: Int = remaining()): ByteString

Reads length bytes of data from this ByteBuffer starting from the current position and wraps them into a new ByteString.

fun ByteBuffer.getByteString(at: Int, length: Int): ByteString

Reads length bytes of data from this ByteBuffer starting from at index and wraps them into a new ByteString.

hexToByteString

@ExperimentalStdlibApi

fun String.hexToByteString(format: HexFormat = HexFormat.Default): ByteString

Parses bytes from this string using the specified HexFormat.

indexOf

fun ByteString.indexOf(byte: Byte, startIndex: Int = 0): Int

Returns the index within this byte string of the first occurrence of the specified byte, starting from the specified startIndex. If the byte not found, -1 is returned.

fun ByteString.indexOf(byteArray: ByteArray, startIndex: Int = 0): Int

Returns the index within this byte string of the first occurrence of the specified byteArray, starting from the specified startIndex. If the byteArray not found, -1 is returned.

fun ByteString.indexOf(byteString: ByteString, startIndex: Int = 0): Int

Returns the index within this byte string of the first occurrence of the specified byteString, starting from the specified startIndex. If the byteString not found, -1 is returned.

isEmpty

fun ByteString.isEmpty(): Boolean

Returns true if this byte string is empty.

isNotEmpty

fun ByteString.isNotEmpty(): Boolean

Returns true if this byte string is not empty.

lastIndexOf

fun ByteString.lastIndexOf(byte: Byte, startIndex: Int = 0): Int

Returns the index within this char sequence of the last occurrence of the specified byte, starting from the specified startIndex. If the byte not found, -1 is returned.

fun ByteString.lastIndexOf(byteArray: ByteArray, startIndex: Int = 0): Int

Returns the index within this char sequence of the last occurrence of the specified byteArray, starting from the specified startIndex. If the byteArray not found, -1 is returned.

fun ByteString.lastIndexOf(byteString: ByteString, startIndex: Int = 0): Int

Returns the index within this char sequence of the last occurrence of the specified byteString, starting from the specified startIndex. If the byteString not found, -1 is returned.