A converter to allow conversion into any other type of text.
The converter does 2 things. First and foremost, it adds a read function
that allows conversion into any other width of text. The read function
converts as much text as possible into the given format, extending the base
iopipe as necessary.
The second thing that it does is potentially add a BOM character to the
beginning of the text. It was decided to add this here, since you are likely
already copying data from one iopipe into another. However, in future
versions, this capability may go away, as we can do this elsewhere with less
copying. So expect this API to change.
A converter to allow conversion into any other type of text.
The converter does 2 things. First and foremost, it adds a read function that allows conversion into any other width of text. The read function converts as much text as possible into the given format, extending the base iopipe as necessary.
The second thing that it does is potentially add a BOM character to the beginning of the text. It was decided to add this here, since you are likely already copying data from one iopipe into another. However, in future versions, this capability may go away, as we can do this elsewhere with less copying. So expect this API to change.