Data.ByteString.Lazy.Lens

Lazy ByteString lenses.

Documentation

packedBytes :: Iso' [Word8] ByteString

pack (or unpack) a list of bytes into a ByteString.

 packedBytes ≡ from unpackedBytes
 pack x ≡  x ^. packedBytes
 unpack x ≡ x ^. from packedBytes

>>> [104,101,108,108,111]^.packedBytes == Char8.pack "hello"
True

unpackedBytes :: Iso' ByteString [Word8]

unpack (or pack) a ByteString into a list of bytes

 unpackedBytes ≡ from packedBytes
 unpack x ≡ x ^. unpackedBytes
 pack x ≡  x ^. from unpackedBytes

>>> "hello"^.packedChars.unpackedBytes
[104,101,108,108,111]

bytes :: IndexedTraversal' Int64 ByteString Word8

Traverse the individual bytes in a ByteString.

This Traversal walks each strict ByteString chunk in a tree-like fashion enable zippers to seek to locations more quickly and accelerate many monoidal queries, but up to associativity (and constant factors) it is equivalent to the much slower:

 bytes ≡ unpackedBytes . traversed

>>> anyOf bytes (== 0x80) (Char8.pack "hello")
False

packedChars :: Iso' String ByteString

pack (or unpack) a list of characters into a ByteString.

When writing back to the ByteString it is assumed that every Char lies between '\x00' and '\xff'.

 packedChars ≡ from unpackedChars
 pack x ≡ x ^. packedChars
 unpack x ≡ x ^. from packedChars

>>> "hello"^.packedChars.each.re (base 16 . enum).to (\x -> if Prelude.length x == 1 then '0':x else x)
"68656c6c6f"

unpackedChars :: Iso' ByteString String

unpack (or pack) a list of characters into a ByteString

When writing back to the ByteString it is assumed that every Char lies between '\x00' and '\xff'.

 unpackedChars ≡ from packedChars
 unpack x ≡ x ^. unpackedChars
 pack x ≡ x ^. from unpackedChars

>>> [104,101,108,108,111]^.packedBytes.unpackedChars
"hello"

chars :: IndexedTraversal' Int64 ByteString Char

Traverse the individual bytes in a ByteString as characters.

When writing back to the ByteString it is assumed that every Char lies between '\x00' and '\xff'.

This Traversal walks each strict ByteString chunk in a tree-like fashion enable zippers to seek to locations more quickly and accelerate many monoidal queries, but up to associativity (and constant factors) it is equivalent to:

 chars = unpackedChars . traversed

>>> anyOf chars (== 'h') "hello"
True