Relude.File

Lifted to MonadIO families of file processing functions for the Text, LText, ByteString and LByteString types.

These functions are lifted which means that you can also use them inside various Monad Transformers without adding liftIO call explicitly.

NOTE: These functions are for working with textual data. Functions that work with Text or LText types are system and locale-sensitive (encoding, line-endings). If you want binary data, use ByteString functions (they are also faster since they don't check encoding). However, you can then decode that data with the help of functions from the Relude.String.Conversion module, e. g. decodeUtf8.

Since: 0.3.0

Text

readFileText :: MonadIO m => FilePath -> m Text

Lifted version of readFile.

Since: 0.3.0

writeFileText :: MonadIO m => FilePath -> Text -> m ()

Lifted version of writeFile.

Since: 0.3.0

appendFileText :: MonadIO m => FilePath -> Text -> m ()

Lifted version of appendFile.

Since: 0.3.0

Lazy Text

readFileLText :: MonadIO m => FilePath -> m LText

Lifted version of readFile.

Since: 0.3.0

writeFileLText :: MonadIO m => FilePath -> LText -> m ()

Lifted version of writeFile.

Since: 0.3.0

appendFileLText :: MonadIO m => FilePath -> LText -> m ()

Lifted version of appendFile.

Since: 0.3.0

ByteString

readFileBS :: MonadIO m => FilePath -> m ByteString

Lifted version of readFile.

Since: 0.3.0

writeFileBS :: MonadIO m => FilePath -> ByteString -> m ()

Lifted version of writeFile.

Since: 0.3.0

appendFileBS :: MonadIO m => FilePath -> ByteString -> m ()

Lifted version of appendFile.

Since: 0.3.0

Lazy ByteString

readFileLBS :: MonadIO m => FilePath -> m LByteString

Lifted version of readFile.

Since: 0.3.0

writeFileLBS :: MonadIO m => FilePath -> LByteString -> m ()

Lifted version of writeFile.

Since: 0.3.0

appendFileLBS :: MonadIO m => FilePath -> LByteString -> m ()

Lifted version of appendFile.

Since: 0.3.0