text: An efficient packed Unicode text type.
This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.
Warnings:
- [option-o2] 'ghc-options: -O2' is rarely needed. Check that it is giving a real benefit and not just imposing longer compile times on your users.
An efficient packed, immutable Unicode text type (both strict and lazy).
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.
[Skip to Readme]
Properties
Modules
- Data
- Data.Text
- Data.Text.Array
- Data.Text.Encoding
- Data.Text.Encoding.Error
- Data.Text.Foreign
- Data.Text.IO
- Data.Text.IO.Utf8
- Data.Text.Internal
- Data.Text.Internal.ArrayUtils
- Data.Text.Internal.Builder
- Data.Text.Internal.Builder.Functions
- Int
- Data.Text.Internal.Builder.Int.Digits
- RealFloat
- Data.Text.Internal.Builder.RealFloat.Functions
- Data.Text.Internal.ByteStringCompat
- Data.Text.Internal.Encoding
- Data.Text.Internal.Encoding.Fusion
- Data.Text.Internal.Encoding.Fusion.Common
- Data.Text.Internal.Encoding.Utf16
- Data.Text.Internal.Encoding.Utf32
- Data.Text.Internal.Encoding.Utf8
- Data.Text.Internal.Encoding.Fusion
- Data.Text.Internal.Fusion
- Data.Text.Internal.Fusion.CaseMapping
- Data.Text.Internal.Fusion.Common
- Data.Text.Internal.Fusion.Size
- Data.Text.Internal.Fusion.Types
- Data.Text.Internal.IO
- Data.Text.Internal.Lazy
- Encoding
- Data.Text.Internal.Lazy.Encoding.Fusion
- Data.Text.Internal.Lazy.Fusion
- Data.Text.Internal.Lazy.Search
- Encoding
- Data.Text.Internal.PrimCompat
- Data.Text.Internal.Private
- Data.Text.Internal.Read
- Data.Text.Internal.Search
- Data.Text.Internal.StrictBuilder
- Data.Text.Internal.Unsafe
- Data.Text.Internal.Unsafe.Char
- Data.Text.Internal.Validate
- Data.Text.Internal.Validate.Native
- Data.Text.Internal.Validate.Simd
- Data.Text.Lazy
- Data.Text.Lazy.Builder
- Data.Text.Lazy.Builder.Int
- Data.Text.Lazy.Builder.RealFloat
- Data.Text.Lazy.Encoding
- Data.Text.Lazy.IO
- Data.Text.Lazy.Internal
- Data.Text.Lazy.Read
- Data.Text.Lazy.Builder
- Data.Text.Read
- Data.Text.Unsafe
- Data.Text
Flags
Manual Flags
| Name | Description | Default |
|---|---|---|
| developer | operate in developer mode | Disabled |
| simdutf | use simdutf library, causes Data.Text.Internal.Validate.Simd to be exposed | Enabled |
| pure-haskell | Don't use text's standard C routines NB: This feature is not fully implemented. Several C routines are still in use. When this flag is true, text will use pure Haskell variants of the routines. This is not recommended except for use with GHC's JavaScript backend. This flag also disables simdutf. | Disabled |
| extendedbenchmarks | Runs extra benchmarks which can be very slow. | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- text-2.1.4.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
Package maintainers
For package maintainers and hackage trustees
Readme for text-2.1.4
[back to package description]text 
Haskell library for space- and time-efficient operations over Unicode text.
Get involved!
Please report bugs via the github issue tracker.
The main repo:
git clone https://github.com/haskell/text
To run benchmarks please clone and unpack test files:
cd text
git clone https://github.com/haskell/text-test-data benchmarks/text-test-data
make -Cbenchmarks/text-test-data
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. Transition from UTF-16 to UTF-8 is by Andrew Lelechenko.