fopen ( path mode -- alien )
Factor handbook » Input and output » ANSI C streams

Prev:	<c-writer> ( handle -- stream )
Next:	fwrite ( data length alien -- )

Vocabulary
io.streams.c

Inputs

path	a pathname string
mode	an access mode specifier

Outputs

alien

a C FILE* handle

Word description
Opens a file named by path. The mode parameter should be something like "r" or "rw"; consult the fopen(3) manual page for details.

Errors
Throws an error if the file could not be opened.

Notes
User code should call <file-reader> or <file-writer> to get a high level stream.

Definition

USING: alien.strings io.encodings.utf8 kernel ;

IN: io.streams.c

: fopen ( path mode -- alien )
    [ utf8 string>alien ] bi@ (fopen) ;