Data.Text.Lens

Documentation

class IsText t where

Traversals for strict or lazy Text

Methods

packed :: Iso' String t

This isomorphism can be used to pack (or unpack) strict or lazy Text.

 pack x ≡ x ^. packed
 unpack x ≡ x ^. from packed
 packed ≡ from unpacked

builder :: Iso' t Builder

Convert between strict or lazy Text and a Builder.

 fromText x ≡ x ^. builder

text :: IndexedTraversal' Int t Char

Traverse the individual characters in strict or lazy Text.

 text = unpacked . traversed

Instances

IsText String

IsText Text

IsText Text

unpacked :: IsText t => Iso' t String

This isomorphism can be used to unpack (or pack) both strict or lazy Text.

 unpack x ≡ x ^. unpacked
 pack x ≡ x ^. from unpacked

This Iso is provided for notational convenience rather than out of great need, since

 unpacked ≡ from packed

_Text :: IsText t => Iso' t String

This is an alias for unpacked that makes it clearer how to use it with ('#').

 _Text = from packed

>>> _Text # "hello" :: Strict.Text
"hello"