utf8-conversions: A string conversion library that assumes utf8

[ bsd3, codec, data, library ] [ Propose Tags ]

Please see the README on GitHub at https://github.com/chemirea/utf8-conversions#readme

[Skip to Readme]
Versions [faq],,,,
Change log ChangeLog.md
Dependencies base (>=4.7 && <5), bytestring (>=0.10.4 && <0.11), text (>=1.0 && <1.3), text-short (>=0.1.1 && <0.1.4), utf8-string (>=1.0 && <1.2) [details]
License BSD-3-Clause
Copyright 2020 Shintaro Sakata
Author Shintaro Sakata
Maintainer shintaro.sakata.tokyo@gmail.com
Category Data, Codec
Home page https://github.com/chemirea/utf8-conversions#readme
Bug tracker https://github.com/chemirea/utf8-conversions/issues
Source repo head: git clone https://github.com/chemirea/utf8-conversions
Uploaded by chemirea at 2020-05-10T05:00:06Z
Distributions NixOS:
Downloads 375 total (2 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2020-05-10 [all 1 reports]


[Index] [Quick Jump]


Maintainer's Corner

For package maintainers and hackage trustees

Readme for utf8-conversions-

[back to package description]

utf8-conversions A string conversion library that assumes utf8

Build Status License

This package provides a Data.Convertible.Utf8 library for easy conversion of many string types in Haskell


import Data.Convertible.Utf8 (convert)

string :: String
string = "Hello world"

bytestring :: ByteString
bytestring = convert string

text :: Text
text = convert bytestring

A typeclass that represents something that can be converted. A Convertible a b instance represents an a that can be converted to a b.

class Convertible a b where
  convert :: a -> b


  • String
  • ByteString
  • ByteStringBuilder
  • LazyByteString
  • ByteStringShort
  • Text
  • LazyText
  • TextBuilder
  • TextShort

Supports type conversion between the above types. Byte string is assumed to be in utf-8 encoding.


String conversion in haskell is more difficult than in other languages and needs to be easier.

In particular, the OverloadedStrings pragma does not work properly when creating a ByteString.

So why not other conversion libraries? There are many other conversion libraries that use the Maybe type for safety or are not explicitly stated as utf8.

Libraries that use maybe types are very labor intensive. Libraries that do not explicitly state UTF8 are insecure

Therefore, this library clearly states that it assumes UTF8 and performs the conversion without using the MAYBE type, which is both safe and easy.

Get involved!

If there's a bug or a better way to convert, please report it!