<file-reader> ( path encoding -- stream )
Factor handbook » Input and output » Reading and writing files

Prev:	Examples of reading and writing files
Next:	<file-writer> ( path encoding -- stream )

Vocabulary
io.files

Inputs

path	a pathname string
encoding	an encoding descriptor

Outputs

stream

an input stream

Word description
Outputs an input stream for reading from the specified pathname using the given encoding.

Notes
Most code should use with-file-reader instead, to ensure the stream is properly disposed of after.

Errors
Throws an error if the file is unreadable.

Definition

USING: io.backend io.encodings kernel kernel.private ;

IN: io.files

: <file-reader> ( path encoding -- stream )
    [ normalize-path (file-reader) { file-reader } declare ] dip
    <decoder> ; inline