<?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/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'>-- We cannot actually specify all the language pragmas, see ghc ticket #</span> <a name="line-3"></a><span class='hs-comment'>-- If we could, these are what they would be:</span> <a name="line-4"></a><span class='hs-comment'>{- LANGUAGE MagicHash, UnboxedTuples -}</span> <a name="line-5"></a><span class='hs-comment'>{-# OPTIONS_HADDOCK prune #-}</span> <a name="line-6"></a> <a name="line-7"></a><span class='hs-comment'>-- |</span> <a name="line-8"></a><span class='hs-comment'>-- Module : Data.ByteString.Char8</span> <a name="line-9"></a><span class='hs-comment'>-- Copyright : (c) Don Stewart 2006-2008</span> <a name="line-10"></a><span class='hs-comment'>-- License : BSD-style</span> <a name="line-11"></a><span class='hs-comment'>--</span> <a name="line-12"></a><span class='hs-comment'>-- Maintainer : dons@cse.unsw.edu.au</span> <a name="line-13"></a><span class='hs-comment'>-- Stability : experimental</span> <a name="line-14"></a><span class='hs-comment'>-- Portability : portable</span> <a name="line-15"></a><span class='hs-comment'>--</span> <a name="line-16"></a><span class='hs-comment'>-- Manipulate 'ByteString's using 'Char' operations. All Chars will be</span> <a name="line-17"></a><span class='hs-comment'>-- truncated to 8 bits. It can be expected that these functions will run</span> <a name="line-18"></a><span class='hs-comment'>-- at identical speeds to their 'Word8' equivalents in "Data.ByteString".</span> <a name="line-19"></a><span class='hs-comment'>--</span> <a name="line-20"></a><span class='hs-comment'>-- More specifically these byte strings are taken to be in the</span> <a name="line-21"></a><span class='hs-comment'>-- subset of Unicode covered by code points 0-255. This covers</span> <a name="line-22"></a><span class='hs-comment'>-- Unicode Basic Latin, Latin-1 Supplement and C0+C1 Controls.</span> <a name="line-23"></a><span class='hs-comment'>-- </span> <a name="line-24"></a><span class='hs-comment'>-- See: </span> <a name="line-25"></a><span class='hs-comment'>--</span> <a name="line-26"></a><span class='hs-comment'>-- * <<a href="http://www.unicode.org/charts/">http://www.unicode.org/charts/</a>></span> <a name="line-27"></a><span class='hs-comment'>--</span> <a name="line-28"></a><span class='hs-comment'>-- * <<a href="http://www.unicode.org/charts/PDF/U0000.pdf">http://www.unicode.org/charts/PDF/U0000.pdf</a>></span> <a name="line-29"></a><span class='hs-comment'>--</span> <a name="line-30"></a><span class='hs-comment'>-- * <<a href="http://www.unicode.org/charts/PDF/U0080.pdf">http://www.unicode.org/charts/PDF/U0080.pdf</a>></span> <a name="line-31"></a><span class='hs-comment'>--</span> <a name="line-32"></a><span class='hs-comment'>-- This module is intended to be imported @qualified@, to avoid name</span> <a name="line-33"></a><span class='hs-comment'>-- clashes with "Prelude" functions. eg.</span> <a name="line-34"></a><span class='hs-comment'>--</span> <a name="line-35"></a><span class='hs-comment'>-- > import qualified Data.ByteString.Char8 as B</span> <a name="line-36"></a><span class='hs-comment'>--</span> <a name="line-37"></a><span class='hs-comment'>-- The Char8 interface to bytestrings provides an instance of IsString</span> <a name="line-38"></a><span class='hs-comment'>-- for the ByteString type, enabling you to use string literals, and</span> <a name="line-39"></a><span class='hs-comment'>-- have them implicitly packed to ByteStrings. Use -XOverloadedStrings</span> <a name="line-40"></a><span class='hs-comment'>-- to enable this.</span> <a name="line-41"></a><span class='hs-comment'>--</span> <a name="line-42"></a> <a name="line-43"></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'>Char8</span> <span class='hs-layout'>(</span> <a name="line-44"></a> <a name="line-45"></a> <span class='hs-comment'>-- * The @ByteString@ type</span> <a name="line-46"></a> <span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- abstract, instances: Eq, Ord, Show, Read, Data, Typeable, Monoid</span> <a name="line-47"></a> <a name="line-48"></a> <span class='hs-comment'>-- * Introducing and eliminating 'ByteString's</span> <a name="line-49"></a> <span class='hs-varid'>empty</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString</span> <a name="line-50"></a> <span class='hs-varid'>singleton</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString</span> <a name="line-51"></a> <span class='hs-varid'>pack</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: String -> ByteString</span> <a name="line-52"></a> <span class='hs-varid'>unpack</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> String</span> <a name="line-53"></a> <a name="line-54"></a> <span class='hs-comment'>-- * Basic interface</span> <a name="line-55"></a> <span class='hs-varid'>cons</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> ByteString</span> <a name="line-56"></a> <span class='hs-varid'>snoc</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char -> ByteString</span> <a name="line-57"></a> <span class='hs-varid'>append</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> ByteString</span> <a name="line-58"></a> <span class='hs-varid'>head</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span> <a name="line-59"></a> <span class='hs-varid'>uncons</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Maybe (Char, ByteString)</span> <a name="line-60"></a> <span class='hs-varid'>last</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span> <a name="line-61"></a> <span class='hs-varid'>tail</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-62"></a> <span class='hs-varid'>init</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-63"></a> <span class='hs-varid'>null</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Bool</span> <a name="line-64"></a> <span class='hs-varid'>length</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Int</span> <a name="line-65"></a> <a name="line-66"></a> <span class='hs-comment'>-- * Transformating ByteStrings</span> <a name="line-67"></a> <span class='hs-varid'>map</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char) -> ByteString -> ByteString</span> <a name="line-68"></a> <span class='hs-varid'>reverse</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-69"></a> <span class='hs-varid'>intersperse</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> ByteString</span> <a name="line-70"></a> <span class='hs-varid'>intercalate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString] -> ByteString</span> <a name="line-71"></a> <span class='hs-varid'>transpose</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> [ByteString]</span> <a name="line-72"></a> <a name="line-73"></a> <span class='hs-comment'>-- * Reducing 'ByteString's (folds)</span> <a name="line-74"></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-75"></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-76"></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-77"></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-78"></a> <a name="line-79"></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-80"></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-81"></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-82"></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-83"></a> <a name="line-84"></a> <span class='hs-comment'>-- ** Special folds</span> <a name="line-85"></a> <span class='hs-varid'>concat</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> ByteString</span> <a name="line-86"></a> <span class='hs-varid'>concatMap</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> ByteString) -> ByteString -> ByteString</span> <a name="line-87"></a> <span class='hs-varid'>any</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Bool</span> <a name="line-88"></a> <span class='hs-varid'>all</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Bool</span> <a name="line-89"></a> <span class='hs-varid'>maximum</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span> <a name="line-90"></a> <span class='hs-varid'>minimum</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Char</span> <a name="line-91"></a> <a name="line-92"></a> <span class='hs-comment'>-- * Building ByteStrings</span> <a name="line-93"></a> <span class='hs-comment'>-- ** Scans</span> <a name="line-94"></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-95"></a> <span class='hs-varid'>scanl1</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> ByteString -> ByteString</span> <a name="line-96"></a> <span class='hs-varid'>scanr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> Char -> ByteString -> ByteString</span> <a name="line-97"></a> <span class='hs-varid'>scanr1</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Char -> Char) -> ByteString -> ByteString</span> <a name="line-98"></a> <a name="line-99"></a> <span class='hs-comment'>-- ** Accumulating maps</span> <a name="line-100"></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-101"></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-102"></a> <a name="line-103"></a> <span class='hs-comment'>-- ** Generating and unfolding ByteStrings</span> <a name="line-104"></a> <span class='hs-varid'>replicate</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int -> Char -> ByteString</span> <a name="line-105"></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-106"></a> <span class='hs-varid'>unfoldrN</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int -> (a -> Maybe (Char, a)) -> a -> (ByteString, Maybe a)</span> <a name="line-107"></a> <a name="line-108"></a> <span class='hs-comment'>-- * Substrings</span> <a name="line-109"></a> <a name="line-110"></a> <span class='hs-comment'>-- ** Breaking strings</span> <a name="line-111"></a> <span class='hs-varid'>take</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int -> ByteString -> ByteString</span> <a name="line-112"></a> <span class='hs-varid'>drop</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int -> ByteString -> ByteString</span> <a name="line-113"></a> <span class='hs-varid'>splitAt</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Int -> ByteString -> (ByteString, ByteString)</span> <a name="line-114"></a> <span class='hs-varid'>takeWhile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> ByteString</span> <a name="line-115"></a> <span class='hs-varid'>dropWhile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> ByteString</span> <a name="line-116"></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-117"></a> <span class='hs-varid'>spanEnd</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> (ByteString, ByteString)</span> <a name="line-118"></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-119"></a> <span class='hs-varid'>breakEnd</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> (ByteString, ByteString)</span> <a name="line-120"></a> <span class='hs-varid'>group</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-121"></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-122"></a> <span class='hs-varid'>inits</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-123"></a> <span class='hs-varid'>tails</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-124"></a> <a name="line-125"></a> <span class='hs-comment'>-- ** Breaking into many substrings</span> <a name="line-126"></a> <span class='hs-varid'>split</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> [ByteString]</span> <a name="line-127"></a> <span class='hs-varid'>splitWith</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> [ByteString]</span> <a name="line-128"></a> <a name="line-129"></a> <span class='hs-comment'>-- ** Breaking into lines and words</span> <a name="line-130"></a> <span class='hs-varid'>lines</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-131"></a> <span class='hs-varid'>words</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-132"></a> <span class='hs-varid'>unlines</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [ByteString] -> ByteString</span> <a name="line-133"></a> <span class='hs-varid'>unwords</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> [ByteString]</span> <a name="line-134"></a> <a name="line-135"></a> <span class='hs-comment'>-- * Predicates</span> <a name="line-136"></a> <span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Bool</span> <a name="line-137"></a> <span class='hs-varid'>isSuffixOf</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Bool</span> <a name="line-138"></a> <span class='hs-varid'>isInfixOf</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Bool</span> <a name="line-139"></a> <a name="line-140"></a> <span class='hs-comment'>-- ** Search for arbitrary substrings</span> <a name="line-141"></a> <span class='hs-varid'>breakSubstring</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> (ByteString,ByteString)</span> <a name="line-142"></a> <span class='hs-varid'>findSubstring</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> Maybe Int</span> <a name="line-143"></a> <span class='hs-varid'>findSubstrings</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> [Int]</span> <a name="line-144"></a> <a name="line-145"></a> <span class='hs-comment'>-- * Searching ByteStrings</span> <a name="line-146"></a> <a name="line-147"></a> <span class='hs-comment'>-- ** Searching by equality</span> <a name="line-148"></a> <span class='hs-varid'>elem</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Bool</span> <a name="line-149"></a> <span class='hs-varid'>notElem</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Bool</span> <a name="line-150"></a> <a name="line-151"></a> <span class='hs-comment'>-- ** Searching with a predicate</span> <a name="line-152"></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-153"></a> <span class='hs-varid'>filter</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> ByteString</span> <a name="line-154"></a><span class='hs-comment'>-- partition -- :: (Char -> Bool) -> ByteString -> (ByteString, ByteString)</span> <a name="line-155"></a> <a name="line-156"></a> <span class='hs-comment'>-- * Indexing ByteStrings</span> <a name="line-157"></a> <span class='hs-varid'>index</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Int -> Char</span> <a name="line-158"></a> <span class='hs-varid'>elemIndex</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Maybe Int</span> <a name="line-159"></a> <span class='hs-varid'>elemIndices</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> [Int]</span> <a name="line-160"></a> <span class='hs-varid'>elemIndexEnd</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Maybe Int</span> <a name="line-161"></a> <span class='hs-varid'>findIndex</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> Maybe Int</span> <a name="line-162"></a> <span class='hs-varid'>findIndices</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (Char -> Bool) -> ByteString -> [Int]</span> <a name="line-163"></a> <span class='hs-varid'>count</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Char -> ByteString -> Int</span> <a name="line-164"></a> <a name="line-165"></a> <span class='hs-comment'>-- * Zipping and unzipping ByteStrings</span> <a name="line-166"></a> <span class='hs-varid'>zip</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString -> [(Char,Char)]</span> <a name="line-167"></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-168"></a> <span class='hs-varid'>unzip</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: [(Char,Char)] -> (ByteString,ByteString)</span> <a name="line-169"></a> <a name="line-170"></a> <span class='hs-comment'>-- * Ordered ByteStrings</span> <a name="line-171"></a> <span class='hs-varid'>sort</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-172"></a> <a name="line-173"></a> <span class='hs-comment'>-- * Reading from ByteStrings</span> <a name="line-174"></a> <span class='hs-varid'>readInt</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Maybe (Int, ByteString)</span> <a name="line-175"></a> <span class='hs-varid'>readInteger</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> Maybe (Integer, ByteString)</span> <a name="line-176"></a> <a name="line-177"></a> <span class='hs-comment'>-- * Low level CString conversions</span> <a name="line-178"></a> <a name="line-179"></a> <span class='hs-comment'>-- ** Copying ByteStrings</span> <a name="line-180"></a> <span class='hs-varid'>copy</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> ByteString</span> <a name="line-181"></a> <a name="line-182"></a> <span class='hs-comment'>-- ** Packing CStrings and pointers</span> <a name="line-183"></a> <span class='hs-varid'>packCString</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: CString -> IO ByteString</span> <a name="line-184"></a> <span class='hs-varid'>packCStringLen</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: CStringLen -> IO ByteString</span> <a name="line-185"></a> <a name="line-186"></a> <span class='hs-comment'>-- ** Using ByteStrings as CStrings</span> <a name="line-187"></a> <span class='hs-varid'>useAsCString</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> (CString -> IO a) -> IO a</span> <a name="line-188"></a> <span class='hs-varid'>useAsCStringLen</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> (CStringLen -> IO a) -> IO a</span> <a name="line-189"></a> <a name="line-190"></a> <span class='hs-comment'>-- * I\/O with 'ByteString's</span> <a name="line-191"></a> <a name="line-192"></a> <span class='hs-comment'>-- ** Standard input and output</span> <a name="line-193"></a> <span class='hs-varid'>getLine</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: IO ByteString</span> <a name="line-194"></a> <span class='hs-varid'>getContents</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: IO ByteString</span> <a name="line-195"></a> <span class='hs-varid'>putStr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> IO ()</span> <a name="line-196"></a> <span class='hs-varid'>putStrLn</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: ByteString -> IO ()</span> <a name="line-197"></a> <span class='hs-varid'>interact</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: (ByteString -> ByteString) -> IO ()</span> <a name="line-198"></a> <a name="line-199"></a> <span class='hs-comment'>-- ** Files</span> <a name="line-200"></a> <span class='hs-varid'>readFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> IO ByteString</span> <a name="line-201"></a> <span class='hs-varid'>writeFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> ByteString -> IO ()</span> <a name="line-202"></a> <span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: FilePath -> ByteString -> IO ()</span> <a name="line-203"></a><span class='hs-comment'>-- mmapFile, -- :: FilePath -> IO ByteString</span> <a name="line-204"></a> <a name="line-205"></a> <span class='hs-comment'>-- ** I\/O with Handles</span> <a name="line-206"></a> <span class='hs-varid'>hGetLine</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> IO ByteString</span> <a name="line-207"></a> <span class='hs-varid'>hGetContents</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> IO ByteString</span> <a name="line-208"></a> <span class='hs-varid'>hGet</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> Int -> IO ByteString</span> <a name="line-209"></a> <span class='hs-varid'>hGetNonBlocking</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> Int -> IO ByteString</span> <a name="line-210"></a> <span class='hs-varid'>hPut</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> ByteString -> IO ()</span> <a name="line-211"></a> <span class='hs-varid'>hPutStr</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> ByteString -> IO ()</span> <a name="line-212"></a> <span class='hs-varid'>hPutStrLn</span><span class='hs-layout'>,</span> <span class='hs-comment'>-- :: Handle -> ByteString -> IO ()</span> <a name="line-213"></a> <a name="line-214"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-215"></a> <a name="line-216"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Prelude</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>P</span> <a name="line-217"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Prelude</span> <span class='hs-varid'>hiding</span> <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> <a name="line-218"></a> <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-219"></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> <a name="line-220"></a> <span class='hs-layout'>,</span><span class='hs-varid'>dropWhile</span><span class='hs-layout'>,</span><span class='hs-varid'>span</span><span class='hs-layout'>,</span><span class='hs-varid'>break</span><span class='hs-layout'>,</span><span class='hs-varid'>elem</span><span class='hs-layout'>,</span><span class='hs-varid'>filter</span><span class='hs-layout'>,</span><span class='hs-varid'>unwords</span> <a name="line-221"></a> <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> <a name="line-222"></a> <span class='hs-layout'>,</span><span class='hs-varid'>scanl</span><span class='hs-layout'>,</span><span class='hs-varid'>scanl1</span><span class='hs-layout'>,</span><span class='hs-varid'>scanr</span><span class='hs-layout'>,</span><span class='hs-varid'>scanr1</span> <a name="line-223"></a> <span class='hs-layout'>,</span><span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span><span class='hs-varid'>readFile</span><span class='hs-layout'>,</span><span class='hs-varid'>writeFile</span> <a name="line-224"></a> <span class='hs-layout'>,</span><span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span><span class='hs-varid'>foldr1</span><span class='hs-layout'>,</span><span class='hs-varid'>replicate</span> <a name="line-225"></a> <span class='hs-layout'>,</span><span class='hs-varid'>getContents</span><span class='hs-layout'>,</span><span class='hs-varid'>getLine</span><span class='hs-layout'>,</span><span class='hs-varid'>putStr</span><span class='hs-layout'>,</span><span class='hs-varid'>putStrLn</span><span class='hs-layout'>,</span><span class='hs-varid'>interact</span> <a name="line-226"></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> <a name="line-227"></a> <a name="line-228"></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-229"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Internal</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>B</span> <a name="line-230"></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-231"></a> <a name="line-232"></a><span class='hs-comment'>-- Listy functions transparently exported</span> <a name="line-233"></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-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> <a name="line-234"></a> <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'>reverse</span><span class='hs-layout'>,</span><span class='hs-varid'>transpose</span> <a name="line-235"></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> <a name="line-236"></a> <span class='hs-layout'>,</span><span class='hs-varid'>sort</span><span class='hs-layout'>,</span><span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span><span class='hs-varid'>isSuffixOf</span><span class='hs-layout'>,</span><span class='hs-varid'>isInfixOf</span> <a name="line-237"></a> <span class='hs-layout'>,</span><span class='hs-varid'>findSubstring</span><span class='hs-layout'>,</span><span class='hs-varid'>findSubstrings</span><span class='hs-layout'>,</span><span class='hs-varid'>breakSubstring</span><span class='hs-layout'>,</span><span class='hs-varid'>copy</span><span class='hs-layout'>,</span><span class='hs-varid'>group</span> <a name="line-238"></a> <a name="line-239"></a> <span class='hs-layout'>,</span><span class='hs-varid'>getLine</span><span class='hs-layout'>,</span> <span class='hs-varid'>getContents</span><span class='hs-layout'>,</span> <span class='hs-varid'>putStr</span><span class='hs-layout'>,</span> <span class='hs-varid'>putStrLn</span><span class='hs-layout'>,</span> <span class='hs-varid'>interact</span> <a name="line-240"></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'>hPutStr</span><span class='hs-layout'>,</span> <span class='hs-varid'>hPutStrLn</span> <a name="line-241"></a> <span class='hs-layout'>,</span><span class='hs-varid'>hGetLine</span><span class='hs-layout'>,</span> <span class='hs-varid'>hGetNonBlocking</span> <a name="line-242"></a> <span class='hs-layout'>,</span><span class='hs-varid'>packCString</span><span class='hs-layout'>,</span><span class='hs-varid'>packCStringLen</span> <a name="line-243"></a> <span class='hs-layout'>,</span><span class='hs-varid'>useAsCString</span><span class='hs-layout'>,</span><span class='hs-varid'>useAsCStringLen</span> <a name="line-244"></a> <span class='hs-layout'>)</span> <a name="line-245"></a> <a name="line-246"></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-conid'>ByteString</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>c2w</span><span class='hs-layout'>,</span> <span class='hs-varid'>w2c</span><span class='hs-layout'>,</span> <span class='hs-varid'>isSpaceWord8</span> <a name="line-247"></a> <span class='hs-layout'>,</span><span class='hs-varid'>inlinePerformIO</span><span class='hs-layout'>)</span> <a name="line-248"></a> <a name="line-249"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Char</span> <span class='hs-layout'>(</span> <span class='hs-varid'>isSpace</span> <span class='hs-layout'>)</span> <a name="line-250"></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> <span class='hs-layout'>(</span><span class='hs-varid'>intersperse</span><span class='hs-layout'>)</span> <a name="line-251"></a> <a name="line-252"></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'>openFile</span><span class='hs-layout'>,</span><span class='hs-varid'>hClose</span><span class='hs-layout'>,</span><span class='hs-varid'>hFileSize</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-253"></a><span class='hs-cpp'>#ifndef __NHC__</span> <a name="line-254"></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-255"></a><span class='hs-cpp'>#else</span> <a name="line-256"></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-257"></a><span class='hs-cpp'>#endif</span> <a name="line-258"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span> <a name="line-259"></a> <a name="line-260"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span> <a name="line-261"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>Base</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span><span class='hs-varid'>unpackCString</span><span class='hs-cpp'>#</span><span class='hs-layout'>,</span><span class='hs-varid'>ord</span><span class='hs-cpp'>#</span><span class='hs-layout'>,</span><span class='hs-varid'>int2Word</span><span class='hs-cpp'>#</span><span class='hs-layout'>)</span> <a name="line-262"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 611</span> <a name="line-263"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-varid'>stToIO</span><span class='hs-layout'>)</span> <a name="line-264"></a><span class='hs-cpp'>#else</span> <a name="line-265"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>IOBase</span> <span class='hs-layout'>(</span><span class='hs-varid'>stToIO</span><span class='hs-layout'>)</span> <a name="line-266"></a><span class='hs-cpp'>#endif</span> <a name="line-267"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>Prim</span> <span class='hs-layout'>(</span><span class='hs-conid'>Addr</span><span class='hs-cpp'>#</span><span class='hs-layout'>,</span><span class='hs-varid'>writeWord8OffAddr</span><span class='hs-cpp'>#</span><span class='hs-layout'>,</span><span class='hs-varid'>plusAddr</span><span class='hs-cpp'>#</span><span class='hs-layout'>)</span> <a name="line-268"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>Ptr</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-269"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>ST</span> <span class='hs-layout'>(</span><span class='hs-conid'>ST</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-270"></a><span class='hs-cpp'>#endif</span> <a name="line-271"></a> <a name="line-272"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 608</span> <a name="line-273"></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-274"></a><span class='hs-cpp'>#endif</span> <a name="line-275"></a> <a name="line-276"></a><span class='hs-cpp'>#define STRICT1(f) f a | a `seq` False = undefined</span> <a name="line-277"></a><span class='hs-cpp'>#define STRICT2(f) f a b | a `seq` b `seq` False = undefined</span> <a name="line-278"></a><span class='hs-cpp'>#define STRICT3(f) f a b c | a `seq` b `seq` c `seq` False = undefined</span> <a name="line-279"></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-280"></a> <a name="line-281"></a><span class='hs-comment'>------------------------------------------------------------------------</span> <a name="line-282"></a> <a name="line-283"></a><a name="singleton"></a><span class='hs-comment'>-- | /O(1)/ Convert a 'Char' into a 'ByteString'</span> <a name="line-284"></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-285"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-286"></a><span class='hs-comment'>{-# INLINE singleton #-}</span> <a name="line-287"></a> <a name="line-288"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 608</span> <a name="line-289"></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-290"></a> <span class='hs-varid'>fromString</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>pack</span> <a name="line-291"></a> <span class='hs-comment'>{-# INLINE fromString #-}</span> <a name="line-292"></a><span class='hs-cpp'>#endif</span> <a name="line-293"></a> <a name="line-294"></a><a name="pack"></a><span class='hs-comment'>-- | /O(n)/ Convert a 'String' into a 'ByteString'</span> <a name="line-295"></a><span class='hs-comment'>--</span> <a name="line-296"></a><span class='hs-comment'>-- For applications with large numbers of string literals, pack can be a</span> <a name="line-297"></a><span class='hs-comment'>-- bottleneck.</span> <a name="line-298"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>ByteString</span> <a name="line-299"></a><span class='hs-cpp'>#if !defined(__GLASGOW_HASKELL__)</span> <a name="line-300"></a> <a name="line-301"></a><span class='hs-definition'>pack</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeCreate</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>str</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>str</span> <a name="line-302"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span> <a name="line-303"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>poke</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varop'>>></span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span> <a name="line-304"></a> <a name="line-305"></a><span class='hs-cpp'>#else /* hack away */</span> <a name="line-306"></a> <a name="line-307"></a><span class='hs-definition'>pack</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeCreate</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-varid'>str</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>stToIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>str</span><span class='hs-layout'>)</span> <a name="line-308"></a> <span class='hs-keyword'>where</span> <a name="line-309"></a> <span class='hs-varid'>go</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Addr</span><span class='hs-cpp'>#</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'>ST</span> <span class='hs-varid'>a</span> <span class='hs-conid'>()</span> <a name="line-310"></a> <span class='hs-varid'>go</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span> <a name="line-311"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-conid'>C</span><span class='hs-cpp'>#</span> <span class='hs-varid'>c</span><span class='hs-conop'>:</span><span class='hs-varid'>cs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>writeByte</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>int2Word</span><span class='hs-cpp'>#</span> <span class='hs-layout'>(</span><span class='hs-varid'>ord</span><span class='hs-cpp'>#</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varop'>>></span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`</span><span class='hs-varid'>plusAddr</span><span class='hs-cpp'>#</span><span class='hs-varop'>`</span> <span class='hs-num'>1</span><span class='hs-cpp'>#</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span> <a name="line-312"></a> <a name="line-313"></a> <span class='hs-varid'>writeByte</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>ST</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>s</span><span class='hs-cpp'>#</span> <span class='hs-keyglyph'>-></span> <a name="line-314"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>writeWord8OffAddr</span><span class='hs-cpp'>#</span> <span class='hs-varid'>p</span> <span class='hs-num'>0</span><span class='hs-cpp'>#</span> <span class='hs-varid'>c</span> <span class='hs-varid'>s</span><span class='hs-cpp'>#</span> <span class='hs-keyword'>of</span> <span class='hs-varid'>s2</span><span class='hs-cpp'>#</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-cpp'>#</span> <span class='hs-varid'>s2</span><span class='hs-cpp'>#</span><span class='hs-layout'>,</span> <span class='hs-conid'>()</span> <span class='hs-cpp'>#</span><span class='hs-layout'>)</span> <a name="line-315"></a> <span class='hs-comment'>{-# INLINE writeByte #-}</span> <a name="line-316"></a><span class='hs-comment'>{-# INLINE [1] pack #-}</span> <a name="line-317"></a> <a name="line-318"></a><span class='hs-comment'>{-# RULES <a name="line-319"></a>"ByteString pack/packAddress" forall s . <a name="line-320"></a> pack (unpackCString# s) = inlinePerformIO (B.unsafePackAddress s) <a name="line-321"></a> #-}</span> <a name="line-322"></a> <a name="line-323"></a><span class='hs-cpp'>#endif</span> <a name="line-324"></a> <a name="line-325"></a><a name="unpack"></a><span class='hs-comment'>-- | /O(n)/ Converts a 'ByteString' to a 'String'.</span> <a name="line-326"></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-327"></a><span class='hs-definition'>unpack</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>P</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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unpack</span> <a name="line-328"></a><span class='hs-comment'>{-# INLINE unpack #-}</span> <a name="line-329"></a> <a name="line-330"></a><a name="cons"></a><span class='hs-comment'>-- | /O(n)/ 'cons' is analogous to (:) for lists, but of different</span> <a name="line-331"></a><span class='hs-comment'>-- complexity, as it requires a memcpy.</span> <a name="line-332"></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-333"></a><span class='hs-definition'>cons</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-334"></a><span class='hs-comment'>{-# INLINE cons #-}</span> <a name="line-335"></a> <a name="line-336"></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-337"></a><span class='hs-comment'>-- 'cons', this function performs a memcpy.</span> <a name="line-338"></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-339"></a><span class='hs-definition'>snoc</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-340"></a><span class='hs-comment'>{-# INLINE snoc #-}</span> <a name="line-341"></a> <a name="line-342"></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-343"></a><span class='hs-comment'>-- if it is empty.</span> <a name="line-344"></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-345"></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'>B</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-346"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span> <a name="line-347"></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-348"></a><span class='hs-comment'>{-# INLINE uncons #-}</span> <a name="line-349"></a> <a name="line-350"></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-351"></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-352"></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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>head</span> <a name="line-353"></a><span class='hs-comment'>{-# INLINE head #-}</span> <a name="line-354"></a> <a name="line-355"></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-356"></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-357"></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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>last</span> <a name="line-358"></a><span class='hs-comment'>{-# INLINE last #-}</span> <a name="line-359"></a> <a name="line-360"></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-361"></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-362"></a><span class='hs-definition'>map</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-363"></a><span class='hs-comment'>{-# INLINE map #-}</span> <a name="line-364"></a> <a name="line-365"></a><a name="intersperse"></a><span class='hs-comment'>-- | /O(n)/ The 'intersperse' function takes a Char and a 'ByteString'</span> <a name="line-366"></a><span class='hs-comment'>-- and \`intersperses\' that Char between the elements of the</span> <a name="line-367"></a><span class='hs-comment'>-- 'ByteString'. It is analogous to the intersperse function on Lists.</span> <a name="line-368"></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-369"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-370"></a><span class='hs-comment'>{-# INLINE intersperse #-}</span> <a name="line-371"></a> <a name="line-372"></a><a name="foldl"></a><span class='hs-comment'>-- | 'foldl', applied to a binary operator, a starting value (typically</span> <a name="line-373"></a><span class='hs-comment'>-- the left-identity of the operator), and a ByteString, reduces the</span> <a name="line-374"></a><span class='hs-comment'>-- ByteString using the binary operator, from left to right.</span> <a name="line-375"></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-376"></a><span class='hs-definition'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-377"></a><span class='hs-comment'>{-# INLINE foldl #-}</span> <a name="line-378"></a> <a name="line-379"></a><a name="foldl'"></a><span class='hs-comment'>-- | 'foldl\'' is like foldl, but strict in the accumulator.</span> <a name="line-380"></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-381"></a><span class='hs-definition'>foldl'</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-382"></a><span class='hs-comment'>{-# INLINE foldl' #-}</span> <a name="line-383"></a> <a name="line-384"></a><a name="foldr"></a><span class='hs-comment'>-- | 'foldr', applied to a binary operator, a starting value</span> <a name="line-385"></a><span class='hs-comment'>-- (typically the right-identity of the operator), and a packed string,</span> <a name="line-386"></a><span class='hs-comment'>-- reduces the packed string using the binary operator, from right to left.</span> <a name="line-387"></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-388"></a><span class='hs-definition'>foldr</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-389"></a><span class='hs-comment'>{-# INLINE foldr #-}</span> <a name="line-390"></a> <a name="line-391"></a><a name="foldr'"></a><span class='hs-comment'>-- | 'foldr\'' is a strict variant of foldr</span> <a name="line-392"></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-393"></a><span class='hs-definition'>foldr'</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-394"></a><span class='hs-comment'>{-# INLINE foldr' #-}</span> <a name="line-395"></a> <a name="line-396"></a><a name="foldl1"></a><span class='hs-comment'>-- | 'foldl1' is a variant of 'foldl' that has no starting value</span> <a name="line-397"></a><span class='hs-comment'>-- argument, and thus must be applied to non-empty 'ByteStrings'.</span> <a name="line-398"></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-399"></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'>B</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-400"></a><span class='hs-comment'>{-# INLINE foldl1 #-}</span> <a name="line-401"></a> <a name="line-402"></a><a name="foldl1'"></a><span class='hs-comment'>-- | A strict version of 'foldl1'</span> <a name="line-403"></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-404"></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'>B</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-405"></a><span class='hs-comment'>{-# INLINE foldl1' #-}</span> <a name="line-406"></a> <a name="line-407"></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-408"></a><span class='hs-comment'>-- and thus must be applied to non-empty 'ByteString's</span> <a name="line-409"></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-410"></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'>B</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-411"></a><span class='hs-comment'>{-# INLINE foldr1 #-}</span> <a name="line-412"></a> <a name="line-413"></a><a name="foldr1'"></a><span class='hs-comment'>-- | A strict variant of foldr1</span> <a name="line-414"></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-415"></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'>B</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-416"></a><span class='hs-comment'>{-# INLINE foldr1' #-}</span> <a name="line-417"></a> <a name="line-418"></a><a name="concatMap"></a><span class='hs-comment'>-- | Map a function over a 'ByteString' and concatenate the results</span> <a name="line-419"></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-420"></a><span class='hs-definition'>concatMap</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-421"></a><span class='hs-comment'>{-# INLINE concatMap #-}</span> <a name="line-422"></a> <a name="line-423"></a><a name="any"></a><span class='hs-comment'>-- | Applied to a predicate and a ByteString, 'any' determines if</span> <a name="line-424"></a><span class='hs-comment'>-- any element of the 'ByteString' satisfies the predicate.</span> <a name="line-425"></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-426"></a><span class='hs-definition'>any</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-427"></a><span class='hs-comment'>{-# INLINE any #-}</span> <a name="line-428"></a> <a name="line-429"></a><a name="all"></a><span class='hs-comment'>-- | Applied to a predicate and a 'ByteString', 'all' determines if</span> <a name="line-430"></a><span class='hs-comment'>-- all elements of the 'ByteString' satisfy the predicate.</span> <a name="line-431"></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-432"></a><span class='hs-definition'>all</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-433"></a><span class='hs-comment'>{-# INLINE all #-}</span> <a name="line-434"></a> <a name="line-435"></a><a name="maximum"></a><span class='hs-comment'>-- | 'maximum' returns the maximum value from a 'ByteString'</span> <a name="line-436"></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-437"></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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>maximum</span> <a name="line-438"></a><span class='hs-comment'>{-# INLINE maximum #-}</span> <a name="line-439"></a> <a name="line-440"></a><a name="minimum"></a><span class='hs-comment'>-- | 'minimum' returns the minimum value from a 'ByteString'</span> <a name="line-441"></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-442"></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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>minimum</span> <a name="line-443"></a><span class='hs-comment'>{-# INLINE minimum #-}</span> <a name="line-444"></a> <a name="line-445"></a><a name="mapAccumL"></a><span class='hs-comment'>-- | The 'mapAccumL' function behaves like a combination of 'map' and</span> <a name="line-446"></a><span class='hs-comment'>-- 'foldl'; it applies a function to each element of a ByteString,</span> <a name="line-447"></a><span class='hs-comment'>-- passing an accumulating parameter from left to right, and returning a</span> <a name="line-448"></a><span class='hs-comment'>-- final value of this accumulator together with the new list.</span> <a name="line-449"></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-450"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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'>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-451"></a> <a name="line-452"></a><a name="mapAccumR"></a><span class='hs-comment'>-- | The 'mapAccumR' function behaves like a combination of 'map' and</span> <a name="line-453"></a><span class='hs-comment'>-- 'foldr'; it applies a function to each element of a ByteString,</span> <a name="line-454"></a><span class='hs-comment'>-- passing an accumulating parameter from right to left, and returning a</span> <a name="line-455"></a><span class='hs-comment'>-- final value of this accumulator together with the new ByteString.</span> <a name="line-456"></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-457"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-458"></a> <a name="line-459"></a><a name="scanl"></a><span class='hs-comment'>-- | 'scanl' is similar to 'foldl', but returns a list of successive</span> <a name="line-460"></a><span class='hs-comment'>-- reduced values from the left:</span> <a name="line-461"></a><span class='hs-comment'>--</span> <a name="line-462"></a><span class='hs-comment'>-- > scanl f z [x1, x2, ...] == [z, z `f` x1, (z `f` x1) `f` x2, ...]</span> <a name="line-463"></a><span class='hs-comment'>--</span> <a name="line-464"></a><span class='hs-comment'>-- Note that</span> <a name="line-465"></a><span class='hs-comment'>--</span> <a name="line-466"></a><span class='hs-comment'>-- > last (scanl f z xs) == foldl f z xs.</span> <a name="line-467"></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-468"></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'>B</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-469"></a> <a name="line-470"></a><a name="scanl1"></a><span class='hs-comment'>-- | 'scanl1' is a variant of 'scanl' that has no starting value argument:</span> <a name="line-471"></a><span class='hs-comment'>--</span> <a name="line-472"></a><span class='hs-comment'>-- > scanl1 f [x1, x2, ...] == [x1, x1 `f` x2, ...]</span> <a name="line-473"></a><span class='hs-definition'>scanl1</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'>ByteString</span> <a name="line-474"></a><span class='hs-definition'>scanl1</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>scanl1</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> <a name="line-475"></a> <a name="line-476"></a><a name="scanr"></a><span class='hs-comment'>-- | scanr is the right-to-left dual of scanl.</span> <a name="line-477"></a><span class='hs-definition'>scanr</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-478"></a><span class='hs-definition'>scanr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>scanr</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-479"></a> <a name="line-480"></a><a name="scanr1"></a><span class='hs-comment'>-- | 'scanr1' is a variant of 'scanr' that has no starting value argument.</span> <a name="line-481"></a><span class='hs-definition'>scanr1</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'>ByteString</span> <a name="line-482"></a><span class='hs-definition'>scanr1</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>scanr1</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> <a name="line-483"></a> <a name="line-484"></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-485"></a><span class='hs-comment'>-- the value of every element. The following holds:</span> <a name="line-486"></a><span class='hs-comment'>--</span> <a name="line-487"></a><span class='hs-comment'>-- > replicate w c = unfoldr w (\u -> Just (u,u)) c</span> <a name="line-488"></a><span class='hs-comment'>--</span> <a name="line-489"></a><span class='hs-comment'>-- This implemenation uses @memset(3)@</span> <a name="line-490"></a><span class='hs-definition'>replicate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</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-491"></a><span class='hs-definition'>replicate</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span> <span class='hs-varid'>w</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span> <a name="line-492"></a><span class='hs-comment'>{-# INLINE replicate #-}</span> <a name="line-493"></a> <a name="line-494"></a><a name="unfoldr"></a><span class='hs-comment'>-- | /O(n)/, where /n/ is the length of the result. The 'unfoldr' </span> <a name="line-495"></a><span class='hs-comment'>-- function is analogous to the List \'unfoldr\'. 'unfoldr' builds a </span> <a name="line-496"></a><span class='hs-comment'>-- ByteString from a seed value. The function takes the element and </span> <a name="line-497"></a><span class='hs-comment'>-- returns 'Nothing' if it is done producing the ByteString or returns </span> <a name="line-498"></a><span class='hs-comment'>-- 'Just' @(a,b)@, in which case, @a@ is the next character in the string, </span> <a name="line-499"></a><span class='hs-comment'>-- and @b@ is the seed value for further production.</span> <a name="line-500"></a><span class='hs-comment'>--</span> <a name="line-501"></a><span class='hs-comment'>-- Examples:</span> <a name="line-502"></a><span class='hs-comment'>--</span> <a name="line-503"></a><span class='hs-comment'>-- > unfoldr (\x -> if x <= '9' then Just (x, succ x) else Nothing) '0' == "0123456789"</span> <a name="line-504"></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-505"></a><span class='hs-definition'>unfoldr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unfoldr</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-varid'>k</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>x0</span> <a name="line-506"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-layout'>,</span> <span class='hs-varid'>j</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>i</span><span class='hs-layout'>,</span> <span class='hs-varid'>j</span><span class='hs-layout'>)</span> <a name="line-507"></a> <a name="line-508"></a><a name="unfoldrN"></a><span class='hs-comment'>-- | /O(n)/ Like 'unfoldr', 'unfoldrN' builds a ByteString from a seed</span> <a name="line-509"></a><span class='hs-comment'>-- value. However, the length of the result is limited by the first</span> <a name="line-510"></a><span class='hs-comment'>-- argument to 'unfoldrN'. This function is more efficient than 'unfoldr'</span> <a name="line-511"></a><span class='hs-comment'>-- when the maximum length of the result is known.</span> <a name="line-512"></a><span class='hs-comment'>--</span> <a name="line-513"></a><span class='hs-comment'>-- The following equation relates 'unfoldrN' and 'unfoldr':</span> <a name="line-514"></a><span class='hs-comment'>--</span> <a name="line-515"></a><span class='hs-comment'>-- > unfoldrN n f s == take n (unfoldr f s)</span> <a name="line-516"></a><span class='hs-definition'>unfoldrN</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</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-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span> <span class='hs-conid'>Maybe</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-517"></a><span class='hs-definition'>unfoldrN</span> <span class='hs-varid'>n</span> <span class='hs-varid'>f</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unfoldrN</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>k</span> <span class='hs-varop'>`fmap`</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span> <a name="line-518"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-layout'>,</span><span class='hs-varid'>j</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>c2w</span> <span class='hs-varid'>i</span><span class='hs-layout'>,</span> <span class='hs-varid'>j</span><span class='hs-layout'>)</span> <a name="line-519"></a><span class='hs-comment'>{-# INLINE unfoldrN #-}</span> <a name="line-520"></a> <a name="line-521"></a><a name="takeWhile"></a><span class='hs-comment'>-- | 'takeWhile', applied to a predicate @p@ and a ByteString @xs@,</span> <a name="line-522"></a><span class='hs-comment'>-- returns the longest prefix (possibly empty) of @xs@ of elements that</span> <a name="line-523"></a><span class='hs-comment'>-- satisfy @p@.</span> <a name="line-524"></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-525"></a><span class='hs-definition'>takeWhile</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-526"></a><span class='hs-comment'>{-# INLINE takeWhile #-}</span> <a name="line-527"></a> <a name="line-528"></a><a name="dropWhile"></a><span class='hs-comment'>-- | 'dropWhile' @p xs@ returns the suffix remaining after 'takeWhile' @p xs@.</span> <a name="line-529"></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-530"></a><span class='hs-definition'>dropWhile</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-531"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span> <a name="line-532"></a><span class='hs-comment'>{-# INLINE [1] dropWhile #-}</span> <a name="line-533"></a><span class='hs-cpp'>#endif</span> <a name="line-534"></a> <a name="line-535"></a><span class='hs-comment'>{-# RULES <a name="line-536"></a>"ByteString specialise dropWhile isSpace -> dropSpace" <a name="line-537"></a> dropWhile isSpace = dropSpace <a name="line-538"></a> #-}</span> <a name="line-539"></a> <a name="line-540"></a><a name="break"></a><span class='hs-comment'>-- | 'break' @p@ is equivalent to @'span' ('not' . p)@.</span> <a name="line-541"></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-542"></a><span class='hs-definition'>break</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-543"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span> <a name="line-544"></a><span class='hs-comment'>{-# INLINE [1] break #-}</span> <a name="line-545"></a><span class='hs-cpp'>#endif</span> <a name="line-546"></a> <a name="line-547"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 606</span> <a name="line-548"></a><span class='hs-comment'>-- This RULE LHS is not allowed by ghc-6.4</span> <a name="line-549"></a><span class='hs-comment'>{-# RULES <a name="line-550"></a>"ByteString specialise break (x==)" forall x. <a name="line-551"></a> break ((==) x) = breakChar x <a name="line-552"></a>"ByteString specialise break (==x)" forall x. <a name="line-553"></a> break (==x) = breakChar x <a name="line-554"></a> #-}</span> <a name="line-555"></a><span class='hs-cpp'>#endif</span> <a name="line-556"></a> <a name="line-557"></a><span class='hs-comment'>-- INTERNAL:</span> <a name="line-558"></a> <a name="line-559"></a><a name="breakChar"></a><span class='hs-comment'>-- | 'breakChar' breaks its ByteString argument at the first occurence</span> <a name="line-560"></a><span class='hs-comment'>-- of the specified char. It is more efficient than 'break' as it is</span> <a name="line-561"></a><span class='hs-comment'>-- implemented with @memchr(3)@. I.e.</span> <a name="line-562"></a><span class='hs-comment'>-- </span> <a name="line-563"></a><span class='hs-comment'>-- > break (=='c') "abcd" == breakChar 'c' "abcd"</span> <a name="line-564"></a><span class='hs-comment'>--</span> <a name="line-565"></a><span class='hs-definition'>breakChar</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-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-566"></a><span class='hs-definition'>breakChar</span> <span class='hs-varid'>c</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>elemIndex</span> <span class='hs-varid'>c</span> <span class='hs-varid'>p</span> <span class='hs-keyword'>of</span> <a name="line-567"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span><span class='hs-layout'>,</span><span class='hs-varid'>empty</span><span class='hs-layout'>)</span> <a name="line-568"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>-></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'>p</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-varid'>n</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <a name="line-569"></a><span class='hs-comment'>{-# INLINE breakChar #-}</span> <a name="line-570"></a> <a name="line-571"></a><a name="span"></a><span class='hs-comment'>-- | 'span' @p xs@ breaks the ByteString into two segments. It is</span> <a name="line-572"></a><span class='hs-comment'>-- equivalent to @('takeWhile' p xs, 'dropWhile' p xs)@</span> <a name="line-573"></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-574"></a><span class='hs-definition'>span</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-575"></a><span class='hs-comment'>{-# INLINE span #-}</span> <a name="line-576"></a> <a name="line-577"></a><a name="spanEnd"></a><span class='hs-comment'>-- | 'spanEnd' behaves like 'span' but from the end of the 'ByteString'.</span> <a name="line-578"></a><span class='hs-comment'>-- We have</span> <a name="line-579"></a><span class='hs-comment'>--</span> <a name="line-580"></a><span class='hs-comment'>-- > spanEnd (not.isSpace) "x y z" == ("x y ","z")</span> <a name="line-581"></a><span class='hs-comment'>--</span> <a name="line-582"></a><span class='hs-comment'>-- and</span> <a name="line-583"></a><span class='hs-comment'>--</span> <a name="line-584"></a><span class='hs-comment'>-- > spanEnd (not . isSpace) ps</span> <a name="line-585"></a><span class='hs-comment'>-- > == </span> <a name="line-586"></a><span class='hs-comment'>-- > let (x,y) = span (not.isSpace) (reverse ps) in (reverse y, reverse x) </span> <a name="line-587"></a><span class='hs-comment'>--</span> <a name="line-588"></a><span class='hs-definition'>spanEnd</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-589"></a><span class='hs-definition'>spanEnd</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>spanEnd</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-590"></a><span class='hs-comment'>{-# INLINE spanEnd #-}</span> <a name="line-591"></a> <a name="line-592"></a><a name="breakEnd"></a><span class='hs-comment'>-- | 'breakEnd' behaves like 'break' but from the end of the 'ByteString'</span> <a name="line-593"></a><span class='hs-comment'>-- </span> <a name="line-594"></a><span class='hs-comment'>-- breakEnd p == spanEnd (not.p)</span> <a name="line-595"></a><span class='hs-definition'>breakEnd</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-596"></a><span class='hs-definition'>breakEnd</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>breakEnd</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-597"></a><span class='hs-comment'>{-# INLINE breakEnd #-}</span> <a name="line-598"></a> <a name="line-599"></a><span class='hs-comment'>{- <a name="line-600"></a>-- | 'breakChar' breaks its ByteString argument at the first occurence <a name="line-601"></a>-- of the specified Char. It is more efficient than 'break' as it is <a name="line-602"></a>-- implemented with @memchr(3)@. I.e. <a name="line-603"></a>-- <a name="line-604"></a>-- > break (=='c') "abcd" == breakChar 'c' "abcd" <a name="line-605"></a>-- <a name="line-606"></a>breakChar :: Char -> ByteString -> (ByteString, ByteString) <a name="line-607"></a>breakChar = B.breakByte . c2w <a name="line-608"></a>{-# INLINE breakChar #-} <a name="line-609"></a> <a name="line-610"></a>-- | 'spanChar' breaks its ByteString argument at the first <a name="line-611"></a>-- occurence of a Char other than its argument. It is more efficient <a name="line-612"></a>-- than 'span (==)' <a name="line-613"></a>-- <a name="line-614"></a>-- > span (=='c') "abcd" == spanByte 'c' "abcd" <a name="line-615"></a>-- <a name="line-616"></a>spanChar :: Char -> ByteString -> (ByteString, ByteString) <a name="line-617"></a>spanChar = B.spanByte . c2w <a name="line-618"></a>{-# INLINE spanChar #-} <a name="line-619"></a>-}</span> <a name="line-620"></a> <a name="line-621"></a><a name="split"></a><span class='hs-comment'>-- | /O(n)/ Break a 'ByteString' into pieces separated by the byte</span> <a name="line-622"></a><span class='hs-comment'>-- argument, consuming the delimiter. I.e.</span> <a name="line-623"></a><span class='hs-comment'>--</span> <a name="line-624"></a><span class='hs-comment'>-- > split '\n' "a\nb\nd\ne" == ["a","b","d","e"]</span> <a name="line-625"></a><span class='hs-comment'>-- > split 'a' "aXaXaXa" == ["","X","X","X",""]</span> <a name="line-626"></a><span class='hs-comment'>-- > split 'x' "x" == ["",""]</span> <a name="line-627"></a><span class='hs-comment'>-- </span> <a name="line-628"></a><span class='hs-comment'>-- and</span> <a name="line-629"></a><span class='hs-comment'>--</span> <a name="line-630"></a><span class='hs-comment'>-- > intercalate [c] . split c == id</span> <a name="line-631"></a><span class='hs-comment'>-- > split == splitWith . (==)</span> <a name="line-632"></a><span class='hs-comment'>-- </span> <a name="line-633"></a><span class='hs-comment'>-- As for all splitting functions in this library, this function does</span> <a name="line-634"></a><span class='hs-comment'>-- not copy the substrings, it just constructs new 'ByteStrings' that</span> <a name="line-635"></a><span class='hs-comment'>-- are slices of the original.</span> <a name="line-636"></a><span class='hs-comment'>--</span> <a name="line-637"></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-638"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-639"></a><span class='hs-comment'>{-# INLINE split #-}</span> <a name="line-640"></a> <a name="line-641"></a><a name="splitWith"></a><span class='hs-comment'>-- | /O(n)/ Splits a 'ByteString' into components delimited by</span> <a name="line-642"></a><span class='hs-comment'>-- separators, where the predicate returns True for a separator element.</span> <a name="line-643"></a><span class='hs-comment'>-- The resulting components do not contain the separators. Two adjacent</span> <a name="line-644"></a><span class='hs-comment'>-- separators result in an empty component in the output. eg.</span> <a name="line-645"></a><span class='hs-comment'>--</span> <a name="line-646"></a><span class='hs-comment'>-- > splitWith (=='a') "aabbaca" == ["","","bb","c",""]</span> <a name="line-647"></a><span class='hs-comment'>--</span> <a name="line-648"></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-649"></a><span class='hs-definition'>splitWith</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-650"></a><span class='hs-comment'>{-# INLINE splitWith #-}</span> <a name="line-651"></a><span class='hs-comment'>-- the inline makes a big difference here.</span> <a name="line-652"></a> <a name="line-653"></a><span class='hs-comment'>{- <a name="line-654"></a>-- | Like 'splitWith', except that sequences of adjacent separators are <a name="line-655"></a>-- treated as a single separator. eg. <a name="line-656"></a>-- <a name="line-657"></a>-- > tokens (=='a') "aabbaca" == ["bb","c"] <a name="line-658"></a>-- <a name="line-659"></a>tokens :: (Char -> Bool) -> ByteString -> [ByteString] <a name="line-660"></a>tokens f = B.tokens (f . w2c) <a name="line-661"></a>{-# INLINE tokens #-} <a name="line-662"></a>-}</span> <a name="line-663"></a> <a name="line-664"></a><a name="groupBy"></a><span class='hs-comment'>-- | The 'groupBy' function is the non-overloaded version of 'group'.</span> <a name="line-665"></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-666"></a><span class='hs-definition'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-667"></a> <a name="line-668"></a><a name="index"></a><span class='hs-comment'>-- | /O(1)/ 'ByteString' index (subscript) operator, starting from 0.</span> <a name="line-669"></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'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-670"></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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>index</span> <a name="line-671"></a><span class='hs-comment'>{-# INLINE index #-}</span> <a name="line-672"></a> <a name="line-673"></a><a name="elemIndex"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndex' function returns the index of the first</span> <a name="line-674"></a><span class='hs-comment'>-- element in the given 'ByteString' which is equal (by memchr) to the</span> <a name="line-675"></a><span class='hs-comment'>-- query element, or 'Nothing' if there is no such element.</span> <a name="line-676"></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'>Int</span> <a name="line-677"></a><span class='hs-definition'>elemIndex</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-678"></a><span class='hs-comment'>{-# INLINE elemIndex #-}</span> <a name="line-679"></a> <a name="line-680"></a><a name="elemIndexEnd"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndexEnd' function returns the last index of the</span> <a name="line-681"></a><span class='hs-comment'>-- element in the given 'ByteString' which is equal to the query</span> <a name="line-682"></a><span class='hs-comment'>-- element, or 'Nothing' if there is no such element. The following</span> <a name="line-683"></a><span class='hs-comment'>-- holds:</span> <a name="line-684"></a><span class='hs-comment'>--</span> <a name="line-685"></a><span class='hs-comment'>-- > elemIndexEnd c xs == </span> <a name="line-686"></a><span class='hs-comment'>-- > (-) (length xs - 1) `fmap` elemIndex c (reverse xs)</span> <a name="line-687"></a><span class='hs-comment'>--</span> <a name="line-688"></a><span class='hs-definition'>elemIndexEnd</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'>Int</span> <a name="line-689"></a><span class='hs-definition'>elemIndexEnd</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>elemIndexEnd</span> <span class='hs-varop'>.</span> <span class='hs-varid'>c2w</span> <a name="line-690"></a><span class='hs-comment'>{-# INLINE elemIndexEnd #-}</span> <a name="line-691"></a> <a name="line-692"></a><a name="elemIndices"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndices' function extends 'elemIndex', by returning</span> <a name="line-693"></a><span class='hs-comment'>-- the indices of all elements equal to the query element, in ascending order.</span> <a name="line-694"></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'>Int</span><span class='hs-keyglyph'>]</span> <a name="line-695"></a><span class='hs-definition'>elemIndices</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-696"></a><span class='hs-comment'>{-# INLINE elemIndices #-}</span> <a name="line-697"></a> <a name="line-698"></a><a name="findIndex"></a><span class='hs-comment'>-- | The 'findIndex' function takes a predicate and a 'ByteString' and</span> <a name="line-699"></a><span class='hs-comment'>-- returns the index of the first element in the ByteString satisfying the predicate.</span> <a name="line-700"></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'>Int</span> <a name="line-701"></a><span class='hs-definition'>findIndex</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-702"></a><span class='hs-comment'>{-# INLINE findIndex #-}</span> <a name="line-703"></a> <a name="line-704"></a><a name="findIndices"></a><span class='hs-comment'>-- | The 'findIndices' function extends 'findIndex', by returning the</span> <a name="line-705"></a><span class='hs-comment'>-- indices of all elements satisfying the predicate, in ascending order.</span> <a name="line-706"></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'>Int</span><span class='hs-keyglyph'>]</span> <a name="line-707"></a><span class='hs-definition'>findIndices</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-708"></a> <a name="line-709"></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-710"></a><span class='hs-comment'>--</span> <a name="line-711"></a><span class='hs-comment'>-- > count = length . elemIndices</span> <a name="line-712"></a><span class='hs-comment'>-- </span> <a name="line-713"></a><span class='hs-comment'>-- Also</span> <a name="line-714"></a><span class='hs-comment'>-- </span> <a name="line-715"></a><span class='hs-comment'>-- > count '\n' == length . lines</span> <a name="line-716"></a><span class='hs-comment'>--</span> <a name="line-717"></a><span class='hs-comment'>-- But more efficiently than using length on the intermediate list.</span> <a name="line-718"></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'>Int</span> <a name="line-719"></a><span class='hs-definition'>count</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-720"></a> <a name="line-721"></a><a name="elem"></a><span class='hs-comment'>-- | /O(n)/ 'elem' is the 'ByteString' membership predicate. This</span> <a name="line-722"></a><span class='hs-comment'>-- implementation uses @memchr(3)@.</span> <a name="line-723"></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-724"></a><span class='hs-definition'>elem</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-725"></a><span class='hs-comment'>{-# INLINE elem #-}</span> <a name="line-726"></a> <a name="line-727"></a><a name="notElem"></a><span class='hs-comment'>-- | /O(n)/ 'notElem' is the inverse of 'elem'</span> <a name="line-728"></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-729"></a><span class='hs-definition'>notElem</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-730"></a><span class='hs-comment'>{-# INLINE notElem #-}</span> <a name="line-731"></a> <a name="line-732"></a><a name="filter"></a><span class='hs-comment'>-- | /O(n)/ 'filter', applied to a predicate and a ByteString,</span> <a name="line-733"></a><span class='hs-comment'>-- returns a ByteString containing those characters that satisfy the</span> <a name="line-734"></a><span class='hs-comment'>-- predicate.</span> <a name="line-735"></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-736"></a><span class='hs-definition'>filter</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-737"></a><span class='hs-comment'>{-# INLINE filter #-}</span> <a name="line-738"></a> <a name="line-739"></a><span class='hs-comment'>{- <a name="line-740"></a>-- | /O(n)/ and /O(n\/c) space/ A first order equivalent of /filter . <a name="line-741"></a>-- (==)/, for the common case of filtering a single Char. It is more <a name="line-742"></a>-- efficient to use /filterChar/ in this case. <a name="line-743"></a>-- <a name="line-744"></a>-- > filterChar == filter . (==) <a name="line-745"></a>-- <a name="line-746"></a>-- filterChar is around 10x faster, and uses much less space, than its <a name="line-747"></a>-- filter equivalent <a name="line-748"></a>-- <a name="line-749"></a>filterChar :: Char -> ByteString -> ByteString <a name="line-750"></a>filterChar c ps = replicate (count c ps) c <a name="line-751"></a>{-# INLINE filterChar #-} <a name="line-752"></a> <a name="line-753"></a>{-# RULES <a name="line-754"></a>"ByteString specialise filter (== x)" forall x. <a name="line-755"></a> filter ((==) x) = filterChar x <a name="line-756"></a>"ByteString specialise filter (== x)" forall x. <a name="line-757"></a> filter (== x) = filterChar x <a name="line-758"></a> #-} <a name="line-759"></a>-}</span> <a name="line-760"></a> <a name="line-761"></a><a name="find"></a><span class='hs-comment'>-- | /O(n)/ The 'find' function takes a predicate and a ByteString,</span> <a name="line-762"></a><span class='hs-comment'>-- and returns the first element in matching the predicate, or 'Nothing'</span> <a name="line-763"></a><span class='hs-comment'>-- if there is no such element.</span> <a name="line-764"></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-765"></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'>B</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-766"></a><span class='hs-comment'>{-# INLINE find #-}</span> <a name="line-767"></a> <a name="line-768"></a><span class='hs-comment'>{- <a name="line-769"></a>-- | /O(n)/ A first order equivalent of /filter . (==)/, for the common <a name="line-770"></a>-- case of filtering a single Char. It is more efficient to use <a name="line-771"></a>-- filterChar in this case. <a name="line-772"></a>-- <a name="line-773"></a>-- > filterChar == filter . (==) <a name="line-774"></a>-- <a name="line-775"></a>-- filterChar is around 10x faster, and uses much less space, than its <a name="line-776"></a>-- filter equivalent <a name="line-777"></a>-- <a name="line-778"></a>filterChar :: Char -> ByteString -> ByteString <a name="line-779"></a>filterChar c = B.filterByte (c2w c) <a name="line-780"></a>{-# INLINE filterChar #-} <a name="line-781"></a> <a name="line-782"></a>-- | /O(n)/ A first order equivalent of /filter . (\/=)/, for the common <a name="line-783"></a>-- case of filtering a single Char out of a list. It is more efficient <a name="line-784"></a>-- to use /filterNotChar/ in this case. <a name="line-785"></a>-- <a name="line-786"></a>-- > filterNotChar == filter . (/=) <a name="line-787"></a>-- <a name="line-788"></a>-- filterNotChar is around 3x faster, and uses much less space, than its <a name="line-789"></a>-- filter equivalent <a name="line-790"></a>-- <a name="line-791"></a>filterNotChar :: Char -> ByteString -> ByteString <a name="line-792"></a>filterNotChar c = B.filterNotByte (c2w c) <a name="line-793"></a>{-# INLINE filterNotChar #-} <a name="line-794"></a>-}</span> <a name="line-795"></a> <a name="line-796"></a><a name="zip"></a><span class='hs-comment'>-- | /O(n)/ 'zip' takes two ByteStrings and returns a list of</span> <a name="line-797"></a><span class='hs-comment'>-- corresponding pairs of Chars. If one input ByteString is short,</span> <a name="line-798"></a><span class='hs-comment'>-- excess elements of the longer ByteString are discarded. This is</span> <a name="line-799"></a><span class='hs-comment'>-- equivalent to a pair of 'unpack' operations, and so space</span> <a name="line-800"></a><span class='hs-comment'>-- usage may be large for multi-megabyte ByteStrings</span> <a name="line-801"></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-802"></a><span class='hs-definition'>zip</span> <span class='hs-varid'>ps</span> <span class='hs-varid'>qs</span> <a name="line-803"></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'>ps</span> <span class='hs-varop'>||</span> <span class='hs-conid'>B</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-804"></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'>unsafeHead</span> <span class='hs-varid'>ps</span><span class='hs-layout'>,</span> <span class='hs-varid'>unsafeHead</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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</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'>qs</span><span class='hs-layout'>)</span> <a name="line-805"></a> <a name="line-806"></a><a name="zipWith"></a><span class='hs-comment'>-- | 'zipWith' generalises 'zip' by zipping with the function given as</span> <a name="line-807"></a><span class='hs-comment'>-- the first argument, instead of a tupling function. For example,</span> <a name="line-808"></a><span class='hs-comment'>-- @'zipWith' (+)@ is applied to two ByteStrings to produce the list</span> <a name="line-809"></a><span class='hs-comment'>-- of corresponding sums.</span> <a name="line-810"></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-811"></a><span class='hs-definition'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>B</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-812"></a> <a name="line-813"></a><a name="unzip"></a><span class='hs-comment'>-- | 'unzip' transforms a list of pairs of Chars into a pair of</span> <a name="line-814"></a><span class='hs-comment'>-- ByteStrings. Note that this performs two 'pack' operations.</span> <a name="line-815"></a><span class='hs-definition'>unzip</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>,</span><span class='hs-conid'>Char</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>,</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-816"></a><span class='hs-definition'>unzip</span> <span class='hs-varid'>ls</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>pack</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>fst</span> <span class='hs-varid'>ls</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>pack</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>snd</span> <span class='hs-varid'>ls</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-817"></a><span class='hs-comment'>{-# INLINE unzip #-}</span> <a name="line-818"></a> <a name="line-819"></a><a name="unsafeHead"></a><span class='hs-comment'>-- | A variety of 'head' for non-empty ByteStrings. 'unsafeHead' omits</span> <a name="line-820"></a><span class='hs-comment'>-- the check for the empty case, which is good for performance, but</span> <a name="line-821"></a><span class='hs-comment'>-- there is an obligation on the programmer to provide a proof that the</span> <a name="line-822"></a><span class='hs-comment'>-- ByteString is non-empty.</span> <a name="line-823"></a><span class='hs-definition'>unsafeHead</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-824"></a><span class='hs-definition'>unsafeHead</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>w2c</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeHead</span> <a name="line-825"></a><span class='hs-comment'>{-# INLINE unsafeHead #-}</span> <a name="line-826"></a> <a name="line-827"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-828"></a><span class='hs-comment'>-- Things that depend on the encoding</span> <a name="line-829"></a> <a name="line-830"></a><span class='hs-comment'>{-# RULES <a name="line-831"></a>"ByteString specialise break -> breakSpace" <a name="line-832"></a> break isSpace = breakSpace <a name="line-833"></a> #-}</span> <a name="line-834"></a> <a name="line-835"></a><a name="breakSpace"></a><span class='hs-comment'>-- | 'breakSpace' returns the pair of ByteStrings when the argument is</span> <a name="line-836"></a><span class='hs-comment'>-- broken at the first whitespace byte. I.e.</span> <a name="line-837"></a><span class='hs-comment'>-- </span> <a name="line-838"></a><span class='hs-comment'>-- > break isSpace == breakSpace</span> <a name="line-839"></a><span class='hs-comment'>--</span> <a name="line-840"></a><span class='hs-definition'>breakSpace</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-841"></a><span class='hs-definition'>breakSpace</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inlinePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-842"></a> <span class='hs-varid'>i</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>firstspace</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>l</span> <a name="line-843"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-keyword'>case</span> <span class='hs-conid'>()</span> <span class='hs-keyword'>of</span> <span class='hs-layout'>{</span><span class='hs-keyword'>_</span> <a name="line-844"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>empty</span><span class='hs-layout'>,</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <a name="line-845"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>==</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>,</span> <span class='hs-varid'>empty</span><span class='hs-layout'>)</span> <a name="line-846"></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-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>i</span><span class='hs-layout'>,</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-847"></a> <span class='hs-layout'>}</span> <a name="line-848"></a><span class='hs-comment'>{-# INLINE breakSpace #-}</span> <a name="line-849"></a> <a name="line-850"></a><a name="firstspace"></a><span class='hs-definition'>firstspace</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</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-conid'>IO</span> <span class='hs-conid'>Int</span> <a name="line-851"></a><span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>firstspace</span><span class='hs-layout'>)</span> <a name="line-852"></a><span class='hs-definition'>firstspace</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <span class='hs-varid'>m</span> <a name="line-853"></a> <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-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>n</span> <a name="line-854"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <a name="line-855"></a> <span class='hs-keyword'>if</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>isSpaceWord8</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>firstspace</span> <span class='hs-varid'>ptr</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'>m</span> <span class='hs-keyword'>else</span> <span class='hs-varid'>return</span> <span class='hs-varid'>n</span> <a name="line-856"></a> <a name="line-857"></a><a name="dropSpace"></a><span class='hs-comment'>-- | 'dropSpace' efficiently returns the 'ByteString' argument with</span> <a name="line-858"></a><span class='hs-comment'>-- white space Chars removed from the front. It is more efficient than</span> <a name="line-859"></a><span class='hs-comment'>-- calling dropWhile for removing whitespace. I.e.</span> <a name="line-860"></a><span class='hs-comment'>-- </span> <a name="line-861"></a><span class='hs-comment'>-- > dropWhile isSpace == dropSpace</span> <a name="line-862"></a><span class='hs-comment'>--</span> <a name="line-863"></a><span class='hs-definition'>dropSpace</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-864"></a><span class='hs-definition'>dropSpace</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inlinePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <a name="line-865"></a> <span class='hs-varid'>i</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>firstnonspace</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>l</span> <a name="line-866"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>i</span> <span class='hs-varop'>==</span> <span class='hs-varid'>l</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>empty</span> <span class='hs-keyword'>else</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-867"></a><span class='hs-comment'>{-# INLINE dropSpace #-}</span> <a name="line-868"></a> <a name="line-869"></a><a name="firstnonspace"></a><span class='hs-definition'>firstnonspace</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</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-conid'>IO</span> <span class='hs-conid'>Int</span> <a name="line-870"></a><span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>firstnonspace</span><span class='hs-layout'>)</span> <a name="line-871"></a><span class='hs-definition'>firstnonspace</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <span class='hs-varid'>m</span> <a name="line-872"></a> <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-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>n</span> <a name="line-873"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peekElemOff</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <a name="line-874"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>isSpaceWord8</span> <span class='hs-varid'>w</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>firstnonspace</span> <span class='hs-varid'>ptr</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'>m</span> <span class='hs-keyword'>else</span> <span class='hs-varid'>return</span> <span class='hs-varid'>n</span> <a name="line-875"></a> <a name="line-876"></a><span class='hs-comment'>{- <a name="line-877"></a>-- | 'dropSpaceEnd' efficiently returns the 'ByteString' argument with <a name="line-878"></a>-- white space removed from the end. I.e. <a name="line-879"></a>-- <a name="line-880"></a>-- > reverse . (dropWhile isSpace) . reverse == dropSpaceEnd <a name="line-881"></a>-- <a name="line-882"></a>-- but it is more efficient than using multiple reverses. <a name="line-883"></a>-- <a name="line-884"></a>dropSpaceEnd :: ByteString -> ByteString <a name="line-885"></a>dropSpaceEnd (PS x s l) = inlinePerformIO $ withForeignPtr x $ \p -> do <a name="line-886"></a> i <- lastnonspace (p `plusPtr` s) (l-1) <a name="line-887"></a> return $! if i == (-1) then empty else PS x s (i+1) <a name="line-888"></a>{-# INLINE dropSpaceEnd #-} <a name="line-889"></a> <a name="line-890"></a>lastnonspace :: Ptr Word8 -> Int -> IO Int <a name="line-891"></a>STRICT2(lastnonspace) <a name="line-892"></a>lastnonspace ptr n <a name="line-893"></a> | n < 0 = return n <a name="line-894"></a> | otherwise = do w <- peekElemOff ptr n <a name="line-895"></a> if isSpaceWord8 w then lastnonspace ptr (n-1) else return n <a name="line-896"></a>-}</span> <a name="line-897"></a> <a name="line-898"></a><a name="lines"></a><span class='hs-comment'>-- | 'lines' breaks a ByteString up into a list of ByteStrings at</span> <a name="line-899"></a><span class='hs-comment'>-- newline Chars. The resulting strings do not contain newlines.</span> <a name="line-900"></a><span class='hs-comment'>--</span> <a name="line-901"></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-902"></a><span class='hs-definition'>lines</span> <span class='hs-varid'>ps</span> <a name="line-903"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-904"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>search</span> <span class='hs-varid'>ps</span> <span class='hs-keyword'>of</span> <a name="line-905"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>ps</span><span class='hs-keyglyph'>]</span> <a name="line-906"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>take</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</span> <span class='hs-conop'>:</span> <span class='hs-varid'>lines</span> <span class='hs-layout'>(</span><span class='hs-varid'>drop</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'>ps</span><span class='hs-layout'>)</span> <a name="line-907"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>search</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>elemIndex</span> <span class='hs-chr'>'\n'</span> <a name="line-908"></a> <a name="line-909"></a><span class='hs-comment'>{- <a name="line-910"></a>-- Just as fast, but more complex. Should be much faster, I thought. <a name="line-911"></a>lines :: ByteString -> [ByteString] <a name="line-912"></a>lines (PS _ _ 0) = [] <a name="line-913"></a>lines (PS x s l) = inlinePerformIO $ withForeignPtr x $ \p -> do <a name="line-914"></a> let ptr = p `plusPtr` s <a name="line-915"></a> <a name="line-916"></a> STRICT1(loop) <a name="line-917"></a> loop n = do <a name="line-918"></a> let q = memchr (ptr `plusPtr` n) 0x0a (fromIntegral (l-n)) <a name="line-919"></a> if q == nullPtr <a name="line-920"></a> then return [PS x (s+n) (l-n)] <a name="line-921"></a> else do let i = q `minusPtr` ptr <a name="line-922"></a> ls <- loop (i+1) <a name="line-923"></a> return $! PS x (s+n) (i-n) : ls <a name="line-924"></a> loop 0 <a name="line-925"></a>-}</span> <a name="line-926"></a> <a name="line-927"></a><a name="unlines"></a><span class='hs-comment'>-- | 'unlines' is an inverse operation to 'lines'. It joins lines,</span> <a name="line-928"></a><span class='hs-comment'>-- after appending a terminating newline to each.</span> <a name="line-929"></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-930"></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-931"></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-932"></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-933"></a> <a name="line-934"></a><a name="words"></a><span class='hs-comment'>-- | 'words' breaks a ByteString up into a list of words, which</span> <a name="line-935"></a><span class='hs-comment'>-- were delimited by Chars representing white space.</span> <a name="line-936"></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-937"></a><span class='hs-definition'>words</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>P</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'>B</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'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>splitWith</span> <span class='hs-varid'>isSpaceWord8</span> <a name="line-938"></a><span class='hs-comment'>{-# INLINE words #-}</span> <a name="line-939"></a> <a name="line-940"></a><a name="unwords"></a><span class='hs-comment'>-- | The 'unwords' function is analogous to the 'unlines' function, on words.</span> <a name="line-941"></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-942"></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-943"></a><span class='hs-comment'>{-# INLINE unwords #-}</span> <a name="line-944"></a> <a name="line-945"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span> <a name="line-946"></a><span class='hs-comment'>-- Reading from ByteStrings</span> <a name="line-947"></a> <a name="line-948"></a><a name="readInt"></a><span class='hs-comment'>-- | readInt reads an Int from the beginning of the ByteString. If there is no</span> <a name="line-949"></a><span class='hs-comment'>-- integer at the beginning of the string, it returns Nothing, otherwise</span> <a name="line-950"></a><span class='hs-comment'>-- it just returns the int read, and the rest of the string.</span> <a name="line-951"></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-952"></a><span class='hs-definition'>readInt</span> <span class='hs-keyword'>as</span> <a name="line-953"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-keyword'>as</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-954"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <a name="line-955"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>unsafeHead</span> <span class='hs-keyword'>as</span> <span class='hs-keyword'>of</span> <a name="line-956"></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-keyword'>as</span><span class='hs-layout'>)</span> <a name="line-957"></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-keyword'>as</span><span class='hs-layout'>)</span> <a name="line-958"></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-keyword'>as</span> <a name="line-959"></a> <a name="line-960"></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> <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-961"></a> <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span> <a name="line-962"></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'>ps</span> <a name="line-963"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</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'>ps</span> <a name="line-964"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <a name="line-965"></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'>ps</span> <span class='hs-keyword'>of</span> <a name="line-966"></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-967"></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-968"></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-969"></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'>ps</span><span class='hs-layout'>)</span> <a name="line-970"></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'>ps</span> <a name="line-971"></a> <a name="line-972"></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-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-973"></a> <span class='hs-varid'>end</span> <span class='hs-conid'>True</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>negate</span> <span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <a name="line-974"></a> <span class='hs-varid'>end</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <a name="line-975"></a> <a name="line-976"></a><a name="readInteger"></a><span class='hs-comment'>-- | readInteger reads an Integer from the beginning of the ByteString. If</span> <a name="line-977"></a><span class='hs-comment'>-- there is no integer at the beginning of the string, it returns Nothing,</span> <a name="line-978"></a><span class='hs-comment'>-- otherwise it just returns the int read, and the rest of the string.</span> <a name="line-979"></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-980"></a><span class='hs-definition'>readInteger</span> <span class='hs-keyword'>as</span> <a name="line-981"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-keyword'>as</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-982"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <a name="line-983"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>unsafeHead</span> <span class='hs-keyword'>as</span> <span class='hs-keyword'>of</span> <a name="line-984"></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-keyword'>as</span><span class='hs-layout'>)</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'>bs</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'>bs</span><span class='hs-layout'>)</span> <a name="line-985"></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-keyword'>as</span><span class='hs-layout'>)</span> <a name="line-986"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>first</span> <span class='hs-keyword'>as</span> <a name="line-987"></a> <a name="line-988"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>first</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-989"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <a name="line-990"></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'>ps</span> <span class='hs-keyword'>of</span> <a name="line-991"></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-992"></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'>ps</span><span class='hs-layout'>)</span> <a name="line-993"></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-994"></a> <a name="line-995"></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-996"></a> <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-997"></a> <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span> <a name="line-998"></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'>ps</span> <a name="line-999"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</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'>empty</span> <a name="line-1000"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <a name="line-1001"></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'>ps</span> <span class='hs-keyword'>of</span> <a name="line-1002"></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-1003"></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-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-1004"></a> <span class='hs-layout'>(</span><span class='hs-varid'>toInteger</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-1005"></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'>ps</span><span class='hs-layout'>)</span> <a name="line-1006"></a> <span class='hs-keyword'>else</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-1007"></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-1008"></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'>ps</span><span class='hs-layout'>)</span> <a name="line-1009"></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'>ps</span> <a name="line-1010"></a> <a name="line-1011"></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'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>toInteger</span> <span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <a name="line-1012"></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'>ps</span> <span class='hs-keyglyph'>=</span> <a name="line-1013"></a> <span class='hs-layout'>(</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'>toInteger</span> <span class='hs-varid'>acc</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-1014"></a> <a name="line-1015"></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-1016"></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-1017"></a> <a name="line-1018"></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'>m</span><span class='hs-varop'>*</span><span class='hs-varid'>b</span> <span class='hs-varop'>+</span> <span class='hs-varid'>n</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-1019"></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-1020"></a> <a name="line-1021"></a><span class='hs-comment'>------------------------------------------------------------------------</span> <a name="line-1022"></a><span class='hs-comment'>-- For non-binary text processing:</span> <a name="line-1023"></a> <a name="line-1024"></a><a name="readFile"></a><span class='hs-comment'>-- | Read an entire file strictly into a 'ByteString'. This is far more</span> <a name="line-1025"></a><span class='hs-comment'>-- efficient than reading the characters into a 'String' and then using</span> <a name="line-1026"></a><span class='hs-comment'>-- 'pack'. It also may be more efficient than opening the file and</span> <a name="line-1027"></a><span class='hs-comment'>-- reading it using hGet.</span> <a name="line-1028"></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-1029"></a><span class='hs-definition'>readFile</span> <span class='hs-varid'>f</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'>ReadMode</span><span class='hs-layout'>)</span> <span class='hs-varid'>hClose</span> <a name="line-1030"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>h</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>hFileSize</span> <span class='hs-varid'>h</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>hGet</span> <span class='hs-varid'>h</span> <span class='hs-varop'>.</span> <span class='hs-varid'>fromIntegral</span><span class='hs-layout'>)</span> <a name="line-1031"></a> <a name="line-1032"></a><a name="writeFile"></a><span class='hs-comment'>-- | Write a 'ByteString' to a file.</span> <a name="line-1033"></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-1034"></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-1035"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>h</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-varid'>txt</span><span class='hs-layout'>)</span> <a name="line-1036"></a> <a name="line-1037"></a><a name="appendFile"></a><span class='hs-comment'>-- | Append a 'ByteString' to a file.</span> <a name="line-1038"></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-1039"></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-1040"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>h</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-varid'>txt</span><span class='hs-layout'>)</span> <a name="line-1041"></a> </pre></body> </html>