Moduleio-streams-1.5.2.2Haskell2010

System.IO.Streams.File

Input and output streams for files.

The functions in this file use "with*" or "bracket" semantics, i.e. they open the supplied FilePath, run a user computation, and then close the file handle. If you need more control over the lifecycle of the underlying file descriptor resources, you are encouraged to use the functions from System.IO.Streams.Handle instead.

Contents

File conversions

Synopsis

value withFileAsInput
value withFileAsInputStartingAt
value unsafeWithFileAsInputStartingAt
value withFileAsOutput
value withFileAsOutputExt

Packageio-streams-1.5.2.2
Exports5
LanguageHaskell2010
LicenceBSD-3-Clause
SourceFile.hs

File conversions

valuewithFileAsInput

:: FilePath
file to open
-> (InputStream ByteString -> IO a)
function to run
-> IO a

Source#

withFileAsInput name act opens the specified file in "read mode" and passes the resulting InputStream to the computation act. The file will be closed on exit from withFileAsInput, whether by normal termination or by raising an exception.

If closing the file raises an exception, then that exception will be raised by withFileAsInput rather than any exception raised by act.

valuewithFileAsInputStartingAt

:: Int64
starting index to seek to
-> FilePath
file to open
-> (InputStream ByteString -> IO a)
function to run
-> IO a

Source#

Like withFileAsInput, but seeks to the specified byte offset before attaching the given file descriptor to the InputStream.

valueunsafeWithFileAsInputStartingAt

:: Int64
starting index to seek to
-> FilePath
file to open
-> (InputStream ByteString -> IO a)
function to run
-> IO a

Source#

Like withFileAsInputStartingAt, except that the ByteString emitted by the created InputStream may reuse its buffer. You may only use this function if you do not retain references to the generated bytestrings emitted.

valuewithFileAsOutput

:: FilePath
file to open
-> (OutputStream ByteString -> IO a)
function to run
-> IO a

Source#

Open a file for writing and attaches an OutputStream for you to write to. The file will be closed on error or completion of your action.

valuewithFileAsOutputExt

:: FilePath
file to open
-> IOMode
mode to write in
-> BufferMode
should we buffer the output?
-> (OutputStream ByteString -> IO a)
function to run
-> IO a

Source#

Like withFileAsOutput, but allowing you control over the output file mode and buffering behaviour.