text-show: Efficient conversion of values into Text

[ bsd3, library, text ] [ Propose Tags ]

text-show offers a replacement for the Show typeclass intended for use with Text instead of Strings. This package was created in the spirit of bytestring-show.

At the moment, text-show provides Show instances for most data types in the array, base, bytestring, and text packages. Therefore, much of the source code for text-show consists of borrowed code from those packages in order to ensure that the behaviors of the two Show typeclasses coincide.

For most uses, simply importing Text.Show.Text will suffice:

module Main where

import Data.Text (Text)
import Prelude hiding (Show(..), print)
import Text.Show.Text

hello :: Text
hello = show (Just "Hello, World!")

main :: IO ()
main = print hello

If you desire it, there are also monomorphic versions of the showb function available in the submodules of Text.Show.Text. A naming convention is present in which functions that show different values depending on the precedence end with Prec (e.g., showbIntPrec), whereas functions that show the same values regardless of precedence do not end with Prec (e.g., showbBool).

Support for automatically deriving Show instances can be found in the Text.Show.Text.TH and Text.Show.Text.Generic modules. If you don't know which one to use, use Text.Show.Text.TH.


[Skip to Readme]

Modules

[Index]

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.1.0, 0.4, 0.4.1, 0.5, 0.6, 0.6.0.1, 0.7, 0.7.0.1, 0.8, 0.8.1, 0.8.1.1, 1, 2, 2.1, 2.1.1, 2.1.2, 3, 3.0.1, 3.1, 3.2, 3.2.1, 3.2.2, 3.3, 3.4, 3.4.1, 3.4.1.1, 3.6, 3.6.2, 3.7, 3.7.1, 3.7.2, 3.7.3, 3.7.4, 3.7.5, 3.8, 3.8.1, 3.8.2, 3.8.3, 3.8.4, 3.8.5, 3.9, 3.9.1, 3.9.2, 3.9.3, 3.9.4, 3.9.5, 3.9.6, 3.9.7, 3.10, 3.10.1, 3.10.2, 3.10.3, 3.10.4, 3.10.5, 3.11
Change log CHANGELOG.md
Dependencies array (>=0.3 && <0.6), base (>=4.2 && <5), bytestring (>=0.9 && <0.11), bytestring-builder, ghc-prim, integer-gmp (>=1.0 && <1.1), nats (>=0.1 && <2), semigroups (>=0.16.1 && <0.17), tagged (>=0.4.4 && <1), template-haskell (>=2.4 && <2.11), text (>=0.8 && <1.3), transformers (>=0.2.1 && <0.5), void (>=0.5 && <1) [details]
License BSD-3-Clause
Copyright (C) 2014-2015 Ryan Scott
Author Ryan Scott
Maintainer Ryan Scott <ryan.gl.scott@gmail.com>
Revised Revision 2 made by HerbertValerioRiedel at 2016-02-05T09:49:20Z
Category Text
Home page https://github.com/RyanGlScott/text-show
Bug tracker https://github.com/RyanGlScott/text-show/issues
Source repo head: git clone git://github.com/RyanGlScott/text-show.git
Uploaded by ryanglscott at 2015-03-27T22:08:46Z
Distributions Arch:3.10.3, Debian:3.8.5, LTSHaskell:3.10.5, NixOS:3.10.5, Stackage:3.11
Reverse Dependencies 59 direct, 1200 indirect [details]
Downloads 58256 total (261 in the last 30 days)
Rating 2.25 (votes: 5) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-03-27 [all 1 reports]

Readme for text-show-0.7.0.1

[back to package description]

text-show Hackage version Build Status

text-show offers a replacement for the Show typeclass intended for use with Text instead of Strings. This package was created in the spirit of bytestring-show.

At the moment, text-show provides Show instances for most data types in the array, base, bytestring, and text packages. Therefore, much of the source code for text-show consists of borrowed code from those packages in order to ensure that the behaviors of the two Show typeclasses coincide.

For most uses, simply importing Text.Show.Text will suffice:

module Main where

import Data.Text (Text)
import Prelude hiding (Show(..), print)
import Text.Show.Text

hello :: Text
hello = show (Just "Hello, World!")

main :: IO ()
main = print hello

If you desire it, there are also monomorphic versions of the showb function available in the submodules of Text.Show.Text. A naming convention is present in which functions that show different values depending on the precedence end with Prec(e.g., showbIntPrec), whereas functions that show the same values regardless of precedence do not end with Prec (e.g., showbBool).