<?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/Char8.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_HADDOCK prune #-}</span>
<a name="line-3"></a>
<a name="line-4"></a><span class='hs-comment'>-- |</span>
<a name="line-5"></a><span class='hs-comment'>-- Module : Data.ByteString.Lazy.Char8</span>
<a name="line-6"></a><span class='hs-comment'>-- Copyright : (c) Don Stewart 2006</span>
<a name="line-7"></a><span class='hs-comment'>-- License : BSD-style</span>
<a name="line-8"></a><span class='hs-comment'>--</span>
<a name="line-9"></a><span class='hs-comment'>-- Maintainer : dons@cse.unsw.edu.au</span>
<a name="line-10"></a><span class='hs-comment'>-- Stability : experimental</span>
<a name="line-11"></a><span class='hs-comment'>-- Portability : non-portable (imports Data.ByteString.Lazy)</span>
<a name="line-12"></a><span class='hs-comment'>--</span>
<a name="line-13"></a><span class='hs-comment'>-- Manipulate /lazy/ 'ByteString's using 'Char' operations. All Chars will</span>
<a name="line-14"></a><span class='hs-comment'>-- be truncated to 8 bits. It can be expected that these functions will</span>
<a name="line-15"></a><span class='hs-comment'>-- run at identical speeds to their 'Data.Word.Word8' equivalents in</span>
<a name="line-16"></a><span class='hs-comment'>-- "Data.ByteString.Lazy".</span>
<a name="line-17"></a><span class='hs-comment'>--</span>
<a name="line-18"></a><span class='hs-comment'>-- This module is intended to be imported @qualified@, to avoid name</span>
<a name="line-19"></a><span class='hs-comment'>-- clashes with "Prelude" functions. eg.</span>
<a name="line-20"></a><span class='hs-comment'>--</span>
<a name="line-21"></a><span class='hs-comment'>-- > import qualified Data.ByteString.Lazy.Char8 as C</span>
<a name="line-22"></a><span class='hs-comment'>--</span>
<a name="line-23"></a>
<a name="line-24"></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-varop'>.</span><span class='hs-conid'>Char8</span> <span class='hs-layout'>(</span>
<a name="line-25"></a>
<a name="line-26"></a> <span class='hs-comment'>-- * The @ByteString@ type</span>
<a name="line-27"></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-28"></a>
<a name="line-29"></a> <span class='hs-comment'>-- * Introducing and eliminating 'ByteString's</span>
<a name="line-30"></a> <span class='hs-varid'>empty</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString</span>
<a name="line-31"></a> <span class='hs-varid'>singleton</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString</span>
<a name="line-32"></a> <span class='hs-varid'>pack</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: String -> ByteString</span>
<a name="line-33"></a> <span class='hs-varid'>unpack</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> String</span>
<a name="line-34"></a> <span class='hs-varid'>fromChunks</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [Strict.ByteString] -> ByteString</span>
<a name="line-35"></a> <span class='hs-varid'>toChunks</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [Strict.ByteString]</span>
<a name="line-36"></a>
<a name="line-37"></a> <span class='hs-comment'>-- * Basic interface</span>
<a name="line-38"></a> <span class='hs-varid'>cons</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> ByteString</span>
<a name="line-39"></a> <span class='hs-varid'>cons'</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> ByteString</span>
<a name="line-40"></a> <span class='hs-varid'>snoc</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char -> ByteString</span>
<a name="line-41"></a> <span class='hs-varid'>append</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> ByteString</span>
<a name="line-42"></a> <span class='hs-varid'>head</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span>
<a name="line-43"></a> <span class='hs-varid'>uncons</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Maybe (Char, ByteString)</span>
<a name="line-44"></a> <span class='hs-varid'>last</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span>
<a name="line-45"></a> <span class='hs-varid'>tail</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span>
<a name="line-46"></a> <span class='hs-varid'>init</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span>
<a name="line-47"></a> <span class='hs-varid'>null</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Bool</span>
<a name="line-48"></a> <span class='hs-varid'>length</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Int64</span>
<a name="line-49"></a>
<a name="line-50"></a> <span class='hs-comment'>-- * Transforming ByteStrings</span>
<a name="line-51"></a> <span class='hs-varid'>map</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char) -> ByteString -> ByteString</span>
<a name="line-52"></a> <span class='hs-varid'>reverse</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span>
<a name="line-53"></a> <span class='hs-varid'>intersperse</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> ByteString</span>
<a name="line-54"></a> <span class='hs-varid'>intercalate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString] -> ByteString</span>
<a name="line-55"></a> <span class='hs-varid'>transpose</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> [ByteString]</span>
<a name="line-56"></a>
<a name="line-57"></a> <span class='hs-comment'>-- * Reducing 'ByteString's (folds)</span>
<a name="line-58"></a> <span class='hs-varid'>foldl</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (a -> Char -> a) -> a -> ByteString -> a</span>
<a name="line-59"></a> <span class='hs-varid'>foldl'</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (a -> Char -> a) -> a -> ByteString -> a</span>
<a name="line-60"></a> <span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> ByteString -> Char</span>
<a name="line-61"></a> <span class='hs-varid'>foldl1'</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> ByteString -> Char</span>
<a name="line-62"></a> <span class='hs-varid'>foldr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> a -> a) -> a -> ByteString -> a</span>
<a name="line-63"></a> <span class='hs-varid'>foldr1</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> ByteString -> Char</span>
<a name="line-64"></a>
<a name="line-65"></a> <span class='hs-comment'>-- ** Special folds</span>
<a name="line-66"></a> <span class='hs-varid'>concat</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> ByteString</span>
<a name="line-67"></a> <span class='hs-varid'>concatMap</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> ByteString) -> ByteString -> ByteString</span>
<a name="line-68"></a> <span class='hs-varid'>any</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Bool</span>
<a name="line-69"></a> <span class='hs-varid'>all</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Bool</span>
<a name="line-70"></a> <span class='hs-varid'>maximum</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span>
<a name="line-71"></a> <span class='hs-varid'>minimum</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span>
<a name="line-72"></a>
<a name="line-73"></a> <span class='hs-comment'>-- * Building ByteStrings</span>
<a name="line-74"></a> <span class='hs-comment'>-- ** Scans</span>
<a name="line-75"></a> <span class='hs-varid'>scanl</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> Char -> ByteString -> ByteString</span>
<a name="line-76"></a><span class='hs-comment'>-- scanl1, -- :: (Char -> Char -> Char) -> ByteString -> ByteString</span>
<a name="line-77"></a><span class='hs-comment'>-- scanr, -- :: (Char -> Char -> Char) -> Char -> ByteString -> ByteString</span>
<a name="line-78"></a><span class='hs-comment'>-- scanr1, -- :: (Char -> Char -> Char) -> ByteString -> ByteString</span>
<a name="line-79"></a>
<a name="line-80"></a> <span class='hs-comment'>-- ** Accumulating maps</span>
<a name="line-81"></a> <span class='hs-varid'>mapAccumL</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (acc -> Char -> (acc, Char)) -> acc -> ByteString -> (acc, ByteString)</span>
<a name="line-82"></a> <span class='hs-varid'>mapAccumR</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (acc -> Char -> (acc, Char)) -> acc -> ByteString -> (acc, ByteString)</span>
<a name="line-83"></a>
<a name="line-84"></a> <span class='hs-comment'>-- ** Infinite ByteStrings</span>
<a name="line-85"></a> <span class='hs-varid'>repeat</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString</span>
<a name="line-86"></a> <span class='hs-varid'>replicate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> Char -> ByteString</span>
<a name="line-87"></a> <span class='hs-varid'>cycle</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span>
<a name="line-88"></a> <span class='hs-varid'>iterate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char) -> Char -> ByteString</span>
<a name="line-89"></a>
<a name="line-90"></a> <span class='hs-comment'>-- ** Unfolding ByteStrings</span>
<a name="line-91"></a> <span class='hs-varid'>unfoldr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (a -> Maybe (Char, a)) -> a -> ByteString</span>
<a name="line-92"></a>
<a name="line-93"></a> <span class='hs-comment'>-- * Substrings</span>
<a name="line-94"></a>
<a name="line-95"></a> <span class='hs-comment'>-- ** Breaking strings</span>
<a name="line-96"></a> <span class='hs-varid'>take</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> ByteString -> ByteString</span>
<a name="line-97"></a> <span class='hs-varid'>drop</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> ByteString -> ByteString</span>
<a name="line-98"></a> <span class='hs-varid'>splitAt</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int64 -> ByteString -> (ByteString, ByteString)</span>
<a name="line-99"></a> <span class='hs-varid'>takeWhile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> ByteString</span>
<a name="line-100"></a> <span class='hs-varid'>dropWhile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> ByteString</span>
<a name="line-101"></a> <span class='hs-varid'>span</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> (ByteString, ByteString)</span>
<a name="line-102"></a> <span class='hs-varid'>break</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> (ByteString, ByteString)</span>
<a name="line-103"></a> <span class='hs-varid'>group</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span>
<a name="line-104"></a> <span class='hs-varid'>groupBy</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Bool) -> ByteString -> [ByteString]</span>
<a name="line-105"></a> <span class='hs-varid'>inits</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span>
<a name="line-106"></a> <span class='hs-varid'>tails</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span>
<a name="line-107"></a>
<a name="line-108"></a> <span class='hs-comment'>-- ** Breaking into many substrings</span>
<a name="line-109"></a> <span class='hs-varid'>split</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> [ByteString]</span>
<a name="line-110"></a> <span class='hs-varid'>splitWith</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> [ByteString]</span>
<a name="line-111"></a>
<a name="line-112"></a> <span class='hs-comment'>-- ** Breaking into lines and words</span>
<a name="line-113"></a> <span class='hs-varid'>lines</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span>
<a name="line-114"></a> <span class='hs-varid'>words</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span>
<a name="line-115"></a> <span class='hs-varid'>unlines</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> ByteString</span>
<a name="line-116"></a> <span class='hs-varid'>unwords</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span>
<a name="line-117"></a>
<a name="line-118"></a> <span class='hs-comment'>-- * Predicates</span>
<a name="line-119"></a> <span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Bool</span>
<a name="line-120"></a><span class='hs-comment'>-- isSuffixOf, -- :: ByteString -> ByteString -> Bool</span>
<a name="line-121"></a>
<a name="line-122"></a> <span class='hs-comment'>-- * Searching ByteStrings</span>
<a name="line-123"></a>
<a name="line-124"></a> <span class='hs-comment'>-- ** Searching by equality</span>
<a name="line-125"></a> <span class='hs-varid'>elem</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Bool</span>
<a name="line-126"></a> <span class='hs-varid'>notElem</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Bool</span>
<a name="line-127"></a>
<a name="line-128"></a> <span class='hs-comment'>-- ** Searching with a predicate</span>
<a name="line-129"></a> <span class='hs-varid'>find</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Maybe Char</span>
<a name="line-130"></a> <span class='hs-varid'>filter</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> ByteString</span>
<a name="line-131"></a><span class='hs-comment'>-- partition -- :: (Char -> Bool) -> ByteString -> (ByteString, ByteString)</span>
<a name="line-132"></a>
<a name="line-133"></a> <span class='hs-comment'>-- * Indexing ByteStrings</span>
<a name="line-134"></a> <span class='hs-varid'>index</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Int64 -> Char</span>
<a name="line-135"></a> <span class='hs-varid'>elemIndex</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Maybe Int64</span>
<a name="line-136"></a> <span class='hs-varid'>elemIndices</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> [Int64]</span>
<a name="line-137"></a> <span class='hs-varid'>findIndex</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Maybe Int64</span>
<a name="line-138"></a> <span class='hs-varid'>findIndices</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> [Int64]</span>
<a name="line-139"></a> <span class='hs-varid'>count</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Int64</span>
<a name="line-140"></a>
<a name="line-141"></a> <span class='hs-comment'>-- * Zipping and unzipping ByteStrings</span>
<a name="line-142"></a> <span class='hs-varid'>zip</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> [(Char,Char)]</span>
<a name="line-143"></a> <span class='hs-varid'>zipWith</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> c) -> ByteString -> ByteString -> [c]</span>
<a name="line-144"></a><span class='hs-comment'>-- unzip, -- :: [(Char,Char)] -> (ByteString,ByteString)</span>
<a name="line-145"></a>
<a name="line-146"></a> <span class='hs-comment'>-- * Ordered ByteStrings</span>
<a name="line-147"></a><span class='hs-comment'>-- sort, -- :: ByteString -> ByteString</span>
<a name="line-148"></a>
<a name="line-149"></a> <span class='hs-comment'>-- * Low level conversions</span>
<a name="line-150"></a> <span class='hs-comment'>-- ** Copying ByteStrings</span>
<a name="line-151"></a> <span class='hs-varid'>copy</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span>
<a name="line-152"></a>
<a name="line-153"></a> <span class='hs-comment'>-- * Reading from ByteStrings</span>
<a name="line-154"></a> <span class='hs-varid'>readInt</span><span class='hs-layout'>,</span>
<a name="line-155"></a> <span class='hs-varid'>readInteger</span><span class='hs-layout'>,</span>
<a name="line-156"></a>
<a name="line-157"></a> <span class='hs-comment'>-- * I\/O with 'ByteString's</span>
<a name="line-158"></a>
<a name="line-159"></a> <span class='hs-comment'>-- ** Standard input and output</span>
<a name="line-160"></a> <span class='hs-varid'>getContents</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: IO ByteString</span>
<a name="line-161"></a> <span class='hs-varid'>putStr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> IO ()</span>
<a name="line-162"></a> <span class='hs-varid'>putStrLn</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> IO ()</span>
<a name="line-163"></a> <span class='hs-varid'>interact</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (ByteString -> ByteString) -> IO ()</span>
<a name="line-164"></a>
<a name="line-165"></a> <span class='hs-comment'>-- ** Files</span>
<a name="line-166"></a> <span class='hs-varid'>readFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> IO ByteString</span>
<a name="line-167"></a> <span class='hs-varid'>writeFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> ByteString -> IO ()</span>
<a name="line-168"></a> <span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> ByteString -> IO ()</span>
<a name="line-169"></a>
<a name="line-170"></a> <span class='hs-comment'>-- ** I\/O with Handles</span>
<a name="line-171"></a> <span class='hs-varid'>hGetContents</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> IO ByteString</span>
<a name="line-172"></a> <span class='hs-varid'>hGet</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> Int64 -> IO ByteString</span>
<a name="line-173"></a> <span class='hs-varid'>hGetNonBlocking</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> Int64 -> IO ByteString</span>
<a name="line-174"></a> <span class='hs-varid'>hPut</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> ByteString -> IO ()</span>
<a name="line-175"></a>
<a name="line-176"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-177"></a>
<a name="line-178"></a><span class='hs-comment'>-- Functions transparently exported</span>
<a name="line-179"></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>
<a name="line-180"></a> <span class='hs-layout'>(</span><span class='hs-varid'>fromChunks</span><span class='hs-layout'>,</span> <span class='hs-varid'>toChunks</span>
<a name="line-181"></a> <span class='hs-layout'>,</span><span class='hs-varid'>empty</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'>tail</span><span class='hs-layout'>,</span><span class='hs-varid'>init</span><span class='hs-layout'>,</span><span class='hs-varid'>append</span><span class='hs-layout'>,</span><span class='hs-varid'>reverse</span><span class='hs-layout'>,</span><span class='hs-varid'>transpose</span><span class='hs-layout'>,</span><span class='hs-varid'>cycle</span>
<a name="line-182"></a> <span class='hs-layout'>,</span><span class='hs-varid'>concat</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'>intercalate</span><span class='hs-layout'>,</span><span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span><span class='hs-varid'>group</span><span class='hs-layout'>,</span><span class='hs-varid'>inits</span><span class='hs-layout'>,</span><span class='hs-varid'>tails</span><span class='hs-layout'>,</span><span class='hs-varid'>copy</span>
<a name="line-183"></a> <span class='hs-layout'>,</span><span class='hs-varid'>hGetContents</span><span class='hs-layout'>,</span> <span class='hs-varid'>hGet</span><span class='hs-layout'>,</span> <span class='hs-varid'>hPut</span><span class='hs-layout'>,</span> <span class='hs-varid'>getContents</span>
<a name="line-184"></a> <span class='hs-layout'>,</span><span class='hs-varid'>hGetNonBlocking</span>
<a name="line-185"></a> <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'>interact</span><span class='hs-layout'>)</span>
<a name="line-186"></a>
<a name="line-187"></a><span class='hs-comment'>-- Functions we need to wrap.</span>
<a name="line-188"></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'>Lazy</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>L</span>
<a name="line-189"></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-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- typename only</span>
<a name="line-190"></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'>B</span>
<a name="line-191"></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'>B</span>
<a name="line-192"></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-193"></a>
<a name="line-194"></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'>Internal</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span><span class='hs-layout'>,</span> <span class='hs-varid'>c2w</span><span class='hs-layout'>,</span> <span class='hs-varid'>isSpaceWord8</span><span class='hs-layout'>)</span>
<a name="line-195"></a>
<a name="line-196"></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-197"></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'>List</span>
<a name="line-198"></a>
<a name="line-199"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Prelude</span> <span class='hs-varid'>hiding</span>
<a name="line-200"></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-201"></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>
<a name="line-202"></a> <span class='hs-layout'>,</span><span class='hs-varid'>unwords</span><span class='hs-layout'>,</span><span class='hs-varid'>words</span><span class='hs-layout'>,</span><span class='hs-varid'>maximum</span><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'>scanl</span><span class='hs-layout'>,</span><span class='hs-varid'>scanl1</span><span class='hs-layout'>,</span><span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span><span class='hs-varid'>foldr1</span>
<a name="line-203"></a> <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><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>
<a name="line-204"></a> <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><span class='hs-varid'>repeat</span><span class='hs-layout'>,</span><span class='hs-varid'>iterate</span><span class='hs-layout'>,</span><span class='hs-varid'>interact</span><span class='hs-layout'>,</span><span class='hs-varid'>cycle</span><span class='hs-layout'>)</span>
<a name="line-205"></a>
<a name="line-206"></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-varid'>hClose</span><span class='hs-layout'>,</span><span class='hs-varid'>openFile</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><span class='hs-layout'>)</span>
<a name="line-207"></a><span class='hs-cpp'>#ifndef __NHC__</span>
<a name="line-208"></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-209"></a><span class='hs-cpp'>#else</span>
<a name="line-210"></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-211"></a><span class='hs-cpp'>#endif</span>
<a name="line-212"></a>
<a name="line-213"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 608</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'>String</span> <span class='hs-layout'>(</span><span class='hs-conid'>IsString</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-215"></a><span class='hs-cpp'>#endif</span>
<a name="line-216"></a>
<a name="line-217"></a><span class='hs-cpp'>#define STRICT1(f) f a | a `seq` False = undefined</span>
<a name="line-218"></a><span class='hs-cpp'>#define STRICT2(f) f a b | a `seq` b `seq` False = undefined</span>
<a name="line-219"></a><span class='hs-cpp'>#define STRICT3(f) f a b c | a `seq` b `seq` c `seq` False = undefined</span>
<a name="line-220"></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-221"></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-222"></a><span class='hs-cpp'>#define STRICT5_(f) f a b c d _ | a `seq` b `seq` c `seq` d `seq` False = undefined</span>
<a name="line-223"></a>
<a name="line-224"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-225"></a>
<a name="line-226"></a><a name="singleton"></a><span class='hs-comment'>-- | /O(1)/ Convert a 'Char' into a 'ByteString'</span>
<a name="line-227"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span>
<a name="line-228"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>singleton</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-229"></a><span class='hs-comment'>{-# INLINE singleton #-}</span>
<a name="line-230"></a>
<a name="line-231"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 608</span>
<a name="line-232"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>IsString</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyword'>where</span>
<a name="line-233"></a> <span class='hs-varid'>fromString</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>pack</span>
<a name="line-234"></a> <span class='hs-comment'>{-# INLINE fromString #-}</span>
<a name="line-235"></a><span class='hs-cpp'>#endif</span>
<a name="line-236"></a>
<a name="line-237"></a><a name="pack"></a><span class='hs-comment'>-- | /O(n)/ Convert a 'String' into a 'ByteString'. </span>
<a name="line-238"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Char</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span>
<a name="line-239"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>pack</span><span class='hs-varop'>.</span> <span class='hs-conid'>List</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>c2w</span>
<a name="line-240"></a>
<a name="line-241"></a><a name="unpack"></a><span class='hs-comment'>-- | /O(n)/ Converts a 'ByteString' to a 'String'.</span>
<a name="line-242"></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'>Char</span><span class='hs-keyglyph'>]</span>
<a name="line-243"></a><span class='hs-definition'>unpack</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>List</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>unpack</span>
<a name="line-244"></a><span class='hs-comment'>{-# INLINE unpack #-}</span>
<a name="line-245"></a>
<a name="line-246"></a><a name="cons"></a><span class='hs-comment'>-- | /O(1)/ 'cons' is analogous to '(:)' for lists.</span>
<a name="line-247"></a><span class='hs-definition'>cons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-248"></a><span class='hs-definition'>cons</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>cons</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-249"></a><span class='hs-comment'>{-# INLINE cons #-}</span>
<a name="line-250"></a>
<a name="line-251"></a><a name="cons'"></a><span class='hs-comment'>-- | /O(1)/ Unlike 'cons', 'cons\'' is</span>
<a name="line-252"></a><span class='hs-comment'>-- strict in the ByteString that we are consing onto. More precisely, it forces</span>
<a name="line-253"></a><span class='hs-comment'>-- the head and the first chunk. It does this because, for space efficiency, it</span>
<a name="line-254"></a><span class='hs-comment'>-- may coalesce the new byte onto the first \'chunk\' rather than starting a</span>
<a name="line-255"></a><span class='hs-comment'>-- new \'chunk\'.</span>
<a name="line-256"></a><span class='hs-comment'>--</span>
<a name="line-257"></a><span class='hs-comment'>-- So that means you can't use a lazy recursive contruction like this:</span>
<a name="line-258"></a><span class='hs-comment'>--</span>
<a name="line-259"></a><span class='hs-comment'>-- > let xs = cons\' c xs in xs</span>
<a name="line-260"></a><span class='hs-comment'>--</span>
<a name="line-261"></a><span class='hs-comment'>-- You can however use 'cons', as well as 'repeat' and 'cycle', to build</span>
<a name="line-262"></a><span class='hs-comment'>-- infinite lazy ByteStrings.</span>
<a name="line-263"></a><span class='hs-comment'>--</span>
<a name="line-264"></a><span class='hs-definition'>cons'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-265"></a><span class='hs-definition'>cons'</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>cons'</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-266"></a><span class='hs-comment'>{-# INLINE cons' #-}</span>
<a name="line-267"></a>
<a name="line-268"></a><a name="snoc"></a><span class='hs-comment'>-- | /O(n)/ Append a Char to the end of a 'ByteString'. Similar to</span>
<a name="line-269"></a><span class='hs-comment'>-- 'cons', this function performs a memcpy.</span>
<a name="line-270"></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'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span>
<a name="line-271"></a><span class='hs-definition'>snoc</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>snoc</span> <span class='hs-varid'>p</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-272"></a><span class='hs-comment'>{-# INLINE snoc #-}</span>
<a name="line-273"></a>
<a name="line-274"></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-275"></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'>Char</span>
<a name="line-276"></a><span class='hs-definition'>head</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>head</span>
<a name="line-277"></a><span class='hs-comment'>{-# INLINE head #-}</span>
<a name="line-278"></a>
<a name="line-279"></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-280"></a><span class='hs-comment'>-- if it is empty.</span>
<a name="line-281"></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'>Char</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span>
<a name="line-282"></a><span class='hs-definition'>uncons</span> <span class='hs-varid'>bs</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'>uncons</span> <span class='hs-varid'>bs</span> <span class='hs-keyword'>of</span>
<a name="line-283"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span>
<a name="line-284"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>w</span><span class='hs-layout'>,</span> <span class='hs-varid'>bs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>w</span><span class='hs-layout'>,</span> <span class='hs-varid'>bs'</span><span class='hs-layout'>)</span>
<a name="line-285"></a><span class='hs-comment'>{-# INLINE uncons #-}</span>
<a name="line-286"></a>
<a name="line-287"></a><a name="last"></a><span class='hs-comment'>-- | /O(1)/ Extract the last element of a packed string, which must be non-empty.</span>
<a name="line-288"></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'>Char</span>
<a name="line-289"></a><span class='hs-definition'>last</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>last</span>
<a name="line-290"></a><span class='hs-comment'>{-# INLINE last #-}</span>
<a name="line-291"></a>
<a name="line-292"></a><a name="map"></a><span class='hs-comment'>-- | /O(n)/ 'map' @f xs@ is the ByteString obtained by applying @f@ to each element of @xs@</span>
<a name="line-293"></a><span class='hs-definition'>map</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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-294"></a><span class='hs-definition'>map</span> <span class='hs-varid'>f</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-varid'>c2w</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-295"></a><span class='hs-comment'>{-# INLINE map #-}</span>
<a name="line-296"></a>
<a name="line-297"></a><a name="intersperse"></a><span class='hs-comment'>-- | /O(n)/ The 'intersperse' function takes a Char and a 'ByteString'</span>
<a name="line-298"></a><span class='hs-comment'>-- and \`intersperses\' that Char between the elements of the</span>
<a name="line-299"></a><span class='hs-comment'>-- 'ByteString'. It is analogous to the intersperse function on Lists.</span>
<a name="line-300"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-301"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-302"></a><span class='hs-comment'>{-# INLINE intersperse #-}</span>
<a name="line-303"></a>
<a name="line-304"></a><a name="foldl"></a><span class='hs-comment'>-- | 'foldl', applied to a binary operator, a starting value (typically</span>
<a name="line-305"></a><span class='hs-comment'>-- the left-identity of the operator), and a ByteString, reduces the</span>
<a name="line-306"></a><span class='hs-comment'>-- ByteString using the binary operator, from left to right.</span>
<a name="line-307"></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'>Char</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-308"></a><span class='hs-definition'>foldl</span> <span class='hs-varid'>f</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-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-309"></a><span class='hs-comment'>{-# INLINE foldl #-}</span>
<a name="line-310"></a>
<a name="line-311"></a><a name="foldl'"></a><span class='hs-comment'>-- | 'foldl\'' is like foldl, but strict in the accumulator.</span>
<a name="line-312"></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'>Char</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-313"></a><span class='hs-definition'>foldl'</span> <span class='hs-varid'>f</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-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-314"></a><span class='hs-comment'>{-# INLINE foldl' #-}</span>
<a name="line-315"></a>
<a name="line-316"></a><a name="foldr"></a><span class='hs-comment'>-- | 'foldr', applied to a binary operator, a starting value</span>
<a name="line-317"></a><span class='hs-comment'>-- (typically the right-identity of the operator), and a packed string,</span>
<a name="line-318"></a><span class='hs-comment'>-- reduces the packed string using the binary operator, from right to left.</span>
<a name="line-319"></a><span class='hs-definition'>foldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-320"></a><span class='hs-definition'>foldr</span> <span class='hs-varid'>f</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-keyglyph'>\</span><span class='hs-varid'>c</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span>
<a name="line-321"></a><span class='hs-comment'>{-# INLINE foldr #-}</span>
<a name="line-322"></a>
<a name="line-323"></a><a name="foldl1"></a><span class='hs-comment'>-- | 'foldl1' is a variant of 'foldl' that has no starting value</span>
<a name="line-324"></a><span class='hs-comment'>-- argument, and thus must be applied to non-empty 'ByteStrings'.</span>
<a name="line-325"></a><span class='hs-definition'>foldl1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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'>Char</span>
<a name="line-326"></a><span class='hs-definition'>foldl1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl1</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>c2w</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-327"></a><span class='hs-comment'>{-# INLINE foldl1 #-}</span>
<a name="line-328"></a>
<a name="line-329"></a><a name="foldl1'"></a><span class='hs-comment'>-- | 'foldl1\'' is like 'foldl1', but strict in the accumulator.</span>
<a name="line-330"></a><span class='hs-definition'>foldl1'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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'>Char</span>
<a name="line-331"></a><span class='hs-definition'>foldl1'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl1'</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>c2w</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-332"></a>
<a name="line-333"></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-334"></a><span class='hs-comment'>-- and thus must be applied to non-empty 'ByteString's</span>
<a name="line-335"></a><span class='hs-definition'>foldr1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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'>Char</span>
<a name="line-336"></a><span class='hs-definition'>foldr1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr1</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>c2w</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-337"></a><span class='hs-comment'>{-# INLINE foldr1 #-}</span>
<a name="line-338"></a>
<a name="line-339"></a><a name="concatMap"></a><span class='hs-comment'>-- | Map a function over a 'ByteString' and concatenate the results</span>
<a name="line-340"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-341"></a><span class='hs-definition'>concatMap</span> <span class='hs-varid'>f</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-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-342"></a><span class='hs-comment'>{-# INLINE concatMap #-}</span>
<a name="line-343"></a>
<a name="line-344"></a><a name="any"></a><span class='hs-comment'>-- | Applied to a predicate and a ByteString, 'any' determines if</span>
<a name="line-345"></a><span class='hs-comment'>-- any element of the 'ByteString' satisfies the predicate.</span>
<a name="line-346"></a><span class='hs-definition'>any</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-347"></a><span class='hs-definition'>any</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>any</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-348"></a><span class='hs-comment'>{-# INLINE any #-}</span>
<a name="line-349"></a>
<a name="line-350"></a><a name="all"></a><span class='hs-comment'>-- | Applied to a predicate and a 'ByteString', 'all' determines if</span>
<a name="line-351"></a><span class='hs-comment'>-- all elements of the 'ByteString' satisfy the predicate.</span>
<a name="line-352"></a><span class='hs-definition'>all</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-353"></a><span class='hs-definition'>all</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>all</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-354"></a><span class='hs-comment'>{-# INLINE all #-}</span>
<a name="line-355"></a>
<a name="line-356"></a><a name="maximum"></a><span class='hs-comment'>-- | 'maximum' returns the maximum value from a 'ByteString'</span>
<a name="line-357"></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'>Char</span>
<a name="line-358"></a><span class='hs-definition'>maximum</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>maximum</span>
<a name="line-359"></a><span class='hs-comment'>{-# INLINE maximum #-}</span>
<a name="line-360"></a>
<a name="line-361"></a><a name="minimum"></a><span class='hs-comment'>-- | 'minimum' returns the minimum value from a 'ByteString'</span>
<a name="line-362"></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'>Char</span>
<a name="line-363"></a><span class='hs-definition'>minimum</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>minimum</span>
<a name="line-364"></a><span class='hs-comment'>{-# INLINE minimum #-}</span>
<a name="line-365"></a>
<a name="line-366"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-367"></a><span class='hs-comment'>-- Building ByteStrings</span>
<a name="line-368"></a>
<a name="line-369"></a><a name="scanl"></a><span class='hs-comment'>-- | 'scanl' is similar to 'foldl', but returns a list of successive</span>
<a name="line-370"></a><span class='hs-comment'>-- reduced values from the left. This function will fuse.</span>
<a name="line-371"></a><span class='hs-comment'>--</span>
<a name="line-372"></a><span class='hs-comment'>-- > scanl f z [x1, x2, ...] == [z, z `f` x1, (z `f` x1) `f` x2, ...]</span>
<a name="line-373"></a><span class='hs-comment'>--</span>
<a name="line-374"></a><span class='hs-comment'>-- Note that</span>
<a name="line-375"></a><span class='hs-comment'>--</span>
<a name="line-376"></a><span class='hs-comment'>-- > last (scanl f z xs) == foldl f z xs.</span>
<a name="line-377"></a><span class='hs-definition'>scanl</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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-378"></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-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>scanl</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>c2w</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>z</span><span class='hs-layout'>)</span>
<a name="line-379"></a>
<a name="line-380"></a><a name="mapAccumL"></a><span class='hs-comment'>-- | The 'mapAccumL' function behaves like a combination of 'map' and</span>
<a name="line-381"></a><span class='hs-comment'>-- 'foldl'; it applies a function to each element of a ByteString,</span>
<a name="line-382"></a><span class='hs-comment'>-- passing an accumulating parameter from left to right, and returning a</span>
<a name="line-383"></a><span class='hs-comment'>-- final value of this accumulator together with the new ByteString.</span>
<a name="line-384"></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'>Char</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'>Char</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-385"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>mapAccumL</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>f</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span> <span class='hs-layout'>(</span><span class='hs-varid'>a'</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-layout'>(</span><span class='hs-varid'>a'</span><span class='hs-layout'>,</span> <span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-386"></a>
<a name="line-387"></a><a name="mapAccumR"></a><span class='hs-comment'>-- | The 'mapAccumR' function behaves like a combination of 'map' and</span>
<a name="line-388"></a><span class='hs-comment'>-- 'foldr'; it applies a function to each element of a ByteString,</span>
<a name="line-389"></a><span class='hs-comment'>-- passing an accumulating parameter from right to left, and returning a</span>
<a name="line-390"></a><span class='hs-comment'>-- final value of this accumulator together with the new ByteString.</span>
<a name="line-391"></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'>Char</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'>Char</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-392"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>mapAccumR</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>acc</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>f</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc'</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-layout'>(</span><span class='hs-varid'>acc'</span><span class='hs-layout'>,</span> <span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-393"></a>
<a name="line-394"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-395"></a><span class='hs-comment'>-- Generating and unfolding ByteStrings</span>
<a name="line-396"></a>
<a name="line-397"></a><a name="iterate"></a><span class='hs-comment'>-- | @'iterate' f x@ returns an infinite ByteString of repeated applications</span>
<a name="line-398"></a><span class='hs-comment'>-- of @f@ to @x@:</span>
<a name="line-399"></a><span class='hs-comment'>--</span>
<a name="line-400"></a><span class='hs-comment'>-- > iterate f x == [x, f x, f (f x), ...]</span>
<a name="line-401"></a><span class='hs-comment'>--</span>
<a name="line-402"></a><span class='hs-definition'>iterate</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span>
<a name="line-403"></a><span class='hs-definition'>iterate</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>iterate</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-404"></a>
<a name="line-405"></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-406"></a><span class='hs-comment'>-- element.</span>
<a name="line-407"></a><span class='hs-comment'>--</span>
<a name="line-408"></a><span class='hs-definition'>repeat</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span>
<a name="line-409"></a><span class='hs-definition'>repeat</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>repeat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-410"></a>
<a name="line-411"></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-412"></a><span class='hs-comment'>-- the value of every element.</span>
<a name="line-413"></a><span class='hs-comment'>--</span>
<a name="line-414"></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'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span>
<a name="line-415"></a><span class='hs-definition'>replicate</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span> <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-416"></a>
<a name="line-417"></a><a name="unfoldr"></a><span class='hs-comment'>-- | /O(n)/ The 'unfoldr' function is analogous to the List \'unfoldr\'.</span>
<a name="line-418"></a><span class='hs-comment'>-- 'unfoldr' builds a ByteString from a seed value. The function takes</span>
<a name="line-419"></a><span class='hs-comment'>-- the element and returns 'Nothing' if it is done producing the</span>
<a name="line-420"></a><span class='hs-comment'>-- ByteString or returns 'Just' @(a,b)@, in which case, @a@ is a</span>
<a name="line-421"></a><span class='hs-comment'>-- prepending to the ByteString and @b@ is used as the next element in a</span>
<a name="line-422"></a><span class='hs-comment'>-- recursive call.</span>
<a name="line-423"></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'>Char</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-424"></a><span class='hs-definition'>unfoldr</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>unfoldr</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>f</span> <span class='hs-varid'>a</span> <span class='hs-keyword'>of</span>
<a name="line-425"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span>
<a name="line-426"></a> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</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-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>,</span> <span class='hs-varid'>a'</span><span class='hs-layout'>)</span>
<a name="line-427"></a>
<a name="line-428"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-429"></a>
<a name="line-430"></a><a name="takeWhile"></a><span class='hs-comment'>-- | 'takeWhile', applied to a predicate @p@ and a ByteString @xs@,</span>
<a name="line-431"></a><span class='hs-comment'>-- returns the longest prefix (possibly empty) of @xs@ of elements that</span>
<a name="line-432"></a><span class='hs-comment'>-- satisfy @p@.</span>
<a name="line-433"></a><span class='hs-definition'>takeWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-434"></a><span class='hs-definition'>takeWhile</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>takeWhile</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-435"></a><span class='hs-comment'>{-# INLINE takeWhile #-}</span>
<a name="line-436"></a>
<a name="line-437"></a><a name="dropWhile"></a><span class='hs-comment'>-- | 'dropWhile' @p xs@ returns the suffix remaining after 'takeWhile' @p xs@.</span>
<a name="line-438"></a><span class='hs-definition'>dropWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-439"></a><span class='hs-definition'>dropWhile</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>dropWhile</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-440"></a><span class='hs-comment'>{-# INLINE dropWhile #-}</span>
<a name="line-441"></a>
<a name="line-442"></a><a name="break"></a><span class='hs-comment'>-- | 'break' @p@ is equivalent to @'span' ('not' . p)@.</span>
<a name="line-443"></a><span class='hs-definition'>break</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-444"></a><span class='hs-definition'>break</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>break</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-445"></a><span class='hs-comment'>{-# INLINE break #-}</span>
<a name="line-446"></a>
<a name="line-447"></a><a name="span"></a><span class='hs-comment'>-- | 'span' @p xs@ breaks the ByteString into two segments. It is</span>
<a name="line-448"></a><span class='hs-comment'>-- equivalent to @('takeWhile' p xs, 'dropWhile' p xs)@</span>
<a name="line-449"></a><span class='hs-definition'>span</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-450"></a><span class='hs-definition'>span</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>span</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-451"></a><span class='hs-comment'>{-# INLINE span #-}</span>
<a name="line-452"></a>
<a name="line-453"></a><span class='hs-comment'>{-
<a name="line-454"></a>-- | 'breakChar' breaks its ByteString argument at the first occurence
<a name="line-455"></a>-- of the specified Char. It is more efficient than 'break' as it is
<a name="line-456"></a>-- implemented with @memchr(3)@. I.e.
<a name="line-457"></a>--
<a name="line-458"></a>-- > break (=='c') "abcd" == breakChar 'c' "abcd"
<a name="line-459"></a>--
<a name="line-460"></a>breakChar :: Char -> ByteString -> (ByteString, ByteString)
<a name="line-461"></a>breakChar = L.breakByte . c2w
<a name="line-462"></a>{-# INLINE breakChar #-}
<a name="line-463"></a>
<a name="line-464"></a>-- | 'spanChar' breaks its ByteString argument at the first
<a name="line-465"></a>-- occurence of a Char other than its argument. It is more efficient
<a name="line-466"></a>-- than 'span (==)'
<a name="line-467"></a>--
<a name="line-468"></a>-- > span (=='c') "abcd" == spanByte 'c' "abcd"
<a name="line-469"></a>--
<a name="line-470"></a>spanChar :: Char -> ByteString -> (ByteString, ByteString)
<a name="line-471"></a>spanChar = L.spanByte . c2w
<a name="line-472"></a>{-# INLINE spanChar #-}
<a name="line-473"></a>-}</span>
<a name="line-474"></a>
<a name="line-475"></a><span class='hs-comment'>--</span>
<a name="line-476"></a><span class='hs-comment'>-- TODO, more rules for breakChar*</span>
<a name="line-477"></a><span class='hs-comment'>--</span>
<a name="line-478"></a>
<a name="line-479"></a><a name="split"></a><span class='hs-comment'>-- | /O(n)/ Break a 'ByteString' into pieces separated by the byte</span>
<a name="line-480"></a><span class='hs-comment'>-- argument, consuming the delimiter. I.e.</span>
<a name="line-481"></a><span class='hs-comment'>--</span>
<a name="line-482"></a><span class='hs-comment'>-- > split '\n' "a\nb\nd\ne" == ["a","b","d","e"]</span>
<a name="line-483"></a><span class='hs-comment'>-- > split 'a' "aXaXaXa" == ["","X","X","X"]</span>
<a name="line-484"></a><span class='hs-comment'>-- > split 'x' "x" == ["",""]</span>
<a name="line-485"></a><span class='hs-comment'>-- </span>
<a name="line-486"></a><span class='hs-comment'>-- and</span>
<a name="line-487"></a><span class='hs-comment'>--</span>
<a name="line-488"></a><span class='hs-comment'>-- > intercalate [c] . split c == id</span>
<a name="line-489"></a><span class='hs-comment'>-- > split == splitWith . (==)</span>
<a name="line-490"></a><span class='hs-comment'>-- </span>
<a name="line-491"></a><span class='hs-comment'>-- As for all splitting functions in this library, this function does</span>
<a name="line-492"></a><span class='hs-comment'>-- not copy the substrings, it just constructs new 'ByteStrings' that</span>
<a name="line-493"></a><span class='hs-comment'>-- are slices of the original.</span>
<a name="line-494"></a><span class='hs-comment'>--</span>
<a name="line-495"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-496"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>split</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-497"></a><span class='hs-comment'>{-# INLINE split #-}</span>
<a name="line-498"></a>
<a name="line-499"></a><a name="splitWith"></a><span class='hs-comment'>-- | /O(n)/ Splits a 'ByteString' into components delimited by</span>
<a name="line-500"></a><span class='hs-comment'>-- separators, where the predicate returns True for a separator element.</span>
<a name="line-501"></a><span class='hs-comment'>-- The resulting components do not contain the separators. Two adjacent</span>
<a name="line-502"></a><span class='hs-comment'>-- separators result in an empty component in the output. eg.</span>
<a name="line-503"></a><span class='hs-comment'>--</span>
<a name="line-504"></a><span class='hs-comment'>-- > splitWith (=='a') "aabbaca" == ["","","bb","c",""]</span>
<a name="line-505"></a><span class='hs-comment'>--</span>
<a name="line-506"></a><span class='hs-definition'>splitWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-507"></a><span class='hs-definition'>splitWith</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>splitWith</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-508"></a><span class='hs-comment'>{-# INLINE splitWith #-}</span>
<a name="line-509"></a>
<a name="line-510"></a><a name="groupBy"></a><span class='hs-comment'>-- | The 'groupBy' function is the non-overloaded version of 'group'.</span>
<a name="line-511"></a><span class='hs-definition'>groupBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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-512"></a><span class='hs-definition'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>groupBy</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-513"></a>
<a name="line-514"></a><a name="index"></a><span class='hs-comment'>-- | /O(1)/ 'ByteString' index (subscript) operator, starting from 0.</span>
<a name="line-515"></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'>Char</span>
<a name="line-516"></a><span class='hs-definition'>index</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>index</span>
<a name="line-517"></a><span class='hs-comment'>{-# INLINE index #-}</span>
<a name="line-518"></a>
<a name="line-519"></a><a name="elemIndex"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndex' function returns the index of the first</span>
<a name="line-520"></a><span class='hs-comment'>-- element in the given 'ByteString' which is equal (by memchr) to the</span>
<a name="line-521"></a><span class='hs-comment'>-- query element, or 'Nothing' if there is no such element.</span>
<a name="line-522"></a><span class='hs-definition'>elemIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-523"></a><span class='hs-definition'>elemIndex</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndex</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-524"></a><span class='hs-comment'>{-# INLINE elemIndex #-}</span>
<a name="line-525"></a>
<a name="line-526"></a><a name="elemIndices"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndices' function extends 'elemIndex', by returning</span>
<a name="line-527"></a><span class='hs-comment'>-- the indices of all elements equal to the query element, in ascending order.</span>
<a name="line-528"></a><span class='hs-definition'>elemIndices</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-529"></a><span class='hs-definition'>elemIndices</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndices</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span>
<a name="line-530"></a><span class='hs-comment'>{-# INLINE elemIndices #-}</span>
<a name="line-531"></a>
<a name="line-532"></a><a name="findIndex"></a><span class='hs-comment'>-- | The 'findIndex' function takes a predicate and a 'ByteString' and</span>
<a name="line-533"></a><span class='hs-comment'>-- returns the index of the first element in the ByteString satisfying the predicate.</span>
<a name="line-534"></a><span class='hs-definition'>findIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-535"></a><span class='hs-definition'>findIndex</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>findIndex</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-536"></a><span class='hs-comment'>{-# INLINE findIndex #-}</span>
<a name="line-537"></a>
<a name="line-538"></a><a name="findIndices"></a><span class='hs-comment'>-- | The 'findIndices' function extends 'findIndex', by returning the</span>
<a name="line-539"></a><span class='hs-comment'>-- indices of all elements satisfying the predicate, in ascending order.</span>
<a name="line-540"></a><span class='hs-definition'>findIndices</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-541"></a><span class='hs-definition'>findIndices</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>findIndices</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-542"></a>
<a name="line-543"></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-544"></a><span class='hs-comment'>--</span>
<a name="line-545"></a><span class='hs-comment'>-- > count == length . elemIndices</span>
<a name="line-546"></a><span class='hs-comment'>-- > count '\n' == length . lines</span>
<a name="line-547"></a><span class='hs-comment'>--</span>
<a name="line-548"></a><span class='hs-comment'>-- But more efficiently than using length on the intermediate list.</span>
<a name="line-549"></a><span class='hs-definition'>count</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-550"></a><span class='hs-definition'>count</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>count</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-551"></a>
<a name="line-552"></a><a name="elem"></a><span class='hs-comment'>-- | /O(n)/ 'elem' is the 'ByteString' membership predicate. This</span>
<a name="line-553"></a><span class='hs-comment'>-- implementation uses @memchr(3)@.</span>
<a name="line-554"></a><span class='hs-definition'>elem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-555"></a><span class='hs-definition'>elem</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>elem</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-556"></a><span class='hs-comment'>{-# INLINE elem #-}</span>
<a name="line-557"></a>
<a name="line-558"></a><a name="notElem"></a><span class='hs-comment'>-- | /O(n)/ 'notElem' is the inverse of 'elem'</span>
<a name="line-559"></a><span class='hs-definition'>notElem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</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-560"></a><span class='hs-definition'>notElem</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>notElem</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span>
<a name="line-561"></a><span class='hs-comment'>{-# INLINE notElem #-}</span>
<a name="line-562"></a>
<a name="line-563"></a><a name="filter"></a><span class='hs-comment'>-- | /O(n)/ 'filter', applied to a predicate and a ByteString,</span>
<a name="line-564"></a><span class='hs-comment'>-- returns a ByteString containing those characters that satisfy the</span>
<a name="line-565"></a><span class='hs-comment'>-- predicate.</span>
<a name="line-566"></a><span class='hs-definition'>filter</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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-567"></a><span class='hs-definition'>filter</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-568"></a><span class='hs-comment'>{-# INLINE filter #-}</span>
<a name="line-569"></a>
<a name="line-570"></a><span class='hs-comment'>{-
<a name="line-571"></a>-- | /O(n)/ and /O(n\/c) space/ A first order equivalent of /filter .
<a name="line-572"></a>-- (==)/, for the common case of filtering a single Char. It is more
<a name="line-573"></a>-- efficient to use /filterChar/ in this case.
<a name="line-574"></a>--
<a name="line-575"></a>-- > filterChar == filter . (==)
<a name="line-576"></a>--
<a name="line-577"></a>-- filterChar is around 10x faster, and uses much less space, than its
<a name="line-578"></a>-- filter equivalent
<a name="line-579"></a>--
<a name="line-580"></a>filterChar :: Char -> ByteString -> ByteString
<a name="line-581"></a>filterChar c ps = replicate (count c ps) c
<a name="line-582"></a>{-# INLINE filterChar #-}
<a name="line-583"></a>
<a name="line-584"></a>{-# RULES
<a name="line-585"></a> "ByteString specialise filter (== x)" forall x.
<a name="line-586"></a> filter ((==) x) = filterChar x
<a name="line-587"></a> #-}
<a name="line-588"></a>
<a name="line-589"></a>{-# RULES
<a name="line-590"></a> "ByteString specialise filter (== x)" forall x.
<a name="line-591"></a> filter (== x) = filterChar x
<a name="line-592"></a> #-}
<a name="line-593"></a>-}</span>
<a name="line-594"></a>
<a name="line-595"></a><a name="find"></a><span class='hs-comment'>-- | /O(n)/ The 'find' function takes a predicate and a ByteString,</span>
<a name="line-596"></a><span class='hs-comment'>-- and returns the first element in matching the predicate, or 'Nothing'</span>
<a name="line-597"></a><span class='hs-comment'>-- if there is no such element.</span>
<a name="line-598"></a><span class='hs-definition'>find</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</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'>Char</span>
<a name="line-599"></a><span class='hs-definition'>find</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>`fmap`</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>find</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span>
<a name="line-600"></a><span class='hs-comment'>{-# INLINE find #-}</span>
<a name="line-601"></a>
<a name="line-602"></a><span class='hs-comment'>{-
<a name="line-603"></a>-- | /O(n)/ A first order equivalent of /filter . (==)/, for the common
<a name="line-604"></a>-- case of filtering a single Char. It is more efficient to use
<a name="line-605"></a>-- filterChar in this case.
<a name="line-606"></a>--
<a name="line-607"></a>-- > filterChar == filter . (==)
<a name="line-608"></a>--
<a name="line-609"></a>-- filterChar is around 10x faster, and uses much less space, than its
<a name="line-610"></a>-- filter equivalent
<a name="line-611"></a>--
<a name="line-612"></a>filterChar :: Char -> ByteString -> ByteString
<a name="line-613"></a>filterChar c = L.filterByte (c2w c)
<a name="line-614"></a>{-# INLINE filterChar #-}
<a name="line-615"></a>
<a name="line-616"></a>-- | /O(n)/ A first order equivalent of /filter . (\/=)/, for the common
<a name="line-617"></a>-- case of filtering a single Char out of a list. It is more efficient
<a name="line-618"></a>-- to use /filterNotChar/ in this case.
<a name="line-619"></a>--
<a name="line-620"></a>-- > filterNotChar == filter . (/=)
<a name="line-621"></a>--
<a name="line-622"></a>-- filterNotChar is around 3x faster, and uses much less space, than its
<a name="line-623"></a>-- filter equivalent
<a name="line-624"></a>--
<a name="line-625"></a>filterNotChar :: Char -> ByteString -> ByteString
<a name="line-626"></a>filterNotChar c = L.filterNotByte (c2w c)
<a name="line-627"></a>{-# INLINE filterNotChar #-}
<a name="line-628"></a>-}</span>
<a name="line-629"></a>
<a name="line-630"></a><a name="zip"></a><span class='hs-comment'>-- | /O(n)/ 'zip' takes two ByteStrings and returns a list of</span>
<a name="line-631"></a><span class='hs-comment'>-- corresponding pairs of Chars. If one input ByteString is short,</span>
<a name="line-632"></a><span class='hs-comment'>-- excess elements of the longer ByteString are discarded. This is</span>
<a name="line-633"></a><span class='hs-comment'>-- equivalent to a pair of 'unpack' operations, and so space</span>
<a name="line-634"></a><span class='hs-comment'>-- usage may be large for multi-megabyte ByteStrings</span>
<a name="line-635"></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'>Char</span><span class='hs-layout'>,</span><span class='hs-conid'>Char</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-636"></a><span class='hs-definition'>zip</span> <span class='hs-varid'>ps</span> <span class='hs-varid'>qs</span>
<a name="line-637"></a> <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'>ps</span> <span class='hs-varop'>||</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varid'>qs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-638"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>head</span> <span class='hs-varid'>ps</span><span class='hs-layout'>,</span> <span class='hs-varid'>head</span> <span class='hs-varid'>qs</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>zip</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-varid'>ps</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-varid'>qs</span><span class='hs-layout'>)</span>
<a name="line-639"></a>
<a name="line-640"></a><a name="zipWith"></a><span class='hs-comment'>-- | 'zipWith' generalises 'zip' by zipping with the function given as</span>
<a name="line-641"></a><span class='hs-comment'>-- the first argument, instead of a tupling function. For example,</span>
<a name="line-642"></a><span class='hs-comment'>-- @'zipWith' (+)@ is applied to two ByteStrings to produce the list</span>
<a name="line-643"></a><span class='hs-comment'>-- of corresponding sums.</span>
<a name="line-644"></a><span class='hs-definition'>zipWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</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-645"></a><span class='hs-definition'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>zipWith</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>)</span>
<a name="line-646"></a>
<a name="line-647"></a><a name="lines"></a><span class='hs-comment'>-- | 'lines' breaks a ByteString up into a list of ByteStrings at</span>
<a name="line-648"></a><span class='hs-comment'>-- newline Chars. The resulting strings do not contain newlines.</span>
<a name="line-649"></a><span class='hs-comment'>--</span>
<a name="line-650"></a><span class='hs-comment'>-- As of bytestring 0.9.0.3, this function is stricter than its </span>
<a name="line-651"></a><span class='hs-comment'>-- list cousin.</span>
<a name="line-652"></a><span class='hs-comment'>--</span>
<a name="line-653"></a><span class='hs-definition'>lines</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-654"></a><span class='hs-definition'>lines</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-655"></a><span class='hs-definition'>lines</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'>loop0</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span>
<a name="line-656"></a> <span class='hs-keyword'>where</span>
<a name="line-657"></a> <span class='hs-comment'>-- this is a really performance sensitive function but the</span>
<a name="line-658"></a> <span class='hs-comment'>-- chunked representation makes the general case a bit expensive</span>
<a name="line-659"></a> <span class='hs-comment'>-- however assuming a large chunk size and normalish line lengths</span>
<a name="line-660"></a> <span class='hs-comment'>-- we will find line endings much more frequently than chunk</span>
<a name="line-661"></a> <span class='hs-comment'>-- endings so it makes sense to optimise for that common case.</span>
<a name="line-662"></a> <span class='hs-comment'>-- So we partition into two special cases depending on whether we</span>
<a name="line-663"></a> <span class='hs-comment'>-- are keeping back a list of chunks that will eventually be output</span>
<a name="line-664"></a> <span class='hs-comment'>-- once we get to the end of the current line.</span>
<a name="line-665"></a>
<a name="line-666"></a> <span class='hs-comment'>-- the common special case where we have no existing chunks of</span>
<a name="line-667"></a> <span class='hs-comment'>-- the current line</span>
<a name="line-668"></a> <span class='hs-varid'>loop0</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>S</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-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-669"></a> <span class='hs-varid'>loop0</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span>
<a name="line-670"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndex</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-chr'>'\n'</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span>
<a name="line-671"></a> <span class='hs-conid'>Nothing</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-672"></a> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>B</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'>[]</span>
<a name="line-673"></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> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span>
<a name="line-674"></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>
<a name="line-675"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>B</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-varid'>loop0</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span>
<a name="line-676"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>loop</span> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>c</span><span class='hs-keyglyph'>]</span> <span class='hs-varid'>cs'</span>
<a name="line-677"></a>
<a name="line-678"></a> <span class='hs-conid'>Just</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-conid'>Chunk</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTake</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-679"></a> <span class='hs-conop'>:</span> <span class='hs-varid'>loop0</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeDrop</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> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span>
<a name="line-680"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Empty</span>
<a name="line-681"></a> <span class='hs-conop'>:</span> <span class='hs-varid'>loop0</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</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-682"></a>
<a name="line-683"></a> <span class='hs-comment'>-- the general case when we are building a list of chunks that are</span>
<a name="line-684"></a> <span class='hs-comment'>-- part of the same line</span>
<a name="line-685"></a> <span class='hs-varid'>loop</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>S</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'>S</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-686"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>c</span> <span class='hs-varid'>line</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span>
<a name="line-687"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndex</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-chr'>'\n'</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span>
<a name="line-688"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span>
<a name="line-689"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>cs</span> <span class='hs-keyword'>of</span>
<a name="line-690"></a> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>let</span> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revChunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-conop'>:</span> <span class='hs-varid'>line</span><span class='hs-layout'>)</span>
<a name="line-691"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>c'</span> <span class='hs-varop'>`seq`</span> <span class='hs-layout'>(</span><span class='hs-varid'>c'</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-692"></a>
<a name="line-693"></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'>loop</span> <span class='hs-varid'>c'</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-conop'>:</span> <span class='hs-varid'>line</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs'</span>
<a name="line-694"></a>
<a name="line-695"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>-></span>
<a name="line-696"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>revChunks</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTake</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-conop'>:</span> <span class='hs-varid'>line</span><span class='hs-layout'>)</span>
<a name="line-697"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>c'</span> <span class='hs-varop'>`seq`</span> <span class='hs-layout'>(</span><span class='hs-varid'>c'</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop0</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeDrop</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> <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-698"></a>
<a name="line-699"></a><span class='hs-comment'>{-
<a name="line-700"></a>
<a name="line-701"></a>This function is too strict! Consider,
<a name="line-702"></a>
<a name="line-703"></a>> prop_lazy =
<a name="line-704"></a> (L.unpack . head . lazylines $ L.append (L.pack "a\nb\n") (error "failed"))
<a name="line-705"></a> ==
<a name="line-706"></a> "a"
<a name="line-707"></a>
<a name="line-708"></a>fails. Here's a properly lazy version of 'lines' for lazy bytestrings
<a name="line-709"></a>
<a name="line-710"></a> lazylines :: L.ByteString -> [L.ByteString]
<a name="line-711"></a> lazylines s
<a name="line-712"></a> | L.null s = []
<a name="line-713"></a> | otherwise =
<a name="line-714"></a> let (l,s') = L.break ((==) '\n') s
<a name="line-715"></a> in l : if L.null s' then []
<a name="line-716"></a> else lazylines (L.tail s')
<a name="line-717"></a>
<a name="line-718"></a>we need a similarly lazy, but efficient version.
<a name="line-719"></a>
<a name="line-720"></a>-}</span>
<a name="line-721"></a>
<a name="line-722"></a>
<a name="line-723"></a><a name="unlines"></a><span class='hs-comment'>-- | 'unlines' is an inverse operation to 'lines'. It joins lines,</span>
<a name="line-724"></a><span class='hs-comment'>-- after appending a terminating newline to each.</span>
<a name="line-725"></a><span class='hs-definition'>unlines</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-726"></a><span class='hs-definition'>unlines</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span>
<a name="line-727"></a><span class='hs-definition'>unlines</span> <span class='hs-varid'>ss</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>concat</span> <span class='hs-varop'>$</span> <span class='hs-conid'>List</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>nl</span> <span class='hs-varid'>ss</span><span class='hs-layout'>)</span> <span class='hs-varop'>`append`</span> <span class='hs-varid'>nl</span> <span class='hs-comment'>-- half as much space</span>
<a name="line-728"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>nl</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>singleton</span> <span class='hs-chr'>'\n'</span>
<a name="line-729"></a>
<a name="line-730"></a><a name="words"></a><span class='hs-comment'>-- | 'words' breaks a ByteString up into a list of words, which</span>
<a name="line-731"></a><span class='hs-comment'>-- were delimited by Chars representing white space. And</span>
<a name="line-732"></a><span class='hs-comment'>--</span>
<a name="line-733"></a><span class='hs-comment'>-- > tokens isSpace = words</span>
<a name="line-734"></a><span class='hs-comment'>--</span>
<a name="line-735"></a><span class='hs-definition'>words</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-736"></a><span class='hs-definition'>words</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>List</span><span class='hs-varop'>.</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-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>splitWith</span> <span class='hs-varid'>isSpaceWord8</span>
<a name="line-737"></a><span class='hs-comment'>{-# INLINE words #-}</span>
<a name="line-738"></a>
<a name="line-739"></a><a name="unwords"></a><span class='hs-comment'>-- | The 'unwords' function is analogous to the 'unlines' function, on words.</span>
<a name="line-740"></a><span class='hs-definition'>unwords</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-741"></a><span class='hs-definition'>unwords</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>intercalate</span> <span class='hs-layout'>(</span><span class='hs-varid'>singleton</span> <span class='hs-chr'>' '</span><span class='hs-layout'>)</span>
<a name="line-742"></a><span class='hs-comment'>{-# INLINE unwords #-}</span>
<a name="line-743"></a>
<a name="line-744"></a><span class='hs-comment'>-- | readInt reads an Int from the beginning of the ByteString. If</span>
<a name="line-745"></a><span class='hs-comment'>-- there is no integer at the beginning of the string, it returns</span>
<a name="line-746"></a><span class='hs-comment'>-- Nothing, otherwise it just returns the int read, and the rest of the</span>
<a name="line-747"></a><span class='hs-comment'>-- string.</span>
<a name="line-748"></a>
<a name="line-749"></a><span class='hs-comment'>{-
<a name="line-750"></a>-- Faster:
<a name="line-751"></a>
<a name="line-752"></a>data MaybeS = NothingS
<a name="line-753"></a> | JustS {-# UNPACK #-} !Int {-# UNPACK #-} !ByteString
<a name="line-754"></a>-}</span>
<a name="line-755"></a>
<a name="line-756"></a><a name="readInt"></a><span class='hs-definition'>readInt</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'>Int</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span>
<a name="line-757"></a><span class='hs-comment'>{-# INLINE readInt #-}</span>
<a name="line-758"></a><span class='hs-definition'>readInt</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span>
<a name="line-759"></a><span class='hs-definition'>readInt</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-keyword'>case</span> <span class='hs-varid'>w2c</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</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-keyword'>of</span>
<a name="line-760"></a> <span class='hs-chr'>'-'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>loop</span> <span class='hs-conid'>True</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</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>
<a name="line-761"></a> <span class='hs-chr'>'+'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>loop</span> <span class='hs-conid'>False</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</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>
<a name="line-762"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>loop</span> <span class='hs-conid'>False</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span>
<a name="line-763"></a>
<a name="line-764"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span>
<a name="line-765"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>S</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'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Int</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span>
<a name="line-766"></a> <span class='hs-conid'>STRICT5_</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-767"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>neg</span> <span class='hs-varid'>i</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-768"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>B</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-769"></a> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>end</span> <span class='hs-varid'>neg</span> <span class='hs-varid'>i</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-770"></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'>loop</span> <span class='hs-varid'>neg</span> <span class='hs-varid'>i</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span>
<a name="line-771"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span>
<a name="line-772"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span>
<a name="line-773"></a> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>w</span> <span class='hs-varop'>>=</span> <span class='hs-num'>0x30</span>
<a name="line-774"></a> <span class='hs-varop'>&&</span> <span class='hs-varid'>w</span> <span class='hs-varop'><=</span> <span class='hs-num'>0x39</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>loop</span> <span class='hs-varid'>neg</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-775"></a> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>*</span> <span class='hs-num'>10</span> <span class='hs-varop'>+</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>w</span> <span class='hs-comment'>-</span> <span class='hs-num'>0x30</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-776"></a> <span class='hs-layout'>(</span><span class='hs-conid'>B</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-777"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>end</span> <span class='hs-varid'>neg</span> <span class='hs-varid'>i</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-778"></a>
<a name="line-779"></a> <span class='hs-comment'>{-# INLINE end #-}</span>
<a name="line-780"></a> <span class='hs-varid'>end</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span>
<a name="line-781"></a> <span class='hs-varid'>end</span> <span class='hs-varid'>neg</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>e</span> <span class='hs-varop'>`seq`</span> <span class='hs-varid'>e</span>
<a name="line-782"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>n'</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>neg</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>negate</span> <span class='hs-varid'>n</span> <span class='hs-keyword'>else</span> <span class='hs-varid'>n</span>
<a name="line-783"></a> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-784"></a> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>n'</span> <span class='hs-varop'>`seq`</span> <span class='hs-varid'>c'</span> <span class='hs-varop'>`seq`</span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$!</span> <span class='hs-layout'>(</span><span class='hs-varid'>n'</span><span class='hs-layout'>,</span><span class='hs-varid'>c'</span><span class='hs-layout'>)</span>
<a name="line-785"></a> <span class='hs-comment'>-- in n' `seq` c' `seq` JustS n' c'</span>
<a name="line-786"></a>
<a name="line-787"></a>
<a name="line-788"></a><a name="readInteger"></a><span class='hs-comment'>-- | readInteger reads an Integer from the beginning of the ByteString. If</span>
<a name="line-789"></a><span class='hs-comment'>-- there is no integer at the beginning of the string, it returns Nothing,</span>
<a name="line-790"></a><span class='hs-comment'>-- otherwise it just returns the int read, and the rest of the string.</span>
<a name="line-791"></a><span class='hs-definition'>readInteger</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'>Integer</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span>
<a name="line-792"></a><span class='hs-definition'>readInteger</span> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span>
<a name="line-793"></a><span class='hs-definition'>readInteger</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>
<a name="line-794"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>w2c</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-keyword'>of</span>
<a name="line-795"></a> <span class='hs-chr'>'-'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>first</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs0</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-layout'>(</span><span class='hs-varid'>n</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'>return</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-varid'>cs'</span><span class='hs-layout'>)</span>
<a name="line-796"></a> <span class='hs-chr'>'+'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>first</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>c0</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs0</span>
<a name="line-797"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>first</span> <span class='hs-varid'>c0</span> <span class='hs-varid'>cs0</span>
<a name="line-798"></a>
<a name="line-799"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>first</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-800"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>B</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-801"></a> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span>
<a name="line-802"></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'>first'</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span>
<a name="line-803"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>first'</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-804"></a>
<a name="line-805"></a> <span class='hs-varid'>first'</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span>
<a name="line-806"></a> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>w</span> <span class='hs-varop'>>=</span> <span class='hs-num'>0x30</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>w</span> <span class='hs-varop'><=</span> <span class='hs-num'>0x39</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$</span>
<a name="line-807"></a> <span class='hs-varid'>loop</span> <span class='hs-num'>1</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>w</span> <span class='hs-comment'>-</span> <span class='hs-num'>0x30</span><span class='hs-layout'>)</span> <span class='hs-conid'>[]</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</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-808"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span>
<a name="line-809"></a>
<a name="line-810"></a> <span class='hs-varid'>loop</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</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-conid'>Integer</span><span class='hs-keyglyph'>]</span>
<a name="line-811"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>S</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-layout'>(</span><span class='hs-conid'>Integer</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span>
<a name="line-812"></a> <span class='hs-conid'>STRICT5_</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-813"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>d</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>ns</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-814"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>B</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-815"></a> <span class='hs-conid'>Empty</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>combine</span> <span class='hs-varid'>d</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>ns</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-816"></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'>loop</span> <span class='hs-varid'>d</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>ns</span> <span class='hs-varid'>c'</span> <span class='hs-varid'>cs'</span>
<a name="line-817"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span>
<a name="line-818"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>of</span>
<a name="line-819"></a> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>w</span> <span class='hs-varop'>>=</span> <span class='hs-num'>0x30</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>w</span> <span class='hs-varop'><=</span> <span class='hs-num'>0x39</span> <span class='hs-keyglyph'>-></span>
<a name="line-820"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>d</span> <span class='hs-varop'><</span> <span class='hs-num'>9</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>d</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-821"></a> <span class='hs-layout'>(</span><span class='hs-num'>10</span><span class='hs-varop'>*</span><span class='hs-varid'>acc</span> <span class='hs-varop'>+</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>w</span> <span class='hs-comment'>-</span> <span class='hs-num'>0x30</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-822"></a> <span class='hs-varid'>ns</span> <span class='hs-layout'>(</span><span class='hs-conid'>B</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-823"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>loop</span> <span class='hs-num'>1</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>w</span> <span class='hs-comment'>-</span> <span class='hs-num'>0x30</span><span class='hs-layout'>)</span>
<a name="line-824"></a> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>acc</span> <span class='hs-conop'>:</span> <span class='hs-varid'>ns</span><span class='hs-layout'>)</span>
<a name="line-825"></a> <span class='hs-layout'>(</span><span class='hs-conid'>B</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-826"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>combine</span> <span class='hs-varid'>d</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>ns</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-827"></a>
<a name="line-828"></a> <span class='hs-varid'>combine</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>acc</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>end</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-829"></a> <span class='hs-varid'>combine</span> <span class='hs-varid'>d</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>ns</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span>
<a name="line-830"></a> <span class='hs-varid'>end</span> <span class='hs-layout'>(</span><span class='hs-num'>10</span><span class='hs-varop'>^</span><span class='hs-varid'>d</span> <span class='hs-varop'>*</span> <span class='hs-varid'>combine1</span> <span class='hs-num'>1000000000</span> <span class='hs-varid'>ns</span> <span class='hs-varop'>+</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-831"></a>
<a name="line-832"></a> <span class='hs-varid'>combine1</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>n</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>n</span>
<a name="line-833"></a> <span class='hs-varid'>combine1</span> <span class='hs-varid'>b</span> <span class='hs-varid'>ns</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>combine1</span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span><span class='hs-varop'>*</span><span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>combine2</span> <span class='hs-varid'>b</span> <span class='hs-varid'>ns</span>
<a name="line-834"></a>
<a name="line-835"></a> <span class='hs-varid'>combine2</span> <span class='hs-varid'>b</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-conop'>:</span><span class='hs-varid'>m</span><span class='hs-conop'>:</span><span class='hs-varid'>ns</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>m</span><span class='hs-varop'>*</span><span class='hs-varid'>b</span> <span class='hs-keyword'>in</span> <span class='hs-varid'>t</span> <span class='hs-varop'>`seq`</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span> <span class='hs-conop'>:</span> <span class='hs-varid'>combine2</span> <span class='hs-varid'>b</span> <span class='hs-varid'>ns</span><span class='hs-layout'>)</span>
<a name="line-836"></a> <span class='hs-varid'>combine2</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>ns</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ns</span>
<a name="line-837"></a>
<a name="line-838"></a> <span class='hs-varid'>end</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>c'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>chunk</span> <span class='hs-varid'>c</span> <span class='hs-varid'>cs</span>
<a name="line-839"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>c'</span> <span class='hs-varop'>`seq`</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-varid'>c'</span><span class='hs-layout'>)</span>
<a name="line-840"></a>
<a name="line-841"></a><a name="readFile"></a><span class='hs-comment'>-- | Read an entire file /lazily/ into a 'ByteString'. Use 'text mode'</span>
<a name="line-842"></a><span class='hs-comment'>-- on Windows to interpret newlines</span>
<a name="line-843"></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-844"></a><span class='hs-definition'>readFile</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>openFile</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-845"></a>
<a name="line-846"></a><a name="writeFile"></a><span class='hs-comment'>-- | Write a 'ByteString' to a file.</span>
<a name="line-847"></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-848"></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'>openFile</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-849"></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-850"></a>
<a name="line-851"></a><a name="appendFile"></a><span class='hs-comment'>-- | Append a 'ByteString' to a file.</span>
<a name="line-852"></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-853"></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'>openFile</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-854"></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-855"></a>
<a name="line-856"></a>
<a name="line-857"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-858"></a><span class='hs-comment'>-- Internal utilities</span>
<a name="line-859"></a>
<a name="line-860"></a><a name="revChunks"></a><span class='hs-comment'>-- reverse a list of possibly-empty chunks into a lazy ByteString</span>
<a name="line-861"></a><span class='hs-definition'>revChunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>S</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-862"></a><span class='hs-definition'>revChunks</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>List</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>
</pre></body>
</html>
