Attempt to convert a
FilePath to human‐readable text.
If the path is decoded successfully, the result is a
Right
containing the decoded text. Successfully decoded text can be
converted back to the original path using
fromText.
If the path cannot be decoded, the result is a
Left containing
an approximation of the original path. If displayed to the user, this
value should be accompanied by some warning that the path has an
invalid encoding. Approximated text cannot be converted back to the
original path.
This function ignores the user’s locale, and assumes all file paths
are encoded in UTF8. If you need to display file paths with an unusual
or obscure encoding, use
encode and then decode them manually.
Since: 0.2