os-string

Library for manipulating Operating system strings.

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

LTS Haskell 24.35:	2.0.7
Stackage Nightly 2026-03-29:	2.0.10
Latest on Hackage:	2.0.10

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.10@sha256:7c2be4d5333786c0e1f6ed7b856c9424c03965013e161bbab07f94bf9a095196,3658

Module documentation for 2.0.10

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 8 packages in nightly-2026-03-29(full list with versions):

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

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.10 Jan 2026

fix build on GHC 9.14 wrt #40

2.0.9 Jan 2026

support MicroHS wrt #35
Switch from template-haskell to template-haskell-quasiquoter and -lift wrt #36

2.0.8 Aug 2025

Add safe conversions from ShortByteString #34

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