Portability	portable
Maintainer	jmillikin@gmail.com
Safe Haskell	Safe-Infered

Filesystem.Path

Contents

Basic properties
Basic operations
Extensions

Description

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

Synopsis

Documentation

data FilePath Source

Instances

Eq FilePath
Data FilePath
Ord FilePath
Show FilePath
Typeable FilePath
IsString FilePath
Monoid FilePath
NFData FilePath

empty :: FilePath Source

A file path with no root, directory, or filename

Basic properties

null :: FilePath -> Bool Source

null p = (p == empty)

root :: FilePath -> FilePath Source

Retrieves the FilePath’s root.

directory :: FilePath -> FilePath Source

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

parent :: FilePath -> FilePath Source

Retrieves the FilePath’s parent directory.

filename :: FilePath -> FilePath Source

Retrieve a FilePath’s filename component.

 filename "foo/bar.txt" == "bar.txt"

dirname :: FilePath -> FilePath Source

Retrieve a FilePath’s directory name. This is only the file name of the directory, not its full path.

 dirname "foo/bar/baz.txt" == "bar"
 dirname "/" == ""

Since: 0.4.1

basename :: FilePath -> FilePath Source

Retrieve a FilePath’s basename component.

 basename "foo/bar.txt" == "bar"

absolute :: FilePath -> Bool Source

Test whether a path is absolute.

relative :: FilePath -> Bool Source

Test whether a path is relative.

Basic operations

append :: FilePath -> FilePath -> FilePath Source

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

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

An alias for append.

concat :: [FilePath] -> FilePath Source

A fold over append.

commonPrefix :: [FilePath] -> FilePath Source

Find the greatest common prefix between a list of FilePaths.

stripPrefix :: FilePath -> FilePath -> Maybe FilePath Source

Remove a prefix from a path.

 stripPrefix "foo" "foobarbaz.txt\" == Just \"barbaz.txt"
 stripPrefix "foo" "barbaz.txt" == Nothing

Since: 0.4.1

collapse :: FilePath -> FilePath Source

Remove "." and ".." directories from a path.

Note that if any of the elements are symbolic links, collapse may change which file the path resolves to.

Since: 0.2

splitDirectories :: FilePath -> [FilePath]Source

Extensions

extension :: FilePath -> Maybe Text Source

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

extensions :: FilePath -> [Text]Source

Get a FilePath’s full extension list.

hasExtension :: FilePath -> Text -> Bool Source

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

addExtension :: FilePath -> Text -> FilePath Source

Append an extension to the end of a FilePath.

(<.>) :: FilePath -> Text -> FilePath Source

An alias for addExtension.

dropExtension :: FilePath -> FilePath Source

Remove a FilePath’s last extension.

replaceExtension :: FilePath -> Text -> FilePath Source

Replace a FilePath’s last extension.

addExtensions :: FilePath -> [Text] -> FilePath Source

Append many extensions to the end of a FilePath.

dropExtensions :: FilePath -> FilePath Source

Remove all extensions from a FilePath.

replaceExtensions :: FilePath -> [Text] -> FilePath Source

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

splitExtension :: FilePath -> (FilePath, Maybe Text)Source

splitExtension p = (dropExtension p, extension p)

splitExtensions :: FilePath -> (FilePath, [Text])Source

splitExtensions p = (dropExtensions p, extensions p)