decode ( byte-array encoding -- string )
Factor handbook » Input and output » I/O encodings » Encoding and decoding strings

Prev:

encode ( string encoding -- byte-array )

Vocabulary
io.encodings.string

Inputs

byte-array	a byte-array
encoding	an encoding descriptor

Outputs

string

a string

Word description
Converts an array of bytes to a string, interpreting that array of bytes as a string with the given encoding.

Examples

USING: io.encodings.string io.encodings.utf8 prettyprint ; B{ 230 136 145 231 136 177 228 189 160 } utf8 decode .
"我爱你"

Definition

USING: byte-arrays io io.encodings io.encodings.ascii
io.encodings.binary io.encodings.private io.streams.byte-array
kernel sbufs sequences ;

IN: io.encodings.string

:: decode ( byte-array encoding -- string )
    encoding binary eq?
    [ byte-array ] [
        byte-array byte-array? encoding ascii eq? and
        [ byte-array byte-array>string-fast ] [
            byte-array encoding <byte-reader>
            :> reader byte-array length encoding
            guess-decoded-length <sbuf> :> buf
            [ reader stream-read1 ] [ buf push ] while*
            buf "" like
        ] if
    ] if ; inline