System.FilePath

High-level, byte-based file and directory path manipulations. You probably want to import System.FilePath.CurrentOS instead, since it handles detecting which rules to use in the current compilation.

Documentation

data FilePath

Instances

Eq FilePath

Data FilePath

Show FilePath

Typeable FilePath

IsString FilePath

Monoid FilePath

empty :: FilePath

A file path with no root, components, or filename

Basic properties

null :: FilePath -> Bool

null p == (p == empty)

root :: FilePath -> FilePath

Retrieves the FilePath's root.

directory :: FilePath -> FilePath

Retrieves the FilePath's directory. If the path is already a directory, it is returned unchanged.

parent :: FilePath -> FilePath

Retrieves the FilePath's parent directory.

filename :: FilePath -> FilePath

Retrieve the filename component of a FilePath. filename "foo/bar.txt" == "bar.txt".

basename :: FilePath -> FilePath

Retrieve the basename component of a FilePath. filename "foo/bar.txt" == "bar".

absolute :: FilePath -> Bool

Return whether the path is absolute.

relative :: FilePath -> Bool

Return whether the path is relative.

Basic operations

append :: FilePath -> FilePath -> FilePath

Appends two FilePaths. If the second path is absolute, it is returned unchanged.

(</>) :: FilePath -> FilePath -> FilePath

An alias for append.

concat :: [FilePath] -> FilePath

A fold over append.

commonPrefix :: [FilePath] -> FilePath

Find the greatest common prefix between two FilePaths.

Extensions

extension :: FilePath -> Maybe ByteString

Get a FilePath's last extension, or Nothing if it has no extensions.

extensions :: FilePath -> [ByteString]

Get a FilePath's full extension list.

hasExtension :: FilePath -> ByteString -> Bool

Get whether a FilePath's last extension is the predicate.

addExtension :: FilePath -> ByteString -> FilePath

Append an extension to the end of a FilePath.

(<.>) :: FilePath -> ByteString -> FilePath

An alias for addExtension.

dropExtension :: FilePath -> FilePath

Remove a FilePath's last extension.

replaceExtension :: FilePath -> ByteString -> FilePath

Replace a FilePath's last extension.

addExtensions :: FilePath -> [ByteString] -> FilePath

Append many extensions to the end of a FilePath.

dropExtensions :: FilePath -> FilePath

Remove all extensions from a FilePath.

replaceExtensions :: FilePath -> [ByteString] -> FilePath

Remove all extensions from a FilePath, and replace them with a new list.

splitExtension :: FilePath -> (FilePath, Maybe ByteString)

splitExtension p = (dropExtension p, extension p)

splitExtensions :: FilePath -> (FilePath, [ByteString])

splitExtensions p = (dropExtensions p, extensions p)