filepath
Library for manipulating FilePaths in a cross platform way.
https://github.com/haskell/filepath#readme
| Version on this page: | 1.4.2.2 |
| LTS Haskell 22.39: | 1.4.300.1 |
| Stackage Nightly 2024-10-31: | 1.4.200.1 |
| Latest on Hackage: | 1.5.3.0 |
filepath-1.4.2.2@sha256:3622cbc524093b18af0235249087546473ab04e9fe275967680e97755a9eae6b,2225Module documentation for 1.4.2.2
FilePath 
The filepath package provides functionality for manipulating FilePath values, and is shipped with GHC.
It provides three modules:
System.FilePath.Posixmanipulates POSIX/Linux styleFilePathvalues (with/as the path separator).System.FilePath.Windowsmanipulates Windows styleFilePathvalues (with either\or/as the path separator, and deals with drives).System.FilePathis an alias for the module appropriate to your platform.
All three modules provide the same API, and the same documentation (calling out differences in the different variants).
What is a FilePath?
In Haskell, the definition is type FilePath = String as of now. A Haskell String is a list of Unicode code points.
On unix, filenames don’t have a predefined encoding as per the
POSIX specification
and are passed as char[] to syscalls.
On windows (at least the API used by Win32) filepaths are UTF-16 strings.
This means that Haskell filepaths have to be converted to C-strings on unix (utilizing the current filesystem encoding) and to UTF-16 strings on windows.
Further, this is a low-level library and it makes no attempt at providing a more type safe variant for filepaths (e.g. by distinguishing between absolute and relative paths) and ensures no invariants (such as filepath validity).
For such libraries, check out the following: