<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>Data/ByteString/Lazy.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE CPP #-}</span> <a name="line-2"></a><span class='hs-comment'>{-# OPTIONS_GHC -fno-warn-incomplete-patterns #-}</span> <a name="line-3"></a><span class='hs-comment'>{-# OPTIONS_HADDOCK prune #-}</span> <a name="line-4"></a> <a name="line-5"></a><span class='hs-comment'>-- |</span> <a name="line-6"></a><span class='hs-comment'>-- Module : Data.ByteString.Lazy</span> <a name="line-7"></a><span class='hs-comment'>-- Copyright : (c) Don Stewart 2006</span> <a name="line-8"></a><span class='hs-comment'>-- (c) Duncan Coutts 2006</span> <a name="line-9"></a><span class='hs-comment'>-- License : BSD-style</span> <a name="line-10"></a><span class='hs-comment'>--</span> <a name="line-11"></a><span class='hs-comment'>-- Maintainer : dons@galois.com</span> <a name="line-12"></a><span class='hs-comment'>-- Stability : experimental</span> <a name="line-13"></a><span class='hs-comment'>-- Portability : portable</span> <a name="line-14"></a><span class='hs-comment'>-- </span> <a name="line-15"></a><span class='hs-comment'>-- A time and space-efficient implementation of lazy byte vectors</span> <a name="line-16"></a><span class='hs-comment'>-- using lists of packed 'Word8' arrays, suitable for high performance</span> <a name="line-17"></a><span class='hs-comment'>-- use, both in terms of large data quantities, or high speed</span> <a name="line-18"></a><span class='hs-comment'>-- requirements. Byte vectors are encoded as lazy lists of strict 'Word8'</span> <a name="line-19"></a><span class='hs-comment'>-- arrays of bytes. They provide a means to manipulate large byte vectors</span> <a name="line-20"></a><span class='hs-comment'>-- without requiring the entire vector be resident in memory.</span> <a name="line-21"></a><span class='hs-comment'>--</span> <a name="line-22"></a><span class='hs-comment'>-- Some operations, such as concat, append, reverse and cons, have</span> <a name="line-23"></a><span class='hs-comment'>-- better complexity than their "Data.ByteString" equivalents, due to</span> <a name="line-24"></a><span class='hs-comment'>-- optimisations resulting from the list spine structure. And for other</span> <a name="line-25"></a><span class='hs-comment'>-- operations lazy ByteStrings are usually within a few percent of</span> <a name="line-26"></a><span class='hs-comment'>-- strict ones, but with better heap usage. For data larger than the</span> <a name="line-27"></a><span class='hs-comment'>-- available memory, or if you have tight memory constraints, this</span> <a name="line-28"></a><span class='hs-comment'>-- module will be the only option. The default chunk size is 64k, which</span> <a name="line-29"></a><span class='hs-comment'>-- should be good in most circumstances. For people with large L2</span> <a name="line-30"></a><span class='hs-comment'>-- caches, you may want to increase this to fit your cache.</span> <a name="line-31"></a><span class='hs-comment'>--</span> <a name="line-32"></a><span class='hs-comment'>-- This module is intended to be imported @qualified@, to avoid name</span> <a name="line-33"></a><span class='hs-comment'>-- clashes with "Prelude" functions. eg.</span> <a name="line-34"></a><span class='hs-comment'>--</span> <a name="line-35"></a><span class='hs-comment'>-- > import qualified Data.ByteString.Lazy as B</span> <a name="line-36"></a><span class='hs-comment'>--</span> <a name="line-37"></a><span class='hs-comment'>-- Original GHC implementation by Bryan O\'Sullivan.</span> <a name="line-38"></a><span class='hs-comment'>-- Rewritten to use 'Data.Array.Unboxed.UArray' by Simon Marlow.</span> <a name="line-39"></a><span class='hs-comment'>-- Rewritten to support slices and use 'Foreign.ForeignPtr.ForeignPtr'</span> <a name="line-40"></a><span class='hs-comment'>-- by David Roundy.</span> <a name="line-41"></a><span class='hs-comment'>-- Polished and extended by Don Stewart.</span> <a name="line-42"></a><span class='hs-comment'>-- Lazy variant by Duncan Coutts and Don Stewart.</span> <a name="line-43"></a><span class='hs-comment'>--</span> <a name="line-44"></a> <a name="line-45"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Lazy</span> <span class='hs-layout'>(</span> <a name="line-46"></a> <a name="line-47"></a> <span class='hs-comment'>-- * The @ByteString@ type</span> <a name="line-48"></a> <span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- instances: Eq, Ord, Show, Read, Data, Typeable</span> <a name="line-49"></a> <a name="line-50"></a> <span class='hs-comment'>-- * Introducing and eliminating 'ByteString's</span> <a name="line-51"></a> <span class='hs-varid'>empty</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString</span> <a name="line-52"></a> <span class='hs-varid'>singleton</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString</span> <a name="line-53"></a> <span class='hs-varid'>pack</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [Word8] -> ByteString</span> <a name="line-54"></a> <span class='hs-varid'>unpack</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [Word8]</span> <a name="line-55"></a> <span class='hs-varid'>fromChunks</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [Strict.ByteString] -> ByteString</span> <a name="line-56"></a> <span class='hs-varid'>toChunks</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [Strict.ByteString]</span> <a name="line-57"></a> <a name="line-58"></a> <span class='hs-comment'>-- * Basic interface</span> <a name="line-59"></a> <span class='hs-varid'>cons</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> ByteString</span> <a name="line-60"></a> <span class='hs-varid'>cons'</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> ByteString</span> <a name="line-61"></a> <span class='hs-varid'>snoc</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Word8 -> ByteString</span> <a name="line-62"></a> <span class='hs-varid'>append</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> ByteString</span> <a name="line-63"></a> <span class='hs-varid'>head</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Word8</span> <a name="line-64"></a> <span class='hs-varid'>uncons</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Maybe (Word8, ByteString)</span> <a name="line-65"></a> <span class='hs-varid'>last</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Word8</span> <a name="line-66"></a> <span class='hs-varid'>tail</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-67"></a> <span class='hs-varid'>init</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-68"></a> <span class='hs-varid'>null</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Bool</span> <a name="line-69"></a> <span class='hs-varid'>length</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Int64</span> <a name="line-70"></a> <a name="line-71"></a> <span class='hs-comment'>-- * Transforming ByteStrings</span> <a name="line-72"></a> <span class='hs-varid'>map</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8) -> ByteString -> ByteString</span> <a name="line-73"></a> <span class='hs-varid'>reverse</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-74"></a> <span class='hs-varid'>intersperse</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> ByteString</span> <a name="line-75"></a> <span class='hs-varid'>intercalate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString] -> ByteString</span> <a name="line-76"></a> <span class='hs-varid'>transpose</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> [ByteString]</span> <a name="line-77"></a> <a name="line-78"></a> <span class='hs-comment'>-- * Reducing 'ByteString's (folds)</span> <a name="line-79"></a> <span class='hs-varid'>foldl</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (a -> Word8 -> a) -> a -> ByteString -> a</span> <a name="line-80"></a> <span class='hs-varid'>foldl'</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (a -> Word8 -> a) -> a -> ByteString -> a</span> <a name="line-81"></a> <span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8 -> Word8) -> ByteString -> Word8</span> <a name="line-82"></a> <span class='hs-varid'>foldl1'</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8 -> Word8) -> ByteString -> Word8</span> <a name="line-83"></a> <span class='hs-varid'>foldr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> a -> a) -> a -> ByteString -> a</span> <a name="line-84"></a> <span class='hs-varid'>foldr1</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8 -> Word8) -> ByteString -> Word8</span> <a name="line-85"></a> <a name="line-86"></a> <span class='hs-comment'>-- ** Special folds</span> <a name="line-87"></a> <span class='hs-varid'>concat</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> ByteString</span> <a name="line-88"></a> <span class='hs-varid'>concatMap</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> ByteString) -> ByteString -> ByteString</span> <a name="line-89"></a> <span class='hs-varid'>any</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> Bool</span> <a name="line-90"></a> <span class='hs-varid'>all</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> Bool</span> <a name="line-91"></a> <span class='hs-varid'>maximum</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Word8</span> <a name="line-92"></a> <span class='hs-varid'>minimum</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Word8</span> <a name="line-93"></a> <a name="line-94"></a> <span class='hs-comment'>-- * Building ByteStrings</span> <a name="line-95"></a> <span class='hs-comment'>-- ** Scans</span> <a name="line-96"></a> <span class='hs-varid'>scanl</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8 -> Word8) -> Word8 -> ByteString -> ByteString</span> <a name="line-97"></a><span class='hs-comment'>-- scanl1, -- :: (Word8 -> Word8 -> Word8) -> ByteString -> ByteString</span> <a name="line-98"></a><span class='hs-comment'>-- scanr, -- :: (Word8 -> Word8 -> Word8) -> Word8 -> ByteString -> ByteString</span> <a name="line-99"></a><span class='hs-comment'>-- scanr1, -- :: (Word8 -> Word8 -> Word8) -> ByteString -> ByteString</span> <a name="line-100"></a> <a name="line-101"></a> <span class='hs-comment'>-- ** Accumulating maps</span> <a name="line-102"></a> <span class='hs-varid'>mapAccumL</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (acc -> Word8 -> (acc, Word8)) -> acc -> ByteString -> (acc, ByteString)</span> <a name="line-103"></a> <span class='hs-varid'>mapAccumR</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (acc -> Word8 -> (acc, Word8)) -> acc -> ByteString -> (acc, ByteString)</span> <a name="line-104"></a> <a name="line-105"></a> <span class='hs-comment'>-- ** Infinite ByteStrings</span> <a name="line-106"></a> <span class='hs-varid'>repeat</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString</span> <a name="line-107"></a> <span class='hs-varid'>replicate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> Word8 -> ByteString</span> <a name="line-108"></a> <span class='hs-varid'>cycle</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-109"></a> <span class='hs-varid'>iterate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8) -> Word8 -> ByteString</span> <a name="line-110"></a> <a name="line-111"></a> <span class='hs-comment'>-- ** Unfolding ByteStrings</span> <a name="line-112"></a> <span class='hs-varid'>unfoldr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (a -> Maybe (Word8, a)) -> a -> ByteString</span> <a name="line-113"></a> <a name="line-114"></a> <span class='hs-comment'>-- * Substrings</span> <a name="line-115"></a> <a name="line-116"></a> <span class='hs-comment'>-- ** Breaking strings</span> <a name="line-117"></a> <span class='hs-varid'>take</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> ByteString -> ByteString</span> <a name="line-118"></a> <span class='hs-varid'>drop</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> ByteString -> ByteString</span> <a name="line-119"></a> <span class='hs-varid'>splitAt</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> ByteString -> (ByteString, ByteString)</span> <a name="line-120"></a> <span class='hs-varid'>takeWhile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> ByteString</span> <a name="line-121"></a> <span class='hs-varid'>dropWhile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> ByteString</span> <a name="line-122"></a> <span class='hs-varid'>span</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> (ByteString, ByteString)</span> <a name="line-123"></a> <span class='hs-varid'>break</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> (ByteString, ByteString)</span> <a name="line-124"></a> <span class='hs-varid'>group</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-125"></a> <span class='hs-varid'>groupBy</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8 -> Bool) -> ByteString -> [ByteString]</span> <a name="line-126"></a> <span class='hs-varid'>inits</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-127"></a> <span class='hs-varid'>tails</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-128"></a> <a name="line-129"></a> <span class='hs-comment'>-- ** Breaking into many substrings</span> <a name="line-130"></a> <span class='hs-varid'>split</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> [ByteString]</span> <a name="line-131"></a> <span class='hs-varid'>splitWith</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> [ByteString]</span> <a name="line-132"></a> <a name="line-133"></a> <span class='hs-comment'>-- * Predicates</span> <a name="line-134"></a> <span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Bool</span> <a name="line-135"></a> <span class='hs-varid'>isSuffixOf</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Bool</span> <a name="line-136"></a><span class='hs-comment'>-- isInfixOf, -- :: ByteString -> ByteString -> Bool</span> <a name="line-137"></a> <a name="line-138"></a> <span class='hs-comment'>-- ** Search for arbitrary substrings</span> <a name="line-139"></a><span class='hs-comment'>-- isSubstringOf, -- :: ByteString -> ByteString -> Bool</span> <a name="line-140"></a><span class='hs-comment'>-- findSubstring, -- :: ByteString -> ByteString -> Maybe Int</span> <a name="line-141"></a><span class='hs-comment'>-- findSubstrings, -- :: ByteString -> ByteString -> [Int]</span> <a name="line-142"></a> <a name="line-143"></a> <span class='hs-comment'>-- * Searching ByteStrings</span> <a name="line-144"></a> <a name="line-145"></a> <span class='hs-comment'>-- ** Searching by equality</span> <a name="line-146"></a> <span class='hs-varid'>elem</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> Bool</span> <a name="line-147"></a> <span class='hs-varid'>notElem</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> Bool</span> <a name="line-148"></a> <a name="line-149"></a> <span class='hs-comment'>-- ** Searching with a predicate</span> <a name="line-150"></a> <span class='hs-varid'>find</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> Maybe Word8</span> <a name="line-151"></a> <span class='hs-varid'>filter</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> ByteString</span> <a name="line-152"></a> <span class='hs-varid'>partition</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> (ByteString, ByteString)</span> <a name="line-153"></a> <a name="line-154"></a> <span class='hs-comment'>-- * Indexing ByteStrings</span> <a name="line-155"></a> <span class='hs-varid'>index</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Int64 -> Word8</span> <a name="line-156"></a> <span class='hs-varid'>elemIndex</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> Maybe Int64</span> <a name="line-157"></a> <span class='hs-varid'>elemIndices</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> [Int64]</span> <a name="line-158"></a> <span class='hs-varid'>findIndex</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> Maybe Int64</span> <a name="line-159"></a> <span class='hs-varid'>findIndices</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Bool) -> ByteString -> [Int64]</span> <a name="line-160"></a> <span class='hs-varid'>count</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Word8 -> ByteString -> Int64</span> <a name="line-161"></a> <a name="line-162"></a> <span class='hs-comment'>-- * Zipping and unzipping ByteStrings</span> <a name="line-163"></a> <span class='hs-varid'>zip</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> [(Word8,Word8)]</span> <a name="line-164"></a> <span class='hs-varid'>zipWith</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Word8 -> Word8 -> c) -> ByteString -> ByteString -> [c]</span> <a name="line-165"></a> <span class='hs-varid'>unzip</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [(Word8,Word8)] -> (ByteString,ByteString)</span> <a name="line-166"></a> <a name="line-167"></a> <span class='hs-comment'>-- * Ordered ByteStrings</span> <a name="line-168"></a><span class='hs-comment'>-- sort, -- :: ByteString -> ByteString</span> <a name="line-169"></a> <a name="line-170"></a> <span class='hs-comment'>-- * Low level conversions</span> <a name="line-171"></a> <span class='hs-comment'>-- ** Copying ByteStrings</span> <a name="line-172"></a> <span class='hs-varid'>copy</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-173"></a><span class='hs-comment'>-- defrag, -- :: ByteString -> ByteString</span> <a name="line-174"></a> <a name="line-175"></a> <span class='hs-comment'>-- * I\/O with 'ByteString's</span> <a name="line-176"></a> <a name="line-177"></a> <span class='hs-comment'>-- ** Standard input and output</span> <a name="line-178"></a> <span class='hs-varid'>getContents</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: IO ByteString</span> <a name="line-179"></a> <span class='hs-varid'>putStr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> IO ()</span> <a name="line-180"></a> <span class='hs-varid'>putStrLn</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> IO ()</span> <a name="line-181"></a> <span class='hs-varid'>interact</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (ByteString -> ByteString) -> IO ()</span> <a name="line-182"></a> <a name="line-183"></a> <span class='hs-comment'>-- ** Files</span> <a name="line-184"></a> <span class='hs-varid'>readFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> IO ByteString</span> <a name="line-185"></a> <span class='hs-varid'>writeFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> ByteString -> IO ()</span> <a name="line-186"></a> <span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> ByteString -> IO ()</span> <a name="line-187"></a> <a name="line-188"></a> <span class='hs-comment'>-- ** I\/O with Handles</span> <a name="line-189"></a> <span class='hs-varid'>hGetContents</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> IO ByteString</span> <a name="line-190"></a> <span class='hs-varid'>hGet</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> Int -> IO ByteString</span> <a name="line-191"></a> <span class='hs-varid'>hGetNonBlocking</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> Int -> IO ByteString</span> <a name="line-192"></a> <span class='hs-varid'>hPut</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> ByteString -> IO ()</span> <a name="line-193"></a> <span class='hs-varid'>hPutStr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> ByteString -> IO ()</span> <a name="line-194"></a> <a name="line-195"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-196"></a> <a name="line-197"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Prelude</span> <span class='hs-varid'>hiding</span> <a name="line-198"></a> <span class='hs-layout'>(</span><span class='hs-varid'>reverse</span><span class='hs-layout'>,</span><span class='hs-varid'>head</span><span class='hs-layout'>,</span><span class='hs-varid'>tail</span><span class='hs-layout'>,</span><span class='hs-varid'>last</span><span class='hs-layout'>,</span><span class='hs-varid'>init</span><span class='hs-layout'>,</span><span class='hs-varid'>null</span><span class='hs-layout'>,</span><span class='hs-varid'>length</span><span class='hs-layout'>,</span><span class='hs-varid'>map</span><span class='hs-layout'>,</span><span class='hs-varid'>lines</span><span class='hs-layout'>,</span><span class='hs-varid'>foldl</span><span class='hs-layout'>,</span><span class='hs-varid'>foldr</span><span class='hs-layout'>,</span><span class='hs-varid'>unlines</span> <a name="line-199"></a> <span class='hs-layout'>,</span><span class='hs-varid'>concat</span><span class='hs-layout'>,</span><span class='hs-varid'>any</span><span class='hs-layout'>,</span><span class='hs-varid'>take</span><span class='hs-layout'>,</span><span class='hs-varid'>drop</span><span class='hs-layout'>,</span><span class='hs-varid'>splitAt</span><span class='hs-layout'>,</span><span class='hs-varid'>takeWhile</span><span class='hs-layout'>,</span><span class='hs-varid'>dropWhile</span><span class='hs-layout'>,</span><span class='hs-varid'>span</span><span class='hs-layout'>,</span><span class='hs-varid'>break</span><span class='hs-layout'>,</span><span class='hs-varid'>elem</span><span class='hs-layout'>,</span><span class='hs-varid'>filter</span><span class='hs-layout'>,</span><span class='hs-varid'>maximum</span> <a name="line-200"></a> <span class='hs-layout'>,</span><span class='hs-varid'>minimum</span><span class='hs-layout'>,</span><span class='hs-varid'>all</span><span class='hs-layout'>,</span><span class='hs-varid'>concatMap</span><span class='hs-layout'>,</span><span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span><span class='hs-varid'>foldr1</span><span class='hs-layout'>,</span><span class='hs-varid'>scanl</span><span class='hs-layout'>,</span> <span class='hs-varid'>scanl1</span><span class='hs-layout'>,</span> <span class='hs-varid'>scanr</span><span class='hs-layout'>,</span> <span class='hs-varid'>scanr1</span> <a name="line-201"></a> <span class='hs-layout'>,</span><span class='hs-varid'>repeat</span><span class='hs-layout'>,</span> <span class='hs-varid'>cycle</span><span class='hs-layout'>,</span> <span class='hs-varid'>interact</span><span class='hs-layout'>,</span> <span class='hs-varid'>iterate</span><span class='hs-layout'>,</span><span class='hs-varid'>readFile</span><span class='hs-layout'>,</span><span class='hs-varid'>writeFile</span><span class='hs-layout'>,</span><span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span><span class='hs-varid'>replicate</span> <a name="line-202"></a> <span class='hs-layout'>,</span><span class='hs-varid'>getContents</span><span class='hs-layout'>,</span><span class='hs-varid'>getLine</span><span class='hs-layout'>,</span><span class='hs-varid'>putStr</span><span class='hs-layout'>,</span><span class='hs-varid'>putStrLn</span> <span class='hs-layout'>,</span><span class='hs-varid'>zip</span><span class='hs-layout'>,</span><span class='hs-varid'>zipWith</span><span class='hs-layout'>,</span><span class='hs-varid'>unzip</span><span class='hs-layout'>,</span><span class='hs-varid'>notElem</span><span class='hs-layout'>)</span> <a name="line-203"></a> <a name="line-204"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>L</span> <span class='hs-comment'>-- L for list/lazy</span> <a name="line-205"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>P</span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- type name only</span> <a name="line-206"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>S</span> <span class='hs-comment'>-- S for strict (hmm...)</span> <a name="line-207"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Internal</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>S</span> <a name="line-208"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Unsafe</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>S</span> <a name="line-209"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Lazy</span><span class='hs-varop'>.</span><span class='hs-conid'>Internal</span> <a name="line-210"></a> <a name="line-211"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span> <span class='hs-layout'>(</span><span class='hs-conid'>Monoid</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-212"></a> <a name="line-213"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Word</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <a name="line-214"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Int</span> <span class='hs-layout'>(</span><span class='hs-conid'>Int64</span><span class='hs-layout'>)</span> <a name="line-215"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Handle</span><span class='hs-layout'>,</span><span class='hs-varid'>stdin</span><span class='hs-layout'>,</span><span class='hs-varid'>stdout</span><span class='hs-layout'>,</span><span class='hs-varid'>openBinaryFile</span><span class='hs-layout'>,</span><span class='hs-conid'>IOMode</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <a name="line-216"></a> <span class='hs-layout'>,</span><span class='hs-varid'>hClose</span><span class='hs-layout'>)</span> <a name="line-217"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Error</span> <span class='hs-layout'>(</span><span class='hs-varid'>mkIOError</span><span class='hs-layout'>,</span> <span class='hs-varid'>illegalOperationErrorType</span><span class='hs-layout'>)</span> <a name="line-218"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Unsafe</span> <a name="line-219"></a><span class='hs-cpp'>#ifndef __NHC__</span> <a name="line-220"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <span class='hs-layout'>(</span><span class='hs-varid'>bracket</span><span class='hs-layout'>)</span> <a name="line-221"></a><span class='hs-cpp'>#else</span> <a name="line-222"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-varid'>bracket</span><span class='hs-layout'>)</span> <a name="line-223"></a><span class='hs-cpp'>#endif</span> <a name="line-224"></a> <a name="line-225"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>ForeignPtr</span> <span class='hs-layout'>(</span><span class='hs-varid'>withForeignPtr</span><span class='hs-layout'>)</span> <a name="line-226"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Ptr</span> <a name="line-227"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Storable</span> <a name="line-228"></a> <a name="line-229"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-230"></a><span class='hs-comment'>--</span> <a name="line-231"></a><span class='hs-comment'>-- Useful macros, until we have bang patterns</span> <a name="line-232"></a><span class='hs-comment'>--</span> <a name="line-233"></a> <a name="line-234"></a><span class='hs-cpp'>#define STRICT1(f) f a | a `seq` False = undefined</span> <a name="line-235"></a><span class='hs-cpp'>#define STRICT2(f) f a b | a `seq` b `seq` False = undefined</span> <a name="line-236"></a><span class='hs-cpp'>#define STRICT3(f) f a b c | a `seq` b `seq` c `seq` False = undefined</span> <a name="line-237"></a><span class='hs-cpp'>#define STRICT4(f) f a b c d | a `seq` b `seq` c `seq` d `seq` False = undefined</span> <a name="line-238"></a><span class='hs-cpp'>#define STRICT5(f) f a b c d e | a `seq` b `seq` c `seq` d `seq` e `seq` False = undefined</span> <a name="line-239"></a> <a name="line-240"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-241"></a> <a name="line-242"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Eq</span> <span class='hs-conid'>ByteString</span> <a name="line-243"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varop'>==</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>eq</span> <a name="line-244"></a> <a name="line-245"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Ord</span> <span class='hs-conid'>ByteString</span> <a name="line-246"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>compare</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cmp</span> <a name="line-247"></a> <a name="line-248"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monoid</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyword'>where</span> <a name="line-249"></a> <span class='hs-varid'>mempty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-250"></a> <span class='hs-varid'>mappend</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>append</span> <a name="line-251"></a> <span class='hs-varid'>mconcat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <a name="line-252"></a> <a name="line-253"></a><a name="eq"></a><span class='hs-definition'>eq</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-254"></a><span class='hs-definition'>eq</span> <span class='hs-conid'>Empty</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span> <a name="line-255"></a><span class='hs-definition'>eq</span> <span class='hs-conid'>Empty</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span> <a name="line-256"></a><span class='hs-definition'>eq</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span> <a name="line-257"></a><span class='hs-definition'>eq</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>as</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>b</span> <span class='hs-varid'>bs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-258"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>compare</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span> <a name="line-259"></a> <span class='hs-conid'>LT</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-varop'>==</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>eq</span> <span class='hs-keyword'>as</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varid'>bs</span><span class='hs-layout'>)</span> <a name="line-260"></a> <span class='hs-conid'>EQ</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-varop'>==</span> <span class='hs-varid'>b</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>eq</span> <span class='hs-keyword'>as</span> <span class='hs-varid'>bs</span> <a name="line-261"></a> <span class='hs-conid'>GT</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varop'>==</span> <span class='hs-varid'>b</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>eq</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>as</span><span class='hs-layout'>)</span> <span class='hs-varid'>bs</span> <a name="line-262"></a> <a name="line-263"></a><a name="cmp"></a><span class='hs-definition'>cmp</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Ordering</span> <a name="line-264"></a><span class='hs-definition'>cmp</span> <span class='hs-conid'>Empty</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EQ</span> <a name="line-265"></a><span class='hs-definition'>cmp</span> <span class='hs-conid'>Empty</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>LT</span> <a name="line-266"></a><span class='hs-definition'>cmp</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>GT</span> <a name="line-267"></a><span class='hs-definition'>cmp</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>as</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>b</span> <span class='hs-varid'>bs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-268"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>compare</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span> <a name="line-269"></a> <span class='hs-conid'>LT</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>compare</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span> <a name="line-270"></a> <span class='hs-conid'>EQ</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmp</span> <span class='hs-keyword'>as</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varid'>bs</span><span class='hs-layout'>)</span> <a name="line-271"></a> <span class='hs-varid'>result</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>result</span> <a name="line-272"></a> <span class='hs-conid'>EQ</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>compare</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyword'>of</span> <a name="line-273"></a> <span class='hs-conid'>EQ</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmp</span> <span class='hs-keyword'>as</span> <span class='hs-varid'>bs</span> <a name="line-274"></a> <span class='hs-varid'>result</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>result</span> <a name="line-275"></a> <span class='hs-conid'>GT</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>compare</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span> <span class='hs-keyword'>of</span> <a name="line-276"></a> <span class='hs-conid'>EQ</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>cmp</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>as</span><span class='hs-layout'>)</span> <span class='hs-varid'>bs</span> <a name="line-277"></a> <span class='hs-varid'>result</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>result</span> <a name="line-278"></a> <a name="line-279"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-280"></a><span class='hs-comment'>-- Introducing and eliminating 'ByteString's</span> <a name="line-281"></a> <a name="line-282"></a><a name="empty"></a><span class='hs-comment'>-- | /O(1)/ The empty 'ByteString'</span> <a name="line-283"></a><span class='hs-definition'>empty</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <a name="line-284"></a><span class='hs-definition'>empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-285"></a><span class='hs-comment'>{-# INLINE empty #-}</span> <a name="line-286"></a> <a name="line-287"></a><a name="singleton"></a><span class='hs-comment'>-- | /O(1)/ Convert a 'Word8' into a 'ByteString'</span> <a name="line-288"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-289"></a><span class='hs-definition'>singleton</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>singleton</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-290"></a><span class='hs-comment'>{-# INLINE singleton #-}</span> <a name="line-291"></a> <a name="line-292"></a><a name="pack"></a><span class='hs-comment'>-- | /O(n)/ Convert a '[Word8]' into a 'ByteString'. </span> <a name="line-293"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Word8</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-294"></a><span class='hs-definition'>pack</span> <span class='hs-varid'>ws</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>pack</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-layout'>(</span><span class='hs-varid'>chunks</span> <span class='hs-varid'>defaultChunkSize</span> <span class='hs-varid'>ws</span><span class='hs-layout'>)</span> <a name="line-295"></a> <span class='hs-keyword'>where</span> <a name="line-296"></a> <span class='hs-varid'>chunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>]</span> <a name="line-297"></a> <span class='hs-varid'>chunks</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-298"></a> <span class='hs-varid'>chunks</span> <span class='hs-varid'>size</span> <span class='hs-varid'>xs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>splitAt</span> <span class='hs-varid'>size</span> <span class='hs-varid'>xs</span> <span class='hs-keyword'>of</span> <a name="line-299"></a> <span class='hs-layout'>(</span><span class='hs-varid'>xs'</span><span class='hs-layout'>,</span> <span class='hs-varid'>xs''</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>xs'</span> <span class='hs-conop'>:</span> <span class='hs-varid'>chunks</span> <span class='hs-varid'>size</span> <span class='hs-varid'>xs''</span> <a name="line-300"></a> <a name="line-301"></a><a name="unpack"></a><span class='hs-comment'>-- | /O(n)/ Converts a 'ByteString' to a '[Word8]'.</span> <a name="line-302"></a><span class='hs-definition'>unpack</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Word8</span><span class='hs-keyglyph'>]</span> <a name="line-303"></a><span class='hs-definition'>unpack</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>concatMap</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unpack</span> <span class='hs-layout'>(</span><span class='hs-varid'>toChunks</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-304"></a><span class='hs-comment'>--TODO: we can do better here by integrating the concat with the unpack</span> <a name="line-305"></a> <a name="line-306"></a><a name="fromChunks"></a><span class='hs-comment'>-- | /O(c)/ Convert a list of strict 'ByteString' into a lazy 'ByteString'</span> <a name="line-307"></a><span class='hs-definition'>fromChunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-308"></a><span class='hs-definition'>fromChunks</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr</span> <span class='hs-varid'>chunk</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>cs</span> <a name="line-309"></a> <a name="line-310"></a><a name="toChunks"></a><span class='hs-comment'>-- | /O(n)/ Convert a lazy 'ByteString' into a list of strict 'ByteString'</span> <a name="line-311"></a><span class='hs-definition'>toChunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-312"></a><span class='hs-definition'>toChunks</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-conop'>:</span><span class='hs-layout'>)</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>cs</span> <a name="line-313"></a> <a name="line-314"></a><span class='hs-comment'>------------------------------------------------------------------------</span> <a name="line-315"></a> <a name="line-316"></a><span class='hs-comment'>{- <a name="line-317"></a>-- | /O(n)/ Convert a '[a]' into a 'ByteString' using some <a name="line-318"></a>-- conversion function <a name="line-319"></a>packWith :: (a -> Word8) -> [a] -> ByteString <a name="line-320"></a>packWith k str = LPS $ L.map (P.packWith k) (chunk defaultChunkSize str) <a name="line-321"></a>{-# INLINE packWith #-} <a name="line-322"></a>{-# SPECIALIZE packWith :: (Char -> Word8) -> [Char] -> ByteString #-} <a name="line-323"></a> <a name="line-324"></a>-- | /O(n)/ Converts a 'ByteString' to a '[a]', using a conversion function. <a name="line-325"></a>unpackWith :: (Word8 -> a) -> ByteString -> [a] <a name="line-326"></a>unpackWith k (LPS ss) = L.concatMap (S.unpackWith k) ss <a name="line-327"></a>{-# INLINE unpackWith #-} <a name="line-328"></a>{-# SPECIALIZE unpackWith :: (Word8 -> Char) -> ByteString -> [Char] #-} <a name="line-329"></a>-}</span> <a name="line-330"></a> <a name="line-331"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-332"></a><span class='hs-comment'>-- Basic interface</span> <a name="line-333"></a> <a name="line-334"></a><a name="null"></a><span class='hs-comment'>-- | /O(1)/ Test whether a ByteString is empty.</span> <a name="line-335"></a><span class='hs-definition'>null</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-336"></a><span class='hs-definition'>null</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span> <a name="line-337"></a><span class='hs-definition'>null</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span> <a name="line-338"></a><span class='hs-comment'>{-# INLINE null #-}</span> <a name="line-339"></a> <a name="line-340"></a><a name="length"></a><span class='hs-comment'>-- | /O(n\/c)/ 'length' returns the length of a ByteString as an 'Int64'</span> <a name="line-341"></a><span class='hs-definition'>length</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int64</span> <a name="line-342"></a><span class='hs-definition'>length</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldlChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs</span> <a name="line-343"></a><span class='hs-comment'>{-# INLINE length #-}</span> <a name="line-344"></a> <a name="line-345"></a><a name="cons"></a><span class='hs-comment'>-- | /O(1)/ 'cons' is analogous to '(:)' for lists.</span> <a name="line-346"></a><span class='hs-comment'>--</span> <a name="line-347"></a><span class='hs-definition'>cons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-348"></a><span class='hs-definition'>cons</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>singleton</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-349"></a><span class='hs-comment'>{-# INLINE cons #-}</span> <a name="line-350"></a> <a name="line-351"></a><a name="cons'"></a><span class='hs-comment'>-- | /O(1)/ Unlike 'cons', 'cons\'' is</span> <a name="line-352"></a><span class='hs-comment'>-- strict in the ByteString that we are consing onto. More precisely, it forces</span> <a name="line-353"></a><span class='hs-comment'>-- the head and the first chunk. It does this because, for space efficiency, it</span> <a name="line-354"></a><span class='hs-comment'>-- may coalesce the new byte onto the first \'chunk\' rather than starting a</span> <a name="line-355"></a><span class='hs-comment'>-- new \'chunk\'.</span> <a name="line-356"></a><span class='hs-comment'>--</span> <a name="line-357"></a><span class='hs-comment'>-- So that means you can't use a lazy recursive contruction like this:</span> <a name="line-358"></a><span class='hs-comment'>--</span> <a name="line-359"></a><span class='hs-comment'>-- > let xs = cons\' c xs in xs</span> <a name="line-360"></a><span class='hs-comment'>--</span> <a name="line-361"></a><span class='hs-comment'>-- You can however use 'cons', as well as 'repeat' and 'cycle', to build</span> <a name="line-362"></a><span class='hs-comment'>-- infinite lazy ByteStrings.</span> <a name="line-363"></a><span class='hs-comment'>--</span> <a name="line-364"></a><span class='hs-definition'>cons'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-365"></a><span class='hs-definition'>cons'</span> <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-varop'><</span> <span class='hs-num'>16</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>cons</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-366"></a><span class='hs-definition'>cons'</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>singleton</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-367"></a><span class='hs-comment'>{-# INLINE cons' #-}</span> <a name="line-368"></a> <a name="line-369"></a><a name="snoc"></a><span class='hs-comment'>-- | /O(n\/c)/ Append a byte to the end of a 'ByteString'</span> <a name="line-370"></a><span class='hs-definition'>snoc</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-371"></a><span class='hs-definition'>snoc</span> <span class='hs-varid'>cs</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-varid'>singleton</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-372"></a><span class='hs-comment'>{-# INLINE snoc #-}</span> <a name="line-373"></a> <a name="line-374"></a><a name="head"></a><span class='hs-comment'>-- | /O(1)/ Extract the first element of a ByteString, which must be non-empty.</span> <a name="line-375"></a><span class='hs-definition'>head</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-376"></a><span class='hs-definition'>head</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"head"</span> <a name="line-377"></a><span class='hs-definition'>head</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span> <a name="line-378"></a><span class='hs-comment'>{-# INLINE head #-}</span> <a name="line-379"></a> <a name="line-380"></a><a name="uncons"></a><span class='hs-comment'>-- | /O(1)/ Extract the head and tail of a ByteString, returning Nothing</span> <a name="line-381"></a><span class='hs-comment'>-- if it is empty.</span> <a name="line-382"></a><span class='hs-definition'>uncons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-383"></a><span class='hs-definition'>uncons</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-384"></a><span class='hs-definition'>uncons</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-385"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span><span class='hs-layout'>,</span> <a name="line-386"></a> <span class='hs-keyword'>if</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-varop'>==</span> <span class='hs-num'>1</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>cs</span> <span class='hs-keyword'>else</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-387"></a><span class='hs-comment'>{-# INLINE uncons #-}</span> <a name="line-388"></a> <a name="line-389"></a><a name="tail"></a><span class='hs-comment'>-- | /O(1)/ Extract the elements after the head of a ByteString, which must be</span> <a name="line-390"></a><span class='hs-comment'>-- non-empty.</span> <a name="line-391"></a><span class='hs-definition'>tail</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-392"></a><span class='hs-definition'>tail</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"tail"</span> <a name="line-393"></a><span class='hs-definition'>tail</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-394"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-varop'>==</span> <span class='hs-num'>1</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs</span> <a name="line-395"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-396"></a><span class='hs-comment'>{-# INLINE tail #-}</span> <a name="line-397"></a> <a name="line-398"></a><a name="last"></a><span class='hs-comment'>-- | /O(n\/c)/ Extract the last element of a ByteString, which must be finite</span> <a name="line-399"></a><span class='hs-comment'>-- and non-empty.</span> <a name="line-400"></a><span class='hs-definition'>last</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-401"></a><span class='hs-definition'>last</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"last"</span> <a name="line-402"></a><span class='hs-definition'>last</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span> <a name="line-403"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>last</span> <span class='hs-varid'>c</span> <a name="line-404"></a> <span class='hs-varid'>go</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <a name="line-405"></a><span class='hs-comment'>-- XXX Don't inline this. Something breaks with 6.8.2 (haven't investigated yet)</span> <a name="line-406"></a> <a name="line-407"></a><a name="init"></a><span class='hs-comment'>-- | /O(n\/c)/ Return all the elements of a 'ByteString' except the last one.</span> <a name="line-408"></a><span class='hs-definition'>init</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-409"></a><span class='hs-definition'>init</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"init"</span> <a name="line-410"></a><span class='hs-definition'>init</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span> <a name="line-411"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-varop'>==</span> <span class='hs-num'>1</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-412"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>init</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-413"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>go</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-414"></a> <a name="line-415"></a><a name="append"></a><span class='hs-comment'>-- | /O(n\/c)/ Append two ByteStrings</span> <a name="line-416"></a><span class='hs-definition'>append</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-417"></a><span class='hs-definition'>append</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>ys</span> <span class='hs-varid'>xs</span> <a name="line-418"></a><span class='hs-comment'>{-# INLINE append #-}</span> <a name="line-419"></a> <a name="line-420"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-421"></a><span class='hs-comment'>-- Transformations</span> <a name="line-422"></a> <a name="line-423"></a><a name="map"></a><span class='hs-comment'>-- | /O(n)/ 'map' @f xs@ is the ByteString obtained by applying @f@ to each</span> <a name="line-424"></a><span class='hs-comment'>-- element of @xs@.</span> <a name="line-425"></a><span class='hs-definition'>map</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-426"></a><span class='hs-definition'>map</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <a name="line-427"></a> <span class='hs-keyword'>where</span> <a name="line-428"></a> <span class='hs-varid'>go</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-429"></a> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span> <a name="line-430"></a> <span class='hs-keyword'>where</span> <a name="line-431"></a> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span> <a name="line-432"></a> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>xs</span> <a name="line-433"></a><span class='hs-comment'>{-# INLINE map #-}</span> <a name="line-434"></a> <a name="line-435"></a><a name="reverse"></a><span class='hs-comment'>-- | /O(n)/ 'reverse' @xs@ returns the elements of @xs@ in reverse order.</span> <a name="line-436"></a><span class='hs-definition'>reverse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-437"></a><span class='hs-definition'>reverse</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>rev</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>cs0</span> <a name="line-438"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>rev</span> <span class='hs-varid'>a</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>a</span> <a name="line-439"></a> <span class='hs-varid'>rev</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>rev</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-440"></a><span class='hs-comment'>{-# INLINE reverse #-}</span> <a name="line-441"></a> <a name="line-442"></a><a name="intersperse"></a><span class='hs-comment'>-- | The 'intersperse' function takes a 'Word8' and a 'ByteString' and</span> <a name="line-443"></a><span class='hs-comment'>-- \`intersperses\' that byte between the elements of the 'ByteString'.</span> <a name="line-444"></a><span class='hs-comment'>-- It is analogous to the intersperse function on Lists.</span> <a name="line-445"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-446"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-447"></a><span class='hs-definition'>intersperse</span> <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-448"></a> <span class='hs-layout'>(</span><span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varop'>.</span> <span class='hs-varid'>intersperse'</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-449"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>intersperse'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <a name="line-450"></a> <span class='hs-varid'>intersperse'</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>o</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-451"></a> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeCreate</span> <span class='hs-layout'>(</span><span class='hs-num'>2</span><span class='hs-varop'>*</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-452"></a> <span class='hs-varid'>poke</span> <span class='hs-varid'>p'</span> <span class='hs-varid'>w</span> <a name="line-453"></a> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>c_intersperse</span> <span class='hs-layout'>(</span><span class='hs-varid'>p'</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>o</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span> <a name="line-454"></a> <a name="line-455"></a><a name="transpose"></a><span class='hs-comment'>-- | The 'transpose' function transposes the rows and columns of its</span> <a name="line-456"></a><span class='hs-comment'>-- 'ByteString' argument.</span> <a name="line-457"></a><span class='hs-definition'>transpose</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-458"></a><span class='hs-definition'>transpose</span> <span class='hs-varid'>css</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>ss</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>pack</span> <span class='hs-varid'>ss</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span><span class='hs-layout'>)</span> <a name="line-459"></a> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>transpose</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>unpack</span> <span class='hs-varid'>css</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-460"></a><span class='hs-comment'>--TODO: make this fast</span> <a name="line-461"></a> <a name="line-462"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-463"></a><span class='hs-comment'>-- Reducing 'ByteString's</span> <a name="line-464"></a> <a name="line-465"></a><a name="foldl"></a><span class='hs-comment'>-- | 'foldl', applied to a binary operator, a starting value (typically</span> <a name="line-466"></a><span class='hs-comment'>-- the left-identity of the operator), and a ByteString, reduces the</span> <a name="line-467"></a><span class='hs-comment'>-- ByteString using the binary operator, from left to right.</span> <a name="line-468"></a><span class='hs-definition'>foldl</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-469"></a><span class='hs-definition'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>z</span> <a name="line-470"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-varid'>a</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>a</span> <a name="line-471"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>a</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-472"></a><span class='hs-comment'>{-# INLINE foldl #-}</span> <a name="line-473"></a> <a name="line-474"></a><a name="foldl'"></a><span class='hs-comment'>-- | 'foldl\'' is like 'foldl', but strict in the accumulator.</span> <a name="line-475"></a><span class='hs-definition'>foldl'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-476"></a><span class='hs-definition'>foldl'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>z</span> <a name="line-477"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>a</span> <span class='hs-varop'>`seq`</span> <span class='hs-conid'>False</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>undefined</span> <a name="line-478"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>a</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>a</span> <a name="line-479"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>a</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-480"></a><span class='hs-comment'>{-# INLINE foldl' #-}</span> <a name="line-481"></a> <a name="line-482"></a><a name="foldr"></a><span class='hs-comment'>-- | 'foldr', applied to a binary operator, a starting value</span> <a name="line-483"></a><span class='hs-comment'>-- (typically the right-identity of the operator), and a ByteString,</span> <a name="line-484"></a><span class='hs-comment'>-- reduces the ByteString using the binary operator, from right to left.</span> <a name="line-485"></a><span class='hs-definition'>foldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-486"></a><span class='hs-definition'>foldr</span> <span class='hs-varid'>k</span> <span class='hs-varid'>z</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>flip</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>z</span> <span class='hs-varid'>cs</span> <a name="line-487"></a><span class='hs-comment'>{-# INLINE foldr #-}</span> <a name="line-488"></a> <a name="line-489"></a><a name="foldl1"></a><span class='hs-comment'>-- | 'foldl1' is a variant of 'foldl' that has no starting value</span> <a name="line-490"></a><span class='hs-comment'>-- argument, and thus must be applied to non-empty 'ByteStrings'.</span> <a name="line-491"></a><span class='hs-comment'>-- This function is subject to array fusion.</span> <a name="line-492"></a><span class='hs-definition'>foldl1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-493"></a><span class='hs-definition'>foldl1</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"foldl1"</span> <a name="line-494"></a><span class='hs-definition'>foldl1</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-495"></a> <a name="line-496"></a><a name="foldl1'"></a><span class='hs-comment'>-- | 'foldl1\'' is like 'foldl1', but strict in the accumulator.</span> <a name="line-497"></a><span class='hs-definition'>foldl1'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-498"></a><span class='hs-definition'>foldl1'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"foldl1'"</span> <a name="line-499"></a><span class='hs-definition'>foldl1'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldl'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-500"></a> <a name="line-501"></a><a name="foldr1"></a><span class='hs-comment'>-- | 'foldr1' is a variant of 'foldr' that has no starting value argument,</span> <a name="line-502"></a><span class='hs-comment'>-- and thus must be applied to non-empty 'ByteString's</span> <a name="line-503"></a><span class='hs-definition'>foldr1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-504"></a><span class='hs-definition'>foldr1</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"foldr1"</span> <a name="line-505"></a><span class='hs-definition'>foldr1</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span> <a name="line-506"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-varid'>c</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <a name="line-507"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>go</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <a name="line-508"></a> <a name="line-509"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-510"></a><span class='hs-comment'>-- Special folds</span> <a name="line-511"></a> <a name="line-512"></a><a name="concat"></a><span class='hs-comment'>-- | /O(n)/ Concatenate a list of ByteStrings.</span> <a name="line-513"></a><span class='hs-definition'>concat</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-514"></a><span class='hs-definition'>concat</span> <span class='hs-varid'>css0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>to</span> <span class='hs-varid'>css0</span> <a name="line-515"></a> <span class='hs-keyword'>where</span> <a name="line-516"></a> <span class='hs-varid'>go</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>css</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>to</span> <span class='hs-varid'>css</span> <a name="line-517"></a> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-varid'>css</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>go</span> <span class='hs-varid'>cs</span> <span class='hs-varid'>css</span><span class='hs-layout'>)</span> <a name="line-518"></a> <span class='hs-varid'>to</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-519"></a> <span class='hs-varid'>to</span> <span class='hs-layout'>(</span><span class='hs-varid'>cs</span><span class='hs-conop'>:</span><span class='hs-varid'>css</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>cs</span> <span class='hs-varid'>css</span> <a name="line-520"></a> <a name="line-521"></a><a name="concatMap"></a><span class='hs-comment'>-- | Map a function over a 'ByteString' and concatenate the results</span> <a name="line-522"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-523"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-524"></a><span class='hs-definition'>concatMap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>to</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span> <a name="line-525"></a> <span class='hs-keyword'>where</span> <a name="line-526"></a> <span class='hs-varid'>go</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-527"></a> <span class='hs-varid'>go</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>to</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span> <a name="line-528"></a> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>go</span> <span class='hs-varid'>cs</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <a name="line-529"></a> <a name="line-530"></a> <span class='hs-varid'>to</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-531"></a> <span class='hs-varid'>to</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>cs</span> <span class='hs-keyword'>of</span> <a name="line-532"></a> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Empty</span> <a name="line-533"></a> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>to</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span> <a name="line-534"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-535"></a> <a name="line-536"></a><a name="any"></a><span class='hs-comment'>-- | /O(n)/ Applied to a predicate and a ByteString, 'any' determines if</span> <a name="line-537"></a><span class='hs-comment'>-- any element of the 'ByteString' satisfies the predicate.</span> <a name="line-538"></a><span class='hs-definition'>any</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-539"></a><span class='hs-definition'>any</span> <span class='hs-varid'>f</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>c</span> <span class='hs-varid'>rest</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>any</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <span class='hs-varop'>||</span> <span class='hs-varid'>rest</span><span class='hs-layout'>)</span> <span class='hs-conid'>False</span> <span class='hs-varid'>cs</span> <a name="line-540"></a><span class='hs-comment'>{-# INLINE any #-}</span> <a name="line-541"></a><span class='hs-comment'>-- todo fuse</span> <a name="line-542"></a> <a name="line-543"></a><a name="all"></a><span class='hs-comment'>-- | /O(n)/ Applied to a predicate and a 'ByteString', 'all' determines</span> <a name="line-544"></a><span class='hs-comment'>-- if all elements of the 'ByteString' satisfy the predicate.</span> <a name="line-545"></a><span class='hs-definition'>all</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-546"></a><span class='hs-definition'>all</span> <span class='hs-varid'>f</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>c</span> <span class='hs-varid'>rest</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>all</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>rest</span><span class='hs-layout'>)</span> <span class='hs-conid'>True</span> <span class='hs-varid'>cs</span> <a name="line-547"></a><span class='hs-comment'>{-# INLINE all #-}</span> <a name="line-548"></a><span class='hs-comment'>-- todo fuse</span> <a name="line-549"></a> <a name="line-550"></a><a name="maximum"></a><span class='hs-comment'>-- | /O(n)/ 'maximum' returns the maximum value from a 'ByteString'</span> <a name="line-551"></a><span class='hs-definition'>maximum</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-552"></a><span class='hs-definition'>maximum</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"maximum"</span> <a name="line-553"></a><span class='hs-definition'>maximum</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldlChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>n</span> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>n</span> <span class='hs-varop'>`max`</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>maximum</span> <span class='hs-varid'>c'</span><span class='hs-layout'>)</span> <a name="line-554"></a> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>maximum</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-555"></a><span class='hs-comment'>{-# INLINE maximum #-}</span> <a name="line-556"></a> <a name="line-557"></a><a name="minimum"></a><span class='hs-comment'>-- | /O(n)/ 'minimum' returns the minimum value from a 'ByteString'</span> <a name="line-558"></a><span class='hs-definition'>minimum</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-559"></a><span class='hs-definition'>minimum</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"minimum"</span> <a name="line-560"></a><span class='hs-definition'>minimum</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldlChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>n</span> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>n</span> <span class='hs-varop'>`min`</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>minimum</span> <span class='hs-varid'>c'</span><span class='hs-layout'>)</span> <a name="line-561"></a> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>minimum</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-562"></a><span class='hs-comment'>{-# INLINE minimum #-}</span> <a name="line-563"></a> <a name="line-564"></a><a name="mapAccumL"></a><span class='hs-comment'>-- | The 'mapAccumL' function behaves like a combination of 'map' and</span> <a name="line-565"></a><span class='hs-comment'>-- 'foldl'; it applies a function to each element of a ByteString,</span> <a name="line-566"></a><span class='hs-comment'>-- passing an accumulating parameter from left to right, and returning a</span> <a name="line-567"></a><span class='hs-comment'>-- final value of this accumulator together with the new ByteString.</span> <a name="line-568"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-569"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s0</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>s0</span> <span class='hs-varid'>cs0</span> <a name="line-570"></a> <span class='hs-keyword'>where</span> <a name="line-571"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-conid'>Empty</span><span class='hs-layout'>)</span> <a name="line-572"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>s''</span><span class='hs-layout'>,</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <a name="line-573"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>s'</span><span class='hs-layout'>,</span> <span class='hs-varid'>c'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-varid'>c</span> <a name="line-574"></a> <span class='hs-layout'>(</span><span class='hs-varid'>s''</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>s'</span> <span class='hs-varid'>cs</span> <a name="line-575"></a> <a name="line-576"></a><a name="mapAccumR"></a><span class='hs-comment'>-- | The 'mapAccumR' function behaves like a combination of 'map' and</span> <a name="line-577"></a><span class='hs-comment'>-- 'foldr'; it applies a function to each element of a ByteString,</span> <a name="line-578"></a><span class='hs-comment'>-- passing an accumulating parameter from right to left, and returning a</span> <a name="line-579"></a><span class='hs-comment'>-- final value of this accumulator together with the new ByteString.</span> <a name="line-580"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-581"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s0</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>s0</span> <span class='hs-varid'>cs0</span> <a name="line-582"></a> <span class='hs-keyword'>where</span> <a name="line-583"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-conid'>Empty</span><span class='hs-layout'>)</span> <a name="line-584"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>s''</span><span class='hs-layout'>,</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <a name="line-585"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>s''</span><span class='hs-layout'>,</span> <span class='hs-varid'>c'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>mapAccumR</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s'</span> <span class='hs-varid'>c</span> <a name="line-586"></a> <span class='hs-layout'>(</span><span class='hs-varid'>s'</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <span class='hs-varid'>cs</span> <a name="line-587"></a> <a name="line-588"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-589"></a><span class='hs-comment'>-- Building ByteStrings</span> <a name="line-590"></a> <a name="line-591"></a><a name="scanl"></a><span class='hs-comment'>-- | 'scanl' is similar to 'foldl', but returns a list of successive</span> <a name="line-592"></a><span class='hs-comment'>-- reduced values from the left. This function will fuse.</span> <a name="line-593"></a><span class='hs-comment'>--</span> <a name="line-594"></a><span class='hs-comment'>-- > scanl f z [x1, x2, ...] == [z, z `f` x1, (z `f` x1) `f` x2, ...]</span> <a name="line-595"></a><span class='hs-comment'>--</span> <a name="line-596"></a><span class='hs-comment'>-- Note that</span> <a name="line-597"></a><span class='hs-comment'>--</span> <a name="line-598"></a><span class='hs-comment'>-- > last (scanl f z xs) == foldl f z xs.</span> <a name="line-599"></a><span class='hs-definition'>scanl</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-600"></a><span class='hs-definition'>scanl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>snd</span> <span class='hs-varop'>.</span> <span class='hs-varid'>foldl</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>z</span><span class='hs-layout'>,</span><span class='hs-varid'>singleton</span> <span class='hs-varid'>z</span><span class='hs-layout'>)</span> <a name="line-601"></a> <span class='hs-keyword'>where</span> <a name="line-602"></a> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-layout'>,</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>in</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-varid'>acc</span> <span class='hs-varop'>`snoc`</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <a name="line-603"></a><span class='hs-comment'>{-# INLINE scanl #-}</span> <a name="line-604"></a> <a name="line-605"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-606"></a><span class='hs-comment'>-- Unfolds and replicates</span> <a name="line-607"></a> <a name="line-608"></a><a name="iterate"></a><span class='hs-comment'>-- | @'iterate' f x@ returns an infinite ByteString of repeated applications</span> <a name="line-609"></a><span class='hs-comment'>-- of @f@ to @x@:</span> <a name="line-610"></a><span class='hs-comment'>--</span> <a name="line-611"></a><span class='hs-comment'>-- > iterate f x == [x, f x, f (f x), ...]</span> <a name="line-612"></a><span class='hs-comment'>--</span> <a name="line-613"></a><span class='hs-definition'>iterate</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-614"></a><span class='hs-definition'>iterate</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unfoldr</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>of</span> <span class='hs-varid'>x'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>x'</span> <span class='hs-varop'>`seq`</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>x'</span><span class='hs-layout'>,</span> <span class='hs-varid'>x'</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-615"></a> <a name="line-616"></a><a name="repeat"></a><span class='hs-comment'>-- | @'repeat' x@ is an infinite ByteString, with @x@ the value of every</span> <a name="line-617"></a><span class='hs-comment'>-- element.</span> <a name="line-618"></a><span class='hs-comment'>--</span> <a name="line-619"></a><span class='hs-definition'>repeat</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-620"></a><span class='hs-definition'>repeat</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs</span> <span class='hs-keyword'>where</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span> <span class='hs-varid'>smallChunkSize</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-621"></a> <a name="line-622"></a><a name="replicate"></a><span class='hs-comment'>-- | /O(n)/ @'replicate' n x@ is a ByteString of length @n@ with @x@</span> <a name="line-623"></a><span class='hs-comment'>-- the value of every element.</span> <a name="line-624"></a><span class='hs-comment'>--</span> <a name="line-625"></a><span class='hs-definition'>replicate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-626"></a><span class='hs-definition'>replicate</span> <span class='hs-varid'>n</span> <span class='hs-varid'>w</span> <a name="line-627"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-628"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>smallChunkSize</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-629"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>r</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs</span> <span class='hs-comment'>-- preserve invariant</span> <a name="line-630"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTake</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-631"></a> <span class='hs-keyword'>where</span> <a name="line-632"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span> <span class='hs-varid'>smallChunkSize</span> <span class='hs-varid'>w</span> <a name="line-633"></a> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>nChunks</span> <span class='hs-varid'>q</span> <a name="line-634"></a> <span class='hs-layout'>(</span><span class='hs-varid'>q</span><span class='hs-layout'>,</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>quotRem</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>smallChunkSize</span><span class='hs-layout'>)</span> <a name="line-635"></a> <span class='hs-varid'>nChunks</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-636"></a> <span class='hs-varid'>nChunks</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>nChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>m</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-637"></a> <a name="line-638"></a><a name="cycle"></a><span class='hs-comment'>-- | 'cycle' ties a finite ByteString into a circular one, or equivalently,</span> <a name="line-639"></a><span class='hs-comment'>-- the infinite repetition of the original ByteString.</span> <a name="line-640"></a><span class='hs-comment'>--</span> <a name="line-641"></a><span class='hs-definition'>cycle</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-642"></a><span class='hs-definition'>cycle</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"cycle"</span> <a name="line-643"></a><span class='hs-definition'>cycle</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs'</span> <span class='hs-keyword'>where</span> <span class='hs-varid'>cs'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>cs'</span> <span class='hs-varid'>cs</span> <a name="line-644"></a> <a name="line-645"></a><a name="unfoldr"></a><span class='hs-comment'>-- | /O(n)/ The 'unfoldr' function is analogous to the List \'unfoldr\'.</span> <a name="line-646"></a><span class='hs-comment'>-- 'unfoldr' builds a ByteString from a seed value. The function takes</span> <a name="line-647"></a><span class='hs-comment'>-- the element and returns 'Nothing' if it is done producing the</span> <a name="line-648"></a><span class='hs-comment'>-- ByteString or returns 'Just' @(a,b)@, in which case, @a@ is a</span> <a name="line-649"></a><span class='hs-comment'>-- prepending to the ByteString and @b@ is used as the next element in a</span> <a name="line-650"></a><span class='hs-comment'>-- recursive call.</span> <a name="line-651"></a><span class='hs-definition'>unfoldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-652"></a><span class='hs-definition'>unfoldr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unfoldChunk</span> <span class='hs-num'>32</span> <span class='hs-varid'>s0</span> <a name="line-653"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>unfoldChunk</span> <span class='hs-varid'>n</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <a name="line-654"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unfoldrN</span> <span class='hs-varid'>n</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-keyword'>of</span> <a name="line-655"></a> <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-layout'>,</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span> <a name="line-656"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Empty</span> <a name="line-657"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-conid'>Empty</span> <a name="line-658"></a> <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-layout'>,</span> <span class='hs-conid'>Just</span> <span class='hs-varid'>s'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>unfoldChunk</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>*</span><span class='hs-num'>2</span><span class='hs-layout'>)</span> <span class='hs-varid'>s'</span><span class='hs-layout'>)</span> <a name="line-659"></a> <a name="line-660"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-661"></a><span class='hs-comment'>-- Substrings</span> <a name="line-662"></a> <a name="line-663"></a><a name="take"></a><span class='hs-comment'>-- | /O(n\/c)/ 'take' @n@, applied to a ByteString @xs@, returns the prefix</span> <a name="line-664"></a><span class='hs-comment'>-- of @xs@ of length @n@, or @xs@ itself if @n > 'length' xs@.</span> <a name="line-665"></a><span class='hs-definition'>take</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-666"></a><span class='hs-definition'>take</span> <span class='hs-varid'>i</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-667"></a><span class='hs-definition'>take</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>take'</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <a name="line-668"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>take'</span> <span class='hs-num'>0</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-669"></a> <span class='hs-varid'>take'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-670"></a> <span class='hs-varid'>take'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-671"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-672"></a> <span class='hs-keyword'>then</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-673"></a> <span class='hs-keyword'>else</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>take'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-comment'>-</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-674"></a> <a name="line-675"></a><a name="drop"></a><span class='hs-comment'>-- | /O(n\/c)/ 'drop' @n xs@ returns the suffix of @xs@ after the first @n@</span> <a name="line-676"></a><span class='hs-comment'>-- elements, or @[]@ if @n > 'length' xs@.</span> <a name="line-677"></a><span class='hs-definition'>drop</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-678"></a><span class='hs-definition'>drop</span> <span class='hs-varid'>i</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>p</span> <a name="line-679"></a><span class='hs-definition'>drop</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>drop'</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <a name="line-680"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>drop'</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs</span> <a name="line-681"></a> <span class='hs-varid'>drop'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-682"></a> <span class='hs-varid'>drop'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-683"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-684"></a> <span class='hs-keyword'>then</span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-685"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>drop'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-comment'>-</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-686"></a> <a name="line-687"></a><a name="splitAt"></a><span class='hs-comment'>-- | /O(n\/c)/ 'splitAt' @n xs@ is equivalent to @('take' n xs, 'drop' n xs)@.</span> <a name="line-688"></a><span class='hs-definition'>splitAt</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-689"></a><span class='hs-definition'>splitAt</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>Empty</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <a name="line-690"></a><span class='hs-definition'>splitAt</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt'</span> <span class='hs-varid'>i</span> <span class='hs-varid'>cs0</span> <a name="line-691"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>splitAt'</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>Empty</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-692"></a> <span class='hs-varid'>splitAt'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>Empty</span><span class='hs-layout'>,</span> <span class='hs-conid'>Empty</span><span class='hs-layout'>)</span> <a name="line-693"></a> <span class='hs-varid'>splitAt'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-694"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-695"></a> <span class='hs-keyword'>then</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-696"></a> <span class='hs-layout'>,</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-697"></a> <span class='hs-keyword'>else</span> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>cs'</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs''</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-comment'>-</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-698"></a> <span class='hs-keyword'>in</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs''</span><span class='hs-layout'>)</span> <a name="line-699"></a> <a name="line-700"></a> <a name="line-701"></a><a name="takeWhile"></a><span class='hs-comment'>-- | 'takeWhile', applied to a predicate @p@ and a ByteString @xs@,</span> <a name="line-702"></a><span class='hs-comment'>-- returns the longest prefix (possibly empty) of @xs@ of elements that</span> <a name="line-703"></a><span class='hs-comment'>-- satisfy @p@.</span> <a name="line-704"></a><span class='hs-definition'>takeWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-705"></a><span class='hs-definition'>takeWhile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>takeWhile'</span> <span class='hs-varid'>cs0</span> <a name="line-706"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>takeWhile'</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-707"></a> <span class='hs-varid'>takeWhile'</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-708"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>findIndexOrEnd</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-709"></a> <span class='hs-num'>0</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Empty</span> <a name="line-710"></a> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-711"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>takeWhile'</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-712"></a> <a name="line-713"></a><a name="dropWhile"></a><span class='hs-comment'>-- | 'dropWhile' @p xs@ returns the suffix remaining after 'takeWhile' @p xs@.</span> <a name="line-714"></a><span class='hs-definition'>dropWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-715"></a><span class='hs-definition'>dropWhile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropWhile'</span> <span class='hs-varid'>cs0</span> <a name="line-716"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>dropWhile'</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-717"></a> <span class='hs-varid'>dropWhile'</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-718"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>findIndexOrEnd</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-719"></a> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-720"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>dropWhile'</span> <span class='hs-varid'>cs</span> <a name="line-721"></a> <a name="line-722"></a><a name="break"></a><span class='hs-comment'>-- | 'break' @p@ is equivalent to @'span' ('not' . p)@.</span> <a name="line-723"></a><span class='hs-definition'>break</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-724"></a><span class='hs-definition'>break</span> <span class='hs-varid'>f</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>break'</span> <span class='hs-varid'>cs0</span> <a name="line-725"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>break'</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>Empty</span><span class='hs-layout'>,</span> <span class='hs-conid'>Empty</span><span class='hs-layout'>)</span> <a name="line-726"></a> <span class='hs-varid'>break'</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-727"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>findIndexOrEnd</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-728"></a> <span class='hs-num'>0</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Empty</span><span class='hs-layout'>,</span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-729"></a> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>take</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <a name="line-730"></a> <span class='hs-layout'>,</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-731"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>cs'</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs''</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>break'</span> <span class='hs-varid'>cs</span> <a name="line-732"></a> <span class='hs-keyword'>in</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs''</span><span class='hs-layout'>)</span> <a name="line-733"></a> <a name="line-734"></a><span class='hs-comment'>--</span> <a name="line-735"></a><span class='hs-comment'>-- TODO</span> <a name="line-736"></a><span class='hs-comment'>--</span> <a name="line-737"></a><span class='hs-comment'>-- Add rules</span> <a name="line-738"></a><span class='hs-comment'>--</span> <a name="line-739"></a> <a name="line-740"></a><span class='hs-comment'>{- <a name="line-741"></a>-- | 'breakByte' breaks its ByteString argument at the first occurence <a name="line-742"></a>-- of the specified byte. It is more efficient than 'break' as it is <a name="line-743"></a>-- implemented with @memchr(3)@. I.e. <a name="line-744"></a>-- <a name="line-745"></a>-- > break (=='c') "abcd" == breakByte 'c' "abcd" <a name="line-746"></a>-- <a name="line-747"></a>breakByte :: Word8 -> ByteString -> (ByteString, ByteString) <a name="line-748"></a>breakByte c (LPS ps) = case (breakByte' ps) of (a,b) -> (LPS a, LPS b) <a name="line-749"></a> where breakByte' [] = ([], []) <a name="line-750"></a> breakByte' (x:xs) = <a name="line-751"></a> case P.elemIndex c x of <a name="line-752"></a> Just 0 -> ([], x : xs) <a name="line-753"></a> Just n -> (P.take n x : [], P.drop n x : xs) <a name="line-754"></a> Nothing -> let (xs', xs'') = breakByte' xs <a name="line-755"></a> in (x : xs', xs'') <a name="line-756"></a> <a name="line-757"></a>-- | 'spanByte' breaks its ByteString argument at the first <a name="line-758"></a>-- occurence of a byte other than its argument. It is more efficient <a name="line-759"></a>-- than 'span (==)' <a name="line-760"></a>-- <a name="line-761"></a>-- > span (=='c') "abcd" == spanByte 'c' "abcd" <a name="line-762"></a>-- <a name="line-763"></a>spanByte :: Word8 -> ByteString -> (ByteString, ByteString) <a name="line-764"></a>spanByte c (LPS ps) = case (spanByte' ps) of (a,b) -> (LPS a, LPS b) <a name="line-765"></a> where spanByte' [] = ([], []) <a name="line-766"></a> spanByte' (x:xs) = <a name="line-767"></a> case P.spanByte c x of <a name="line-768"></a> (x', x'') | P.null x' -> ([], x : xs) <a name="line-769"></a> | P.null x'' -> let (xs', xs'') = spanByte' xs <a name="line-770"></a> in (x : xs', xs'') <a name="line-771"></a> | otherwise -> (x' : [], x'' : xs) <a name="line-772"></a>-}</span> <a name="line-773"></a> <a name="line-774"></a><a name="span"></a><span class='hs-comment'>-- | 'span' @p xs@ breaks the ByteString into two segments. It is</span> <a name="line-775"></a><span class='hs-comment'>-- equivalent to @('takeWhile' p xs, 'dropWhile' p xs)@</span> <a name="line-776"></a><span class='hs-definition'>span</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-777"></a><span class='hs-definition'>span</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>break</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <a name="line-778"></a> <a name="line-779"></a><a name="splitWith"></a><span class='hs-comment'>-- | /O(n)/ Splits a 'ByteString' into components delimited by</span> <a name="line-780"></a><span class='hs-comment'>-- separators, where the predicate returns True for a separator element.</span> <a name="line-781"></a><span class='hs-comment'>-- The resulting components do not contain the separators. Two adjacent</span> <a name="line-782"></a><span class='hs-comment'>-- separators result in an empty component in the output. eg.</span> <a name="line-783"></a><span class='hs-comment'>--</span> <a name="line-784"></a><span class='hs-comment'>-- > splitWith (=='a') "aabbaca" == ["","","bb","c",""]</span> <a name="line-785"></a><span class='hs-comment'>-- > splitWith (=='a') [] == []</span> <a name="line-786"></a><span class='hs-comment'>--</span> <a name="line-787"></a><span class='hs-definition'>splitWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-788"></a><span class='hs-definition'>splitWith</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-789"></a><span class='hs-definition'>splitWith</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>comb</span> <span class='hs-conid'>[]</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>splitWith</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs0</span> <a name="line-790"></a> <a name="line-791"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>comb</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-792"></a> <span class='hs-varid'>comb</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span> <a name="line-793"></a> <span class='hs-varid'>comb</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>comb</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>splitWith</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-794"></a> <span class='hs-varid'>comb</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>ss</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>comb</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>ss</span> <span class='hs-varid'>cs</span> <a name="line-795"></a> <a name="line-796"></a><span class='hs-comment'>{-# INLINE splitWith #-}</span> <a name="line-797"></a> <a name="line-798"></a><a name="split"></a><span class='hs-comment'>-- | /O(n)/ Break a 'ByteString' into pieces separated by the byte</span> <a name="line-799"></a><span class='hs-comment'>-- argument, consuming the delimiter. I.e.</span> <a name="line-800"></a><span class='hs-comment'>--</span> <a name="line-801"></a><span class='hs-comment'>-- > split '\n' "a\nb\nd\ne" == ["a","b","d","e"]</span> <a name="line-802"></a><span class='hs-comment'>-- > split 'a' "aXaXaXa" == ["","X","X","X",""]</span> <a name="line-803"></a><span class='hs-comment'>-- > split 'x' "x" == ["",""]</span> <a name="line-804"></a><span class='hs-comment'>-- </span> <a name="line-805"></a><span class='hs-comment'>-- and</span> <a name="line-806"></a><span class='hs-comment'>--</span> <a name="line-807"></a><span class='hs-comment'>-- > intercalate [c] . split c == id</span> <a name="line-808"></a><span class='hs-comment'>-- > split == splitWith . (==)</span> <a name="line-809"></a><span class='hs-comment'>-- </span> <a name="line-810"></a><span class='hs-comment'>-- As for all splitting functions in this library, this function does</span> <a name="line-811"></a><span class='hs-comment'>-- not copy the substrings, it just constructs new 'ByteStrings' that</span> <a name="line-812"></a><span class='hs-comment'>-- are slices of the original.</span> <a name="line-813"></a><span class='hs-comment'>--</span> <a name="line-814"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-815"></a><span class='hs-definition'>split</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-816"></a><span class='hs-definition'>split</span> <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>comb</span> <span class='hs-conid'>[]</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>split</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs0</span> <a name="line-817"></a> <a name="line-818"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>comb</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-819"></a> <span class='hs-varid'>comb</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span> <a name="line-820"></a> <span class='hs-varid'>comb</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>comb</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>split</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-821"></a> <span class='hs-varid'>comb</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>ss</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>comb</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>ss</span> <span class='hs-varid'>cs</span> <a name="line-822"></a><span class='hs-comment'>{-# INLINE split #-}</span> <a name="line-823"></a> <a name="line-824"></a><span class='hs-comment'>{- <a name="line-825"></a>-- | Like 'splitWith', except that sequences of adjacent separators are <a name="line-826"></a>-- treated as a single separator. eg. <a name="line-827"></a>-- <a name="line-828"></a>-- > tokens (=='a') "aabbaca" == ["bb","c"] <a name="line-829"></a>-- <a name="line-830"></a>tokens :: (Word8 -> Bool) -> ByteString -> [ByteString] <a name="line-831"></a>tokens f = L.filter (not.null) . splitWith f <a name="line-832"></a>-}</span> <a name="line-833"></a> <a name="line-834"></a><a name="group"></a><span class='hs-comment'>-- | The 'group' function takes a ByteString and returns a list of</span> <a name="line-835"></a><span class='hs-comment'>-- ByteStrings such that the concatenation of the result is equal to the</span> <a name="line-836"></a><span class='hs-comment'>-- argument. Moreover, each sublist in the result contains only equal</span> <a name="line-837"></a><span class='hs-comment'>-- elements. For example,</span> <a name="line-838"></a><span class='hs-comment'>--</span> <a name="line-839"></a><span class='hs-comment'>-- > group "Mississippi" = ["M","i","ss","i","ss","i","pp","i"]</span> <a name="line-840"></a><span class='hs-comment'>--</span> <a name="line-841"></a><span class='hs-comment'>-- It is a special case of 'groupBy', which allows the programmer to</span> <a name="line-842"></a><span class='hs-comment'>-- supply their own equality test.</span> <a name="line-843"></a><span class='hs-definition'>group</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-844"></a><span class='hs-definition'>group</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-845"></a><span class='hs-definition'>group</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>group'</span> <span class='hs-conid'>[]</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>group</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs0</span> <a name="line-846"></a> <span class='hs-keyword'>where</span> <a name="line-847"></a> <span class='hs-varid'>group'</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-848"></a> <span class='hs-varid'>group'</span> <span class='hs-varid'>acc</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>s'</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-varid'>ss</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-849"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>s'</span> <a name="line-850"></a> <span class='hs-varop'>/=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revNonEmptyChunks</span> <span class='hs-varid'>acc</span> <span class='hs-conop'>:</span> <span class='hs-varid'>group'</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>ss</span> <span class='hs-varid'>cs</span> <a name="line-851"></a> <span class='hs-varid'>group'</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revNonEmptyChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span> <a name="line-852"></a> <span class='hs-varid'>group'</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>group'</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>group</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-853"></a> <span class='hs-varid'>group'</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>ss</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revNonEmptyChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>group'</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>ss</span> <span class='hs-varid'>cs</span> <a name="line-854"></a> <a name="line-855"></a><span class='hs-comment'>{- <a name="line-856"></a>TODO: check if something like this might be faster <a name="line-857"></a> <a name="line-858"></a>group :: ByteString -> [ByteString] <a name="line-859"></a>group xs <a name="line-860"></a> | null xs = [] <a name="line-861"></a> | otherwise = ys : group zs <a name="line-862"></a> where <a name="line-863"></a> (ys, zs) = spanByte (unsafeHead xs) xs <a name="line-864"></a>-}</span> <a name="line-865"></a> <a name="line-866"></a><a name="groupBy"></a><span class='hs-comment'>-- | The 'groupBy' function is the non-overloaded version of 'group'.</span> <a name="line-867"></a><span class='hs-comment'>--</span> <a name="line-868"></a><span class='hs-definition'>groupBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-869"></a><span class='hs-definition'>groupBy</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-870"></a><span class='hs-definition'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>groupBy'</span> <span class='hs-conid'>[]</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs0</span> <a name="line-871"></a> <span class='hs-keyword'>where</span> <a name="line-872"></a> <span class='hs-varid'>groupBy'</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-873"></a> <span class='hs-varid'>groupBy'</span> <span class='hs-varid'>acc</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-keyword'>_</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-varid'>ss</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-874"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-varop'>`k`</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revNonEmptyChunks</span> <span class='hs-varid'>acc</span> <span class='hs-conop'>:</span> <span class='hs-varid'>groupBy'</span> <span class='hs-conid'>[]</span> <span class='hs-num'>0</span> <span class='hs-varid'>ss</span> <span class='hs-varid'>cs</span> <a name="line-875"></a> <span class='hs-varid'>groupBy'</span> <span class='hs-varid'>acc</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revNonEmptyChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span> <span class='hs-conop'>:</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span> <a name="line-876"></a> <span class='hs-varid'>groupBy'</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>groupBy'</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-varid'>w'</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-877"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>w'</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>s</span> <a name="line-878"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w</span> <a name="line-879"></a> <span class='hs-varid'>groupBy'</span> <span class='hs-varid'>acc</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-conop'>:</span><span class='hs-varid'>ss</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revNonEmptyChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span> <span class='hs-conop'>:</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>groupBy'</span> <span class='hs-conid'>[]</span> <span class='hs-num'>0</span> <span class='hs-varid'>ss</span> <span class='hs-varid'>cs</span> <a name="line-880"></a> <a name="line-881"></a><span class='hs-comment'>{- <a name="line-882"></a>TODO: check if something like this might be faster <a name="line-883"></a> <a name="line-884"></a>groupBy :: (Word8 -> Word8 -> Bool) -> ByteString -> [ByteString] <a name="line-885"></a>groupBy k xs <a name="line-886"></a> | null xs = [] <a name="line-887"></a> | otherwise = take n xs : groupBy k (drop n xs) <a name="line-888"></a> where <a name="line-889"></a> n = 1 + findIndexOrEnd (not . k (head xs)) (tail xs) <a name="line-890"></a>-}</span> <a name="line-891"></a> <a name="line-892"></a><a name="intercalate"></a><span class='hs-comment'>-- | /O(n)/ The 'intercalate' function takes a 'ByteString' and a list of</span> <a name="line-893"></a><span class='hs-comment'>-- 'ByteString's and concatenates the list after interspersing the first</span> <a name="line-894"></a><span class='hs-comment'>-- argument between each element of the list.</span> <a name="line-895"></a><span class='hs-definition'>intercalate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-896"></a><span class='hs-definition'>intercalate</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-897"></a> <a name="line-898"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-899"></a><span class='hs-comment'>-- Indexing ByteStrings</span> <a name="line-900"></a> <a name="line-901"></a><a name="index"></a><span class='hs-comment'>-- | /O(c)/ 'ByteString' index (subscript) operator, starting from 0.</span> <a name="line-902"></a><span class='hs-definition'>index</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <a name="line-903"></a><span class='hs-definition'>index</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'><</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>moduleError</span> <span class='hs-str'>"index"</span> <span class='hs-layout'>(</span><span class='hs-str'>"negative index: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-904"></a><span class='hs-definition'>index</span> <span class='hs-varid'>cs0</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>index'</span> <span class='hs-varid'>cs0</span> <span class='hs-varid'>i</span> <a name="line-905"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>index'</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>moduleError</span> <span class='hs-str'>"index"</span> <span class='hs-layout'>(</span><span class='hs-str'>"index too large: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <a name="line-906"></a> <span class='hs-varid'>index'</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-varid'>n</span> <a name="line-907"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-908"></a> <span class='hs-varid'>index'</span> <span class='hs-varid'>cs</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-comment'>-</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-909"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeIndex</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span> <a name="line-910"></a> <a name="line-911"></a><a name="elemIndex"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndex' function returns the index of the first</span> <a name="line-912"></a><span class='hs-comment'>-- element in the given 'ByteString' which is equal to the query</span> <a name="line-913"></a><span class='hs-comment'>-- element, or 'Nothing' if there is no such element. </span> <a name="line-914"></a><span class='hs-comment'>-- This implementation uses memchr(3).</span> <a name="line-915"></a><span class='hs-definition'>elemIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int64</span> <a name="line-916"></a><span class='hs-definition'>elemIndex</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>elemIndex'</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs0</span> <a name="line-917"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>elemIndex'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-918"></a> <span class='hs-varid'>elemIndex'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-919"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndex</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-920"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>elemIndex'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-921"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-922"></a> <a name="line-923"></a><a name="elemIndices"></a><span class='hs-comment'>{- <a name="line-924"></a>-- | /O(n)/ The 'elemIndexEnd' function returns the last index of the <a name="line-925"></a>-- element in the given 'ByteString' which is equal to the query <a name="line-926"></a>-- element, or 'Nothing' if there is no such element. The following <a name="line-927"></a>-- holds: <a name="line-928"></a>-- <a name="line-929"></a>-- > elemIndexEnd c xs == <a name="line-930"></a>-- > (-) (length xs - 1) `fmap` elemIndex c (reverse xs) <a name="line-931"></a>-- <a name="line-932"></a>elemIndexEnd :: Word8 -> ByteString -> Maybe Int <a name="line-933"></a>elemIndexEnd ch (PS x s l) = inlinePerformIO $ withForeignPtr x $ \p -> <a name="line-934"></a> go (p `plusPtr` s) (l-1) <a name="line-935"></a> where <a name="line-936"></a> STRICT2(go) <a name="line-937"></a> go p i | i < 0 = return Nothing <a name="line-938"></a> | otherwise = do ch' <- peekByteOff p i <a name="line-939"></a> if ch == ch' <a name="line-940"></a> then return $ Just i <a name="line-941"></a> else go p (i-1) <a name="line-942"></a>-}</span> <a name="line-943"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndices' function extends 'elemIndex', by returning</span> <a name="line-944"></a><span class='hs-comment'>-- the indices of all elements equal to the query element, in ascending order.</span> <a name="line-945"></a><span class='hs-comment'>-- This implementation uses memchr(3).</span> <a name="line-946"></a><span class='hs-definition'>elemIndices</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Int64</span><span class='hs-keyglyph'>]</span> <a name="line-947"></a><span class='hs-definition'>elemIndices</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>elemIndices'</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs0</span> <a name="line-948"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>elemIndices'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-949"></a> <span class='hs-varid'>elemIndices'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varop'>+</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-varop'>.</span><span class='hs-varid'>fromIntegral</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndices</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-950"></a> <span class='hs-varop'>++</span> <span class='hs-varid'>elemIndices'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-951"></a> <a name="line-952"></a><a name="count"></a><span class='hs-comment'>-- | count returns the number of times its argument appears in the ByteString</span> <a name="line-953"></a><span class='hs-comment'>--</span> <a name="line-954"></a><span class='hs-comment'>-- > count = length . elemIndices</span> <a name="line-955"></a><span class='hs-comment'>--</span> <a name="line-956"></a><span class='hs-comment'>-- But more efficiently than using length on the intermediate list.</span> <a name="line-957"></a><span class='hs-definition'>count</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int64</span> <a name="line-958"></a><span class='hs-definition'>count</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldlChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>count</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs</span> <a name="line-959"></a> <a name="line-960"></a><a name="findIndex"></a><span class='hs-comment'>-- | The 'findIndex' function takes a predicate and a 'ByteString' and</span> <a name="line-961"></a><span class='hs-comment'>-- returns the index of the first element in the ByteString</span> <a name="line-962"></a><span class='hs-comment'>-- satisfying the predicate.</span> <a name="line-963"></a><span class='hs-definition'>findIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int64</span> <a name="line-964"></a><span class='hs-definition'>findIndex</span> <span class='hs-varid'>k</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>findIndex'</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs0</span> <a name="line-965"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>findIndex'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-966"></a> <span class='hs-varid'>findIndex'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-967"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>findIndex</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-968"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>findIndex'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-969"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-970"></a><span class='hs-comment'>{-# INLINE findIndex #-}</span> <a name="line-971"></a> <a name="line-972"></a><a name="find"></a><span class='hs-comment'>-- | /O(n)/ The 'find' function takes a predicate and a ByteString,</span> <a name="line-973"></a><span class='hs-comment'>-- and returns the first element in matching the predicate, or 'Nothing'</span> <a name="line-974"></a><span class='hs-comment'>-- if there is no such element.</span> <a name="line-975"></a><span class='hs-comment'>--</span> <a name="line-976"></a><span class='hs-comment'>-- > find f p = case findIndex f p of Just n -> Just (p ! n) ; _ -> Nothing</span> <a name="line-977"></a><span class='hs-comment'>--</span> <a name="line-978"></a><span class='hs-definition'>find</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Word8</span> <a name="line-979"></a><span class='hs-definition'>find</span> <span class='hs-varid'>f</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>find'</span> <span class='hs-varid'>cs0</span> <a name="line-980"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>find'</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-981"></a> <span class='hs-varid'>find'</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>find</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-982"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>find'</span> <span class='hs-varid'>cs</span> <a name="line-983"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-varid'>w</span> <a name="line-984"></a><span class='hs-comment'>{-# INLINE find #-}</span> <a name="line-985"></a> <a name="line-986"></a><a name="findIndices"></a><span class='hs-comment'>-- | The 'findIndices' function extends 'findIndex', by returning the</span> <a name="line-987"></a><span class='hs-comment'>-- indices of all elements satisfying the predicate, in ascending order.</span> <a name="line-988"></a><span class='hs-definition'>findIndices</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Int64</span><span class='hs-keyglyph'>]</span> <a name="line-989"></a><span class='hs-definition'>findIndices</span> <span class='hs-varid'>k</span> <span class='hs-varid'>cs0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>findIndices'</span> <span class='hs-num'>0</span> <span class='hs-varid'>cs0</span> <a name="line-990"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>findIndices'</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-991"></a> <span class='hs-varid'>findIndices'</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varop'>+</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-varop'>.</span><span class='hs-varid'>fromIntegral</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>findIndices</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-992"></a> <span class='hs-varop'>++</span> <span class='hs-varid'>findIndices'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-993"></a> <a name="line-994"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-995"></a><span class='hs-comment'>-- Searching ByteStrings</span> <a name="line-996"></a> <a name="line-997"></a><a name="elem"></a><span class='hs-comment'>-- | /O(n)/ 'elem' is the 'ByteString' membership predicate.</span> <a name="line-998"></a><span class='hs-definition'>elem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-999"></a><span class='hs-definition'>elem</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>elemIndex</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs</span> <span class='hs-keyword'>of</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>False</span> <span class='hs-layout'>;</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>True</span> <a name="line-1000"></a> <a name="line-1001"></a><a name="notElem"></a><span class='hs-comment'>-- | /O(n)/ 'notElem' is the inverse of 'elem'</span> <a name="line-1002"></a><span class='hs-definition'>notElem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-1003"></a><span class='hs-definition'>notElem</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-varid'>elem</span> <span class='hs-varid'>w</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-1004"></a> <a name="line-1005"></a><a name="filter"></a><span class='hs-comment'>-- | /O(n)/ 'filter', applied to a predicate and a ByteString,</span> <a name="line-1006"></a><span class='hs-comment'>-- returns a ByteString containing those characters that satisfy the</span> <a name="line-1007"></a><span class='hs-comment'>-- predicate.</span> <a name="line-1008"></a><span class='hs-definition'>filter</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-1009"></a><span class='hs-definition'>filter</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <a name="line-1010"></a> <span class='hs-keyword'>where</span> <a name="line-1011"></a> <span class='hs-varid'>go</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <a name="line-1012"></a> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>filter</span> <span class='hs-varid'>p</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>go</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <a name="line-1013"></a><span class='hs-comment'>{-# INLINE filter #-}</span> <a name="line-1014"></a> <a name="line-1015"></a><span class='hs-comment'>{- <a name="line-1016"></a>-- | /O(n)/ and /O(n\/c) space/ A first order equivalent of /filter . <a name="line-1017"></a>-- (==)/, for the common case of filtering a single byte. It is more <a name="line-1018"></a>-- efficient to use /filterByte/ in this case. <a name="line-1019"></a>-- <a name="line-1020"></a>-- > filterByte == filter . (==) <a name="line-1021"></a>-- <a name="line-1022"></a>-- filterByte is around 10x faster, and uses much less space, than its <a name="line-1023"></a>-- filter equivalent <a name="line-1024"></a>filterByte :: Word8 -> ByteString -> ByteString <a name="line-1025"></a>filterByte w ps = replicate (count w ps) w <a name="line-1026"></a>{-# INLINE filterByte #-} <a name="line-1027"></a> <a name="line-1028"></a>{-# RULES <a name="line-1029"></a>"ByteString specialise filter (== x)" forall x. <a name="line-1030"></a> filter ((==) x) = filterByte x <a name="line-1031"></a> <a name="line-1032"></a>"ByteString specialise filter (== x)" forall x. <a name="line-1033"></a> filter (== x) = filterByte x <a name="line-1034"></a> #-} <a name="line-1035"></a>-}</span> <a name="line-1036"></a> <a name="line-1037"></a><span class='hs-comment'>{- <a name="line-1038"></a>-- | /O(n)/ A first order equivalent of /filter . (\/=)/, for the common <a name="line-1039"></a>-- case of filtering a single byte out of a list. It is more efficient <a name="line-1040"></a>-- to use /filterNotByte/ in this case. <a name="line-1041"></a>-- <a name="line-1042"></a>-- > filterNotByte == filter . (/=) <a name="line-1043"></a>-- <a name="line-1044"></a>-- filterNotByte is around 2x faster than its filter equivalent. <a name="line-1045"></a>filterNotByte :: Word8 -> ByteString -> ByteString <a name="line-1046"></a>filterNotByte w (LPS xs) = LPS (filterMap (P.filterNotByte w) xs) <a name="line-1047"></a>-}</span> <a name="line-1048"></a> <a name="line-1049"></a><a name="partition"></a><span class='hs-comment'>-- | /O(n)/ The 'partition' function takes a predicate a ByteString and returns</span> <a name="line-1050"></a><span class='hs-comment'>-- the pair of ByteStrings with elements which do and do not satisfy the</span> <a name="line-1051"></a><span class='hs-comment'>-- predicate, respectively; i.e.,</span> <a name="line-1052"></a><span class='hs-comment'>--</span> <a name="line-1053"></a><span class='hs-comment'>-- > partition p bs == (filter p xs, filter (not . p) xs)</span> <a name="line-1054"></a><span class='hs-comment'>--</span> <a name="line-1055"></a><span class='hs-definition'>partition</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-1056"></a><span class='hs-definition'>partition</span> <span class='hs-varid'>f</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>filter</span> <span class='hs-varid'>f</span> <span class='hs-varid'>p</span><span class='hs-layout'>,</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <a name="line-1057"></a><span class='hs-comment'>--TODO: use a better implementation</span> <a name="line-1058"></a> <a name="line-1059"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1060"></a><span class='hs-comment'>-- Searching for substrings</span> <a name="line-1061"></a> <a name="line-1062"></a><a name="isPrefixOf"></a><span class='hs-comment'>-- | /O(n)/ The 'isPrefixOf' function takes two ByteStrings and returns 'True'</span> <a name="line-1063"></a><span class='hs-comment'>-- iff the first is a prefix of the second.</span> <a name="line-1064"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-1065"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-conid'>Empty</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span> <a name="line-1066"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span> <a name="line-1067"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span> <a name="line-1068"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>x</span> <span class='hs-varop'>==</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span> <span class='hs-varop'>==</span> <span class='hs-varid'>y</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>isPrefixOf</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>ys</span> <a name="line-1069"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>x</span> <span class='hs-varop'><</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span> <span class='hs-varop'>==</span> <span class='hs-varid'>yh</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>isPrefixOf</span> <span class='hs-varid'>xs</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>yt</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span> <a name="line-1070"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>xh</span> <span class='hs-varop'>==</span> <span class='hs-varid'>y</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>isPrefixOf</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>xt</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-varid'>ys</span> <a name="line-1071"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>xh</span><span class='hs-layout'>,</span><span class='hs-varid'>xt</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-varid'>x</span> <a name="line-1072"></a> <span class='hs-layout'>(</span><span class='hs-varid'>yh</span><span class='hs-layout'>,</span><span class='hs-varid'>yt</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varid'>y</span> <a name="line-1073"></a> <a name="line-1074"></a><a name="isSuffixOf"></a><span class='hs-comment'>-- | /O(n)/ The 'isSuffixOf' function takes two ByteStrings and returns 'True'</span> <a name="line-1075"></a><span class='hs-comment'>-- iff the first is a suffix of the second.</span> <a name="line-1076"></a><span class='hs-comment'>-- </span> <a name="line-1077"></a><span class='hs-comment'>-- The following holds:</span> <a name="line-1078"></a><span class='hs-comment'>--</span> <a name="line-1079"></a><span class='hs-comment'>-- > isSuffixOf x y == reverse x `isPrefixOf` reverse y</span> <a name="line-1080"></a><span class='hs-comment'>--</span> <a name="line-1081"></a><span class='hs-definition'>isSuffixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-1082"></a><span class='hs-definition'>isSuffixOf</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>reverse</span> <span class='hs-varid'>x</span> <span class='hs-varop'>`isPrefixOf`</span> <span class='hs-varid'>reverse</span> <span class='hs-varid'>y</span> <a name="line-1083"></a><span class='hs-comment'>--TODO: a better implementation</span> <a name="line-1084"></a> <a name="line-1085"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1086"></a><span class='hs-comment'>-- Zipping</span> <a name="line-1087"></a> <a name="line-1088"></a><a name="zip"></a><span class='hs-comment'>-- | /O(n)/ 'zip' takes two ByteStrings and returns a list of</span> <a name="line-1089"></a><span class='hs-comment'>-- corresponding pairs of bytes. If one input ByteString is short,</span> <a name="line-1090"></a><span class='hs-comment'>-- excess elements of the longer ByteString are discarded. This is</span> <a name="line-1091"></a><span class='hs-comment'>-- equivalent to a pair of 'unpack' operations.</span> <a name="line-1092"></a><span class='hs-definition'>zip</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-1093"></a><span class='hs-definition'>zip</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>zipWith</span> <span class='hs-conid'>(,)</span> <a name="line-1094"></a> <a name="line-1095"></a><a name="zipWith"></a><span class='hs-comment'>-- | 'zipWith' generalises 'zip' by zipping with the function given as</span> <a name="line-1096"></a><span class='hs-comment'>-- the first argument, instead of a tupling function. For example,</span> <a name="line-1097"></a><span class='hs-comment'>-- @'zipWith' (+)@ is applied to two ByteStrings to produce the list of</span> <a name="line-1098"></a><span class='hs-comment'>-- corresponding sums.</span> <a name="line-1099"></a><span class='hs-definition'>zipWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <a name="line-1100"></a><span class='hs-definition'>zipWith</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1101"></a><span class='hs-definition'>zipWith</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1102"></a><span class='hs-definition'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>as</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>b</span> <span class='hs-varid'>bs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>as</span> <span class='hs-varid'>b</span> <span class='hs-varid'>bs</span> <a name="line-1103"></a> <span class='hs-keyword'>where</span> <a name="line-1104"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <a name="line-1105"></a> <span class='hs-conop'>:</span> <span class='hs-varid'>to</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-varid'>ys</span> <a name="line-1106"></a> <a name="line-1107"></a> <span class='hs-varid'>to</span> <span class='hs-varid'>x</span> <span class='hs-conid'>Empty</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1108"></a> <span class='hs-varid'>to</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>y</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1109"></a> <span class='hs-varid'>to</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <a name="line-1110"></a> <span class='hs-varop'>&&</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span> <a name="line-1111"></a> <span class='hs-varid'>to</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>y'</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>y'</span> <span class='hs-varid'>ys</span> <a name="line-1112"></a> <span class='hs-varid'>to</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>x'</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>x'</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>y</span> <span class='hs-varid'>ys</span> <a name="line-1113"></a> <span class='hs-varid'>to</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>x'</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>y'</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>x'</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>y'</span> <span class='hs-varid'>ys</span> <a name="line-1114"></a> <a name="line-1115"></a><a name="unzip"></a><span class='hs-comment'>-- | /O(n)/ 'unzip' transforms a list of pairs of bytes into a pair of</span> <a name="line-1116"></a><span class='hs-comment'>-- ByteStrings. Note that this performs two 'pack' operations.</span> <a name="line-1117"></a><span class='hs-definition'>unzip</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-1118"></a><span class='hs-definition'>unzip</span> <span class='hs-varid'>ls</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>pack</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>fst</span> <span class='hs-varid'>ls</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>pack</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>snd</span> <span class='hs-varid'>ls</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1119"></a><span class='hs-comment'>{-# INLINE unzip #-}</span> <a name="line-1120"></a> <a name="line-1121"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1122"></a><span class='hs-comment'>-- Special lists</span> <a name="line-1123"></a> <a name="line-1124"></a><a name="inits"></a><span class='hs-comment'>-- | /O(n)/ Return all initial segments of the given 'ByteString', shortest first.</span> <a name="line-1125"></a><span class='hs-definition'>inits</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-1126"></a><span class='hs-definition'>inits</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>Empty</span> <span class='hs-conop'>:</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>inits'</span> <a name="line-1127"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>inits'</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1128"></a> <span class='hs-varid'>inits'</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>c'</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Chunk</span> <span class='hs-varid'>c'</span> <span class='hs-conid'>Empty</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>tail</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>inits</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1129"></a> <span class='hs-varop'>++</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>inits'</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-1130"></a> <a name="line-1131"></a><a name="tails"></a><span class='hs-comment'>-- | /O(n)/ Return all final segments of the given 'ByteString', longest first.</span> <a name="line-1132"></a><span class='hs-definition'>tails</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <a name="line-1133"></a><span class='hs-definition'>tails</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Empty</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span> <a name="line-1134"></a><span class='hs-definition'>tails</span> <span class='hs-varid'>cs</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <a name="line-1135"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-varop'>==</span> <span class='hs-num'>1</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs</span> <span class='hs-conop'>:</span> <span class='hs-varid'>tails</span> <span class='hs-varid'>cs'</span> <a name="line-1136"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cs</span> <span class='hs-conop'>:</span> <span class='hs-varid'>tails</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span> <a name="line-1137"></a> <a name="line-1138"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1139"></a><span class='hs-comment'>-- Low level constructors</span> <a name="line-1140"></a> <a name="line-1141"></a><a name="copy"></a><span class='hs-comment'>-- | /O(n)/ Make a copy of the 'ByteString' with its own storage.</span> <a name="line-1142"></a><span class='hs-comment'>-- This is mainly useful to allow the rest of the data pointed</span> <a name="line-1143"></a><span class='hs-comment'>-- to by the 'ByteString' to be garbage collected, for example</span> <a name="line-1144"></a><span class='hs-comment'>-- if a large string has been read in, and only a small part of it</span> <a name="line-1145"></a><span class='hs-comment'>-- is needed in the rest of the program.</span> <a name="line-1146"></a><span class='hs-definition'>copy</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-1147"></a><span class='hs-definition'>copy</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>copy</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>cs</span> <a name="line-1148"></a><span class='hs-comment'>--TODO, we could coalese small blocks here</span> <a name="line-1149"></a><span class='hs-comment'>--FIXME: probably not strict enough, if we're doing this to avoid retaining</span> <a name="line-1150"></a><span class='hs-comment'>-- the parent blocks then we'd better copy strictly.</span> <a name="line-1151"></a> <a name="line-1152"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1153"></a> <a name="line-1154"></a><span class='hs-comment'>-- TODO defrag func that concatenates block together that are below a threshold</span> <a name="line-1155"></a><span class='hs-comment'>-- defrag :: ByteString -> ByteString</span> <a name="line-1156"></a> <a name="line-1157"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1158"></a><span class='hs-comment'>-- Lazy ByteString IO</span> <a name="line-1159"></a><span class='hs-comment'>--</span> <a name="line-1160"></a><span class='hs-comment'>-- Rule for when to close: is it expected to read the whole file?</span> <a name="line-1161"></a><span class='hs-comment'>-- If so, close when done. </span> <a name="line-1162"></a><span class='hs-comment'>--</span> <a name="line-1163"></a> <a name="line-1164"></a><a name="hGetContentsN"></a><span class='hs-comment'>-- | Read entire handle contents /lazily/ into a 'ByteString'. Chunks</span> <a name="line-1165"></a><span class='hs-comment'>-- are read on demand, in at most @k@-sized chunks. It does not block</span> <a name="line-1166"></a><span class='hs-comment'>-- waiting for a whole @k@-sized chunk, so if less than @k@ bytes are</span> <a name="line-1167"></a><span class='hs-comment'>-- available then they will be returned immediately as a smaller chunk.</span> <a name="line-1168"></a><span class='hs-comment'>--</span> <a name="line-1169"></a><span class='hs-comment'>-- The handle is closed on EOF.</span> <a name="line-1170"></a><span class='hs-comment'>--</span> <a name="line-1171"></a><span class='hs-comment'>-- Note: the 'Handle' should be placed in binary mode with</span> <a name="line-1172"></a><span class='hs-comment'>-- 'System.IO.hSetBinaryMode' for 'hGetContentsN' to</span> <a name="line-1173"></a><span class='hs-comment'>-- work correctly.</span> <a name="line-1174"></a><span class='hs-comment'>--</span> <a name="line-1175"></a><span class='hs-definition'>hGetContentsN</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1176"></a><span class='hs-definition'>hGetContentsN</span> <span class='hs-varid'>k</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>lazyRead</span> <span class='hs-comment'>-- TODO close on exceptions</span> <a name="line-1177"></a> <span class='hs-keyword'>where</span> <a name="line-1178"></a> <span class='hs-varid'>lazyRead</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeInterleaveIO</span> <span class='hs-varid'>loop</span> <a name="line-1179"></a> <a name="line-1180"></a> <span class='hs-varid'>loop</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-1181"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>hGetSome</span> <span class='hs-varid'>h</span> <span class='hs-varid'>k</span> <span class='hs-comment'>-- only blocks if there is no data available</span> <a name="line-1182"></a> <span class='hs-keyword'>if</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>c</span> <a name="line-1183"></a> <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>hClose</span> <span class='hs-varid'>h</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-conid'>Empty</span> <a name="line-1184"></a> <span class='hs-keyword'>else</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>lazyRead</span> <a name="line-1185"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-1186"></a> <a name="line-1187"></a><a name="hGetN"></a><span class='hs-comment'>-- | Read @n@ bytes into a 'ByteString', directly from the</span> <a name="line-1188"></a><span class='hs-comment'>-- specified 'Handle', in chunks of size @k@.</span> <a name="line-1189"></a><span class='hs-comment'>--</span> <a name="line-1190"></a><span class='hs-definition'>hGetN</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1191"></a><span class='hs-definition'>hGetN</span> <span class='hs-varid'>k</span> <span class='hs-varid'>h</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>></span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>readChunks</span> <span class='hs-varid'>n</span> <a name="line-1192"></a> <span class='hs-keyword'>where</span> <a name="line-1193"></a> <span class='hs-conid'>STRICT1</span><span class='hs-layout'>(</span><span class='hs-varid'>readChunks</span><span class='hs-layout'>)</span> <a name="line-1194"></a> <span class='hs-varid'>readChunks</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-1195"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>hGet</span> <span class='hs-varid'>h</span> <span class='hs-layout'>(</span><span class='hs-varid'>min</span> <span class='hs-varid'>k</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-1196"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-1197"></a> <span class='hs-num'>0</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-conid'>Empty</span> <a name="line-1198"></a> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>readChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span> <span class='hs-comment'>-</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <a name="line-1199"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-1200"></a> <a name="line-1201"></a><span class='hs-definition'>hGetN</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Empty</span> <a name="line-1202"></a><span class='hs-definition'>hGetN</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>h</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>illegalBufferSize</span> <span class='hs-varid'>h</span> <span class='hs-str'>"hGet"</span> <span class='hs-varid'>n</span> <a name="line-1203"></a> <a name="line-1204"></a><a name="hGetNonBlockingN"></a><span class='hs-comment'>-- | hGetNonBlockingN is similar to 'hGetContentsN', except that it will never block</span> <a name="line-1205"></a><span class='hs-comment'>-- waiting for data to become available, instead it returns only whatever data</span> <a name="line-1206"></a><span class='hs-comment'>-- is available. Chunks are read on demand, in @k@-sized chunks.</span> <a name="line-1207"></a><span class='hs-comment'>--</span> <a name="line-1208"></a><span class='hs-definition'>hGetNonBlockingN</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1209"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span> <a name="line-1210"></a><span class='hs-definition'>hGetNonBlockingN</span> <span class='hs-varid'>k</span> <span class='hs-varid'>h</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>></span> <span class='hs-num'>0</span><span class='hs-keyglyph'>=</span> <span class='hs-varid'>readChunks</span> <span class='hs-varid'>n</span> <a name="line-1211"></a> <span class='hs-keyword'>where</span> <a name="line-1212"></a> <span class='hs-conid'>STRICT1</span><span class='hs-layout'>(</span><span class='hs-varid'>readChunks</span><span class='hs-layout'>)</span> <a name="line-1213"></a> <span class='hs-varid'>readChunks</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-1214"></a> <span class='hs-varid'>c</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>hGetNonBlocking</span> <span class='hs-varid'>h</span> <span class='hs-layout'>(</span><span class='hs-varid'>min</span> <span class='hs-varid'>k</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-1215"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span> <a name="line-1216"></a> <span class='hs-num'>0</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-conid'>Empty</span> <a name="line-1217"></a> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>readChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span> <span class='hs-comment'>-</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <a name="line-1218"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <a name="line-1219"></a> <a name="line-1220"></a><span class='hs-definition'>hGetNonBlockingN</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Empty</span> <a name="line-1221"></a><span class='hs-definition'>hGetNonBlockingN</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>h</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>illegalBufferSize</span> <span class='hs-varid'>h</span> <span class='hs-str'>"hGetNonBlocking"</span> <span class='hs-varid'>n</span> <a name="line-1222"></a><span class='hs-cpp'>#else</span> <a name="line-1223"></a><span class='hs-definition'>hGetNonBlockingN</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetN</span> <a name="line-1224"></a><span class='hs-cpp'>#endif</span> <a name="line-1225"></a> <a name="line-1226"></a><a name="illegalBufferSize"></a><span class='hs-definition'>illegalBufferSize</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span> <a name="line-1227"></a><span class='hs-definition'>illegalBufferSize</span> <span class='hs-varid'>handle</span> <span class='hs-varid'>fn</span> <span class='hs-varid'>sz</span> <span class='hs-keyglyph'>=</span> <a name="line-1228"></a> <span class='hs-varid'>ioError</span> <span class='hs-layout'>(</span><span class='hs-varid'>mkIOError</span> <span class='hs-varid'>illegalOperationErrorType</span> <span class='hs-varid'>msg</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>handle</span><span class='hs-layout'>)</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span> <a name="line-1229"></a> <span class='hs-comment'>--TODO: System.IO uses InvalidArgument here, but it's not exported :-(</span> <a name="line-1230"></a> <span class='hs-keyword'>where</span> <a name="line-1231"></a> <span class='hs-varid'>msg</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fn</span> <span class='hs-varop'>++</span> <span class='hs-str'>": illegal ByteString size "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>showsPrec</span> <span class='hs-num'>9</span> <span class='hs-varid'>sz</span> <span class='hs-conid'>[]</span> <a name="line-1232"></a> <a name="line-1233"></a><a name="hGetContents"></a><span class='hs-comment'>-- | Read entire handle contents /lazily/ into a 'ByteString'. Chunks</span> <a name="line-1234"></a><span class='hs-comment'>-- are read on demand, using the default chunk size.</span> <a name="line-1235"></a><span class='hs-comment'>--</span> <a name="line-1236"></a><span class='hs-comment'>-- Once EOF is encountered, the Handle is closed.</span> <a name="line-1237"></a><span class='hs-comment'>--</span> <a name="line-1238"></a><span class='hs-comment'>-- Note: the 'Handle' should be placed in binary mode with</span> <a name="line-1239"></a><span class='hs-comment'>-- 'System.IO.hSetBinaryMode' for 'hGetContents' to</span> <a name="line-1240"></a><span class='hs-comment'>-- work correctly.</span> <a name="line-1241"></a><span class='hs-comment'>--</span> <a name="line-1242"></a><span class='hs-definition'>hGetContents</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1243"></a><span class='hs-definition'>hGetContents</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetContentsN</span> <span class='hs-varid'>defaultChunkSize</span> <a name="line-1244"></a> <a name="line-1245"></a><a name="hGet"></a><span class='hs-comment'>-- | Read @n@ bytes into a 'ByteString', directly from the specified 'Handle'.</span> <a name="line-1246"></a><span class='hs-comment'>--</span> <a name="line-1247"></a><span class='hs-definition'>hGet</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1248"></a><span class='hs-definition'>hGet</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetN</span> <span class='hs-varid'>defaultChunkSize</span> <a name="line-1249"></a> <a name="line-1250"></a><span class='hs-comment'>-- | hGetNonBlocking is similar to 'hGet', except that it will never block</span> <a name="line-1251"></a><span class='hs-comment'>-- waiting for data to become available, instead it returns only whatever data</span> <a name="line-1252"></a><span class='hs-comment'>-- is available.</span> <a name="line-1253"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span> <a name="line-1254"></a><a name="hGetNonBlocking"></a><span class='hs-definition'>hGetNonBlocking</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1255"></a><span class='hs-definition'>hGetNonBlocking</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetNonBlockingN</span> <span class='hs-varid'>defaultChunkSize</span> <a name="line-1256"></a><span class='hs-cpp'>#else</span> <a name="line-1257"></a><span class='hs-definition'>hGetNonBlocking</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGet</span> <a name="line-1258"></a><span class='hs-cpp'>#endif</span> <a name="line-1259"></a> <a name="line-1260"></a><a name="readFile"></a><span class='hs-comment'>-- | Read an entire file /lazily/ into a 'ByteString'.</span> <a name="line-1261"></a><span class='hs-comment'>-- The Handle will be held open until EOF is encountered.</span> <a name="line-1262"></a><span class='hs-comment'>--</span> <a name="line-1263"></a><span class='hs-definition'>readFile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1264"></a><span class='hs-definition'>readFile</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>openBinaryFile</span> <span class='hs-varid'>f</span> <span class='hs-conid'>ReadMode</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>hGetContents</span> <a name="line-1265"></a> <a name="line-1266"></a><a name="writeFile"></a><span class='hs-comment'>-- | Write a 'ByteString' to a file.</span> <a name="line-1267"></a><span class='hs-comment'>--</span> <a name="line-1268"></a><span class='hs-definition'>writeFile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1269"></a><span class='hs-definition'>writeFile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>txt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>bracket</span> <span class='hs-layout'>(</span><span class='hs-varid'>openBinaryFile</span> <span class='hs-varid'>f</span> <span class='hs-conid'>WriteMode</span><span class='hs-layout'>)</span> <span class='hs-varid'>hClose</span> <a name="line-1270"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>hdl</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>hdl</span> <span class='hs-varid'>txt</span><span class='hs-layout'>)</span> <a name="line-1271"></a> <a name="line-1272"></a><a name="appendFile"></a><span class='hs-comment'>-- | Append a 'ByteString' to a file.</span> <a name="line-1273"></a><span class='hs-comment'>--</span> <a name="line-1274"></a><span class='hs-definition'>appendFile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1275"></a><span class='hs-definition'>appendFile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>txt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>bracket</span> <span class='hs-layout'>(</span><span class='hs-varid'>openBinaryFile</span> <span class='hs-varid'>f</span> <span class='hs-conid'>AppendMode</span><span class='hs-layout'>)</span> <span class='hs-varid'>hClose</span> <a name="line-1276"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>hdl</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>hdl</span> <span class='hs-varid'>txt</span><span class='hs-layout'>)</span> <a name="line-1277"></a> <a name="line-1278"></a><a name="getContents"></a><span class='hs-comment'>-- | getContents. Equivalent to hGetContents stdin. Will read /lazily/</span> <a name="line-1279"></a><span class='hs-comment'>--</span> <a name="line-1280"></a><span class='hs-definition'>getContents</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span> <a name="line-1281"></a><span class='hs-definition'>getContents</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetContents</span> <span class='hs-varid'>stdin</span> <a name="line-1282"></a> <a name="line-1283"></a><a name="hPut"></a><span class='hs-comment'>-- | Outputs a 'ByteString' to the specified 'Handle'.</span> <a name="line-1284"></a><span class='hs-comment'>--</span> <a name="line-1285"></a><span class='hs-definition'>hPut</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1286"></a><span class='hs-definition'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldrChunks</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>c</span> <span class='hs-varid'>rest</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-varid'>c</span> <span class='hs-varop'>>></span> <span class='hs-varid'>rest</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-1287"></a> <a name="line-1288"></a><a name="hPutStr"></a><span class='hs-comment'>-- | A synonym for @hPut@, for compatibility</span> <a name="line-1289"></a><span class='hs-comment'>--</span> <a name="line-1290"></a><span class='hs-definition'>hPutStr</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1291"></a><span class='hs-definition'>hPutStr</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span> <a name="line-1292"></a> <a name="line-1293"></a><a name="putStr"></a><span class='hs-comment'>-- | Write a ByteString to stdout</span> <a name="line-1294"></a><span class='hs-definition'>putStr</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1295"></a><span class='hs-definition'>putStr</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>stdout</span> <a name="line-1296"></a> <a name="line-1297"></a><a name="putStrLn"></a><span class='hs-comment'>-- | Write a ByteString to stdout, appending a newline byte</span> <a name="line-1298"></a><span class='hs-comment'>--</span> <a name="line-1299"></a><span class='hs-definition'>putStrLn</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1300"></a><span class='hs-definition'>putStrLn</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>stdout</span> <span class='hs-varid'>ps</span> <span class='hs-varop'>>></span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>stdout</span> <span class='hs-layout'>(</span><span class='hs-varid'>singleton</span> <span class='hs-num'>0x0a</span><span class='hs-layout'>)</span> <a name="line-1301"></a> <a name="line-1302"></a><a name="interact"></a><span class='hs-comment'>-- | The interact function takes a function of type @ByteString -> ByteString@</span> <a name="line-1303"></a><span class='hs-comment'>-- as its argument. The entire input from the standard input device is passed</span> <a name="line-1304"></a><span class='hs-comment'>-- to this function as its argument, and the resulting string is output on the</span> <a name="line-1305"></a><span class='hs-comment'>-- standard output device.</span> <a name="line-1306"></a><span class='hs-comment'>--</span> <a name="line-1307"></a><span class='hs-definition'>interact</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <a name="line-1308"></a><span class='hs-definition'>interact</span> <span class='hs-varid'>transformer</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>putStr</span> <span class='hs-varop'>.</span> <span class='hs-varid'>transformer</span> <span class='hs-varop'>=<<</span> <span class='hs-varid'>getContents</span> <a name="line-1309"></a> <a name="line-1310"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-1311"></a><span class='hs-comment'>-- Internal utilities</span> <a name="line-1312"></a> <a name="line-1313"></a><a name="errorEmptyList"></a><span class='hs-comment'>-- Common up near identical calls to `error' to reduce the number</span> <a name="line-1314"></a><span class='hs-comment'>-- constant strings created when compiled:</span> <a name="line-1315"></a><span class='hs-definition'>errorEmptyList</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-1316"></a><span class='hs-definition'>errorEmptyList</span> <span class='hs-varid'>fun</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>moduleError</span> <span class='hs-varid'>fun</span> <span class='hs-str'>"empty ByteString"</span> <a name="line-1317"></a> <a name="line-1318"></a><a name="moduleError"></a><span class='hs-definition'>moduleError</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-1319"></a><span class='hs-definition'>moduleError</span> <span class='hs-varid'>fun</span> <span class='hs-varid'>msg</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-layout'>(</span><span class='hs-str'>"Data.ByteString.Lazy."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>fun</span> <span class='hs-varop'>++</span> <span class='hs-chr'>':'</span><span class='hs-conop'>:</span><span class='hs-chr'>' '</span><span class='hs-conop'>:</span><span class='hs-varid'>msg</span><span class='hs-layout'>)</span> <a name="line-1320"></a> <a name="line-1321"></a> <a name="line-1322"></a><a name="revNonEmptyChunks"></a><span class='hs-comment'>-- reverse a list of non-empty chunks into a lazy ByteString</span> <a name="line-1323"></a><span class='hs-definition'>revNonEmptyChunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-1324"></a><span class='hs-definition'>revNonEmptyChunks</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl'</span> <span class='hs-layout'>(</span><span class='hs-varid'>flip</span> <span class='hs-conid'>Chunk</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>cs</span> <a name="line-1325"></a> <a name="line-1326"></a><a name="revChunks"></a><span class='hs-comment'>-- reverse a list of possibly-empty chunks into a lazy ByteString</span> <a name="line-1327"></a><span class='hs-definition'>revChunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-1328"></a><span class='hs-definition'>revChunks</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl'</span> <span class='hs-layout'>(</span><span class='hs-varid'>flip</span> <span class='hs-varid'>chunk</span><span class='hs-layout'>)</span> <span class='hs-conid'>Empty</span> <span class='hs-varid'>cs</span> <a name="line-1329"></a> <a name="line-1330"></a><a name="findIndexOrEnd"></a><span class='hs-comment'>-- | 'findIndexOrEnd' is a variant of findIndex, that returns the length</span> <a name="line-1331"></a><span class='hs-comment'>-- of the string if no element is found, rather than Nothing.</span> <a name="line-1332"></a><span class='hs-definition'>findIndexOrEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <a name="line-1333"></a><span class='hs-definition'>findIndexOrEnd</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>inlinePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <a name="line-1334"></a> <span class='hs-keyword'>where</span> <a name="line-1335"></a> <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span> <a name="line-1336"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>l</span> <a name="line-1337"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>ptr</span> <a name="line-1338"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>k</span> <span class='hs-varid'>w</span> <a name="line-1339"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varid'>n</span> <a name="line-1340"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-1341"></a><span class='hs-comment'>{-# INLINE findIndexOrEnd #-}</span> </pre></body> </html>