os-string

Library for manipulating Operating system strings.

https://github.com/haskell/os-string/blob/master/README.md

Version on this page:	2.0.7
LTS Haskell 24.18:	2.0.7
Stackage Nightly 2025-11-04:	2.0.7
Latest on Hackage:	2.0.8

See all snapshots os-string appears in

BSD-3-Clause licensed and maintained by Julian Ospald

This version can be pinned in stack with:os-string-2.0.7@sha256:2efc549644dd418bad537d1601fdd437c440d807265016bd993b6996c679ad2f,3298

Module documentation for 2.0.7

System
- System.OsString
  - System.OsString.Data
    - System.OsString.Data.ByteString
      - System.OsString.Data.ByteString.Short
        System.OsString.Data.ByteString.Short.Internal
        
        System.OsString.Data.ByteString.Short.Word16
  - System.OsString.Encoding
    - System.OsString.Encoding.Internal
  - System.OsString.Internal
    - System.OsString.Internal.Exception
    - System.OsString.Internal.Types
  - System.OsString.Posix
  - System.OsString.Windows

Depends on 5 packages(full list with versions):

base, bytestring, deepseq, exceptions, template-haskell

Used by 7 packages in nightly-2025-11-04(full list with versions):

directory-ospath-streaming, emacs-module, filepath, ghc, ghc-lib, ghc-lib-parser, hashable

OsString

This package provides functionality for manipulating @OsString@ values, and is shipped with <https://www.haskell.org/ghc/ GHC>.

Changes

Changelog for `os-string` package

2.0.7 Nov 2024

don’t catch asynchronous exceptions during encoding/decoding wrt #22

2.0.6 Jun 2024

add fromString on windows
add fromBytestring on unix

2.0.5 Jun 2024

Add decodeLE/encodeLE and deprecate decodeFS/encodeFS (pointing users to System.OsPath instead), fixes #19

2.0.4 Jun 2024

Use TemplateHaskellQuotes rather than TemplateHaskell extension wrt #21

2.0.3 May 2024

Fix length function wrt #17

2.0.2.2 May 2024

Fix compilation on big-endian arches, by Andrew Lelechenko

2.0.2.1 Apr 2024

Fix compabitiliby with GHC 9.10

2.0.2 Dec 2023

Implement coercionToPlatformTypes, fixes #4

2.0.1 Dec 2023

add unsafeEncodeUtf, fixes #5

2.0.0 Nov 2023

Split out OsString modules from filepath library
add more bytestring like functions (index/search/etc.)

1.0.0 Nov 2023

dummy release to avoid name clashes with filepath <1.5