:: Int
Maximum size of the provided list of characters.
Warning: Must be greater than or equal to the length of the list.
-> [Char]
-> TextBuilder

Source#

Helper for constructing from char producers a bit more efficiently than via (text . fromString).

Example1 expression

>>> unsafeChars 3 "123""123"

Example1 expression

>>> unsafeChars 4 "123""123"

valueunsafeSeptets

:: Int
Maximum size of the byte array to allocate.
Must be greater than or equal to the length of the list.
Warning: If it is smaller, bad things will happen. We'll be writing outside of the allocated array.
-> [Word8]
List of bytes to write.
Warning: It is your responsibility to ensure that the bytes are smaller than 128. Otherwise the produced text will have a broken encoding.
To ensure of optimization kicking in it is advised to construct the list using build.
-> TextBuilder

Source#

Provides a unified way to deal with the byte array regardless of the version of the text library.

Keep in mind that prior to text-2.0, the array was operating on Word16 values due to the library abstracting over UTF-16. Starting from text-2.0, the array operates on Word8 values and the library abstracts over UTF-8.

This function is useful for building ASCII values.

Example1 expression

>>> unsafeSeptets 3 (fmap (+48) [1, 2, 3])"123"

Example1 expression

>>> unsafeSeptets 4 (fmap (+48) [1, 2, 3])"123"

valueunsafeReverseSeptets

:: Int
Precise amount of bytes in the list.
Needs to be precise, because writing happens in reverse order.
Warning: If it is smaller, bad things will happen. We'll be writing outside of the allocated array.
-> [Word8]
List of bytes to write in reverse order.
Warning: It is your responsibility to ensure that the bytes are smaller than 128. Otherwise the produced text will have a broken encoding.
To ensure of optimization kicking in it is advised to construct the list using build.
-> TextBuilder

Source#

Same as unsafeSeptets, but writes the bytes in reverse order and requires the size to be precise.

Example1 expression

>>> unsafeReverseSeptets 3 (fmap (+48) [1, 2, 3])"321"