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

Prev:	<file-writer> ( path encoding -- stream )
Next:	file-contents ( path encoding -- seq )

Vocabulary
io.files

Inputs

path	a pathname string
encoding	an encoding descriptor

Outputs

stream

an output stream

Word description
Outputs an output stream for writing to the specified pathname using the given encoding. The stream begins writing at the end of the file.

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

Errors
Throws an error if the file cannot be opened for writing.

Definition

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

IN: io.files

: <file-appender> ( path encoding -- stream )
    [ normalize-path (file-appender) { file-writer } declare ]
    dip <encoder> ; inline