text: An efficient packed Unicode text type.
An efficient packed, immutable Unicode text type (both strict and lazy), with a powerful loop fusion optimization framework.
The Text type represents Unicode character strings, in a time and
space-efficient manner. This package provides text processing
capabilities that are optimized for performance critical use, both
in terms of large data quantities and high speed.
The Text type provides character-encoding, type-safe case
conversion via whole-string case conversion functions (see Data.Text).
It also provides a range of functions for converting Text values to
and from ByteStrings, using several standard encodings
(see Data.Text.Encoding).
Efficient locale-sensitive support for text IO is also supported (see Data.Text.IO).
These modules are intended to be imported qualified, to avoid name clashes with Prelude functions, e.g.
import qualified Data.Text as T
ICU Support
To use an extended and very rich family of functions for working with Unicode text (including normalization, regular expressions, non-standard encodings, text breaking, and locales), see the text-icu package based on the well-respected and liberally licensed ICU library.
Internal Representation: UTF-16 vs. UTF-8
Currently the text library uses UTF-16 as its internal representation
which is neither a fixed-width nor always the most dense representation
for Unicode text. We're currently investigating the feasibility
of changing Text's internal representation to UTF-8
and if you need such a Text type right now you might be interested in using the spin-off
packages text-utf8 and
text-short.
[Skip to Readme]
Modules
[Index] [Quick Jump]
- Data
- Data.Text
- Data.Text.Array
- Data.Text.Encoding
- Data.Text.Foreign
- Data.Text.IO
- Data.Text.Internal
- Data.Text.Lazy
- Data.Text.Read
- Data.Text.Unsafe
- Data.Text
Flags
Manual Flags
| Name | Description | Default |
|---|---|---|
| developer | operate in developer mode | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- text-1.2.5.0.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
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
For package maintainers and hackage trustees
Candidates
- No Candidates
| Versions [RSS] | 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.7.0.1, 0.7.1.0, 0.7.2.1, 0.8.0.0, 0.8.1.0, 0.9.0.0, 0.9.0.1, 0.9.1.0, 0.10.0.0, 0.10.0.1, 0.10.0.2, 0.11.0.0, 0.11.0.1, 0.11.0.2, 0.11.0.3, 0.11.0.4, 0.11.0.5, 0.11.0.6, 0.11.0.7, 0.11.0.8, 0.11.1.0, 0.11.1.1, 0.11.1.2, 0.11.1.3, 0.11.1.5, 0.11.1.6, 0.11.1.7, 0.11.1.8, 0.11.1.9, 0.11.1.10, 0.11.1.11, 0.11.1.12, 0.11.1.13, 0.11.2.0, 0.11.2.1, 0.11.2.2, 0.11.2.3, 0.11.3.0, 0.11.3.1, 1.0.0.0, 1.0.0.1, 1.1.0.0, 1.1.0.1, 1.1.1.0, 1.1.1.1, 1.1.1.2, 1.1.1.3, 1.1.1.4, 1.2.0.0, 1.2.0.2, 1.2.0.3, 1.2.0.4, 1.2.0.5, 1.2.0.6, 1.2.1.0, 1.2.1.1, 1.2.1.2, 1.2.1.3, 1.2.2.0, 1.2.2.1, 1.2.2.2, 1.2.3.0, 1.2.3.1, 1.2.3.2, 1.2.4.0, 1.2.4.1, 1.2.5.0, 2.0, 2.0.1, 2.0.2, 2.1, 2.1.1, 2.1.2, 2.1.3 |
|---|---|
| Change log | changelog.md |
| Dependencies | array (>=0.3 && <0.6), base (>=4.9 && <5), binary (>=0.5 && <0.9), bytestring (>=0.10.4 && <0.13), deepseq (>=1.1 && <1.6), ghc-prim (>=0.2 && <0.14), template-haskell (>=2.5 && <2.24) [details] |
| Tested with | ghc ==9.0.1, ghc ==8.10.4, ghc ==8.8.4, ghc ==8.6.5, ghc ==8.4.4, ghc ==8.2.2, ghc ==8.0.2 |
| License | BSD-2-Clause |
| Copyright | 2009-2011 Bryan O'Sullivan, 2008-2009 Tom Harper |
| Author | Bryan O'Sullivan <bos@serpentine.com> |
| Maintainer | Haskell Text Team <andrew.lelechenko@gmail.com>, Core Libraries Committee |
| Revised | Revision 2 made by Bodigrim at 2025-05-13T22:29:08Z |
| Category | Data, Text |
| Home page | https://github.com/haskell/text |
| Bug tracker | https://github.com/haskell/text/issues |
| Source repo | head: git clone https://github.com/haskell/text |
| Uploaded | by Bodigrim at 2021-08-08T19:28:37Z |
| Distributions | Arch:2.0.2, Fedora:2.1.1, FreeBSD:1.2.1.3 |
| Reverse Dependencies | 5813 direct, 9514 indirect [details] |
| Downloads | 627061 total (270 in the last 30 days) |
| Rating | 2.75 (votes: 26) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] All reported builds failed as of 2021-08-08 [all 1 reports] |
Readme for text-1.2.5.0
[back to package description]text: Fast, packed Unicode strings, using stream fusion 
This package provides the Data.Text library, a library for the space- and time-efficient manipulation of Unicode text in Haskell.
Get involved!
Please report bugs via the github issue tracker.
The main repo:
git clone git://github.com/haskell/text.git
To run benchmarks please clone and unpack test files:
git clone https://github.com/bos/text-test-data benchmarks/text-test-data
cd benchmarks/text-test-data
make
Authors
The base code for this library was originally written by Tom Harper, based on the stream fusion framework developed by Roman Leshchinskiy, Duncan Coutts, and Don Stewart.
The core library was fleshed out, debugged, and tested by Bryan O'Sullivan bos@serpentine.com, and he is the current maintainer.