The desired character type in the resulting iopipe. Must be one of char, wchar, or dchar.
If true, the resulting iopipe will ALWAYS have a byte order mark at the beginning of the stream. At the moment this is accomplished by copying all the data from the original iopipe to the new one. A better mechanism is being worked on.
The source iopipe.
An iopipe which fulfills the given requirements.
Convert iopipe of one text type into an iopipe for another type. Performs conversions at the code-point level. If specified, the resulting iopipe will ensure there is a BOM at the beginning of the iopipe. This is useful if writing to storage.
If no conversion is necessary, and no BOM is required, the original iopipe is returned.