Text package:text

A time and space-efficient implementation of Unicode text. Suitable for performance critical use, both in terms of large data quantities and high speed. Note: Read below the synopsis for important notes on the use of this module. This module is intended to be imported qualified, to avoid name clashes with Prelude functions, e.g.

import qualified Data.Text as T

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.

A space efficient, packed, unboxed Unicode text type.

An efficient packed Unicode text type. 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.

Construct a Text without invisibly pinning its byte array in memory if its length has dwindled to zero. It ensures that empty Text values are shared.

Copy Text in a StrictBuilder

Deprecated: Use text instead

Type synonym for the strict flavour of Text.

A delayed representation of strict Text.

Use StrictBuilder to build Text.

A useful show-like function for debugging purposes.

O(1). A Builder taking a lazy Text, satisfying

• toLazyText (fromLazyText t) = t

O(1). A Builder taking a Text, satisfying

• toLazyText (fromText t) = fromChunks
  [t]

O(n). Extract a lazy Text from a Builder with a default buffer size. The construction work takes place if and when the relevant part of the lazy Text is demanded.

O(n). Extract a lazy Text from a Builder, using the given size for the initial buffer. The construction work takes place if and when the relevant part of the lazy Text is demanded. If the initial buffer is too small to hold all data, subsequent buffers will be the default buffer size.

Type synonym for the lazy flavour of Text.

Copy Text in a StrictBuilder

Use StrictBuilder to build Text.