Sophie

Sophie

distrib > Fedora > 15 > i386 > by-pkgid > 554c54c7994a3d67056ff42d5bcc7052 > files > 57

ghc-bytestring-devel-0.9.1.10-16.fc15.i686.rpm

<?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.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,
<a name="line-5"></a>            NamedFieldPuns, BangPatterns, RecordWildCards -}</span>
<a name="line-6"></a><span class='hs-comment'>{-# OPTIONS_HADDOCK prune #-}</span>
<a name="line-7"></a>
<a name="line-8"></a><span class='hs-comment'>-- |</span>
<a name="line-9"></a><span class='hs-comment'>-- Module      : Data.ByteString</span>
<a name="line-10"></a><span class='hs-comment'>-- Copyright   : (c) The University of Glasgow 2001,</span>
<a name="line-11"></a><span class='hs-comment'>--               (c) David Roundy 2003-2005,</span>
<a name="line-12"></a><span class='hs-comment'>--               (c) Simon Marlow 2005</span>
<a name="line-13"></a><span class='hs-comment'>--               (c) Bjorn Bringert 2006</span>
<a name="line-14"></a><span class='hs-comment'>--               (c) Don Stewart 2005-2008</span>
<a name="line-15"></a><span class='hs-comment'>--</span>
<a name="line-16"></a><span class='hs-comment'>--               Array fusion code:</span>
<a name="line-17"></a><span class='hs-comment'>--               (c) 2001,2002 Manuel M T Chakravarty &amp; Gabriele Keller</span>
<a name="line-18"></a><span class='hs-comment'>--               (c) 2006      Manuel M T Chakravarty &amp; Roman Leshchinskiy</span>
<a name="line-19"></a><span class='hs-comment'>--</span>
<a name="line-20"></a><span class='hs-comment'>-- License     : BSD-style</span>
<a name="line-21"></a><span class='hs-comment'>--</span>
<a name="line-22"></a><span class='hs-comment'>-- Maintainer  : dons@cse.unsw.edu.au</span>
<a name="line-23"></a><span class='hs-comment'>-- Stability   : experimental</span>
<a name="line-24"></a><span class='hs-comment'>-- Portability : portable</span>
<a name="line-25"></a><span class='hs-comment'>-- </span>
<a name="line-26"></a><span class='hs-comment'>-- A time and space-efficient implementation of byte vectors using</span>
<a name="line-27"></a><span class='hs-comment'>-- packed Word8 arrays, suitable for high performance use, both in terms</span>
<a name="line-28"></a><span class='hs-comment'>-- of large data quantities, or high speed requirements. Byte vectors</span>
<a name="line-29"></a><span class='hs-comment'>-- are encoded as strict 'Word8' arrays of bytes, held in a 'ForeignPtr',</span>
<a name="line-30"></a><span class='hs-comment'>-- and can be passed between C and Haskell with little effort.</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'>-- &gt; import qualified Data.ByteString as B</span>
<a name="line-36"></a><span class='hs-comment'>--</span>
<a name="line-37"></a><span class='hs-comment'>-- Original GHC implementation by Bryan O\'Sullivan.</span>
<a name="line-38"></a><span class='hs-comment'>-- Rewritten to use 'Data.Array.Unboxed.UArray' by Simon Marlow.</span>
<a name="line-39"></a><span class='hs-comment'>-- Rewritten to support slices and use 'ForeignPtr' by David Roundy.</span>
<a name="line-40"></a><span class='hs-comment'>-- Polished and extended by Don Stewart.</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-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'>-- :: Word8   -&gt; ByteString</span>
<a name="line-51"></a>        <span class='hs-varid'>pack</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: [Word8] -&gt; ByteString</span>
<a name="line-52"></a>        <span class='hs-varid'>unpack</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: ByteString -&gt; [Word8]</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'>-- :: Word8 -&gt; ByteString -&gt; ByteString</span>
<a name="line-56"></a>        <span class='hs-varid'>snoc</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; Word8 -&gt; ByteString</span>
<a name="line-57"></a>        <span class='hs-varid'>append</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; ByteString</span>
<a name="line-58"></a>        <span class='hs-varid'>head</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; Word8</span>
<a name="line-59"></a>        <span class='hs-varid'>uncons</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: ByteString -&gt; Maybe (Word8, ByteString)</span>
<a name="line-60"></a>        <span class='hs-varid'>last</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; Word8</span>
<a name="line-61"></a>        <span class='hs-varid'>tail</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; ByteString</span>
<a name="line-62"></a>        <span class='hs-varid'>init</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; ByteString</span>
<a name="line-63"></a>        <span class='hs-varid'>null</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; Bool</span>
<a name="line-64"></a>        <span class='hs-varid'>length</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: ByteString -&gt; Int</span>
<a name="line-65"></a>
<a name="line-66"></a>        <span class='hs-comment'>-- * Transforming ByteStrings</span>
<a name="line-67"></a>        <span class='hs-varid'>map</span><span class='hs-layout'>,</span>                    <span class='hs-comment'>-- :: (Word8 -&gt; Word8) -&gt; ByteString -&gt; ByteString</span>
<a name="line-68"></a>        <span class='hs-varid'>reverse</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: ByteString -&gt; ByteString</span>
<a name="line-69"></a>        <span class='hs-varid'>intersperse</span><span class='hs-layout'>,</span>            <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; ByteString</span>
<a name="line-70"></a>        <span class='hs-varid'>intercalate</span><span class='hs-layout'>,</span>            <span class='hs-comment'>-- :: ByteString -&gt; [ByteString] -&gt; ByteString</span>
<a name="line-71"></a>        <span class='hs-varid'>transpose</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: [ByteString] -&gt; [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 -&gt; Word8 -&gt; a) -&gt; a -&gt; ByteString -&gt; a</span>
<a name="line-75"></a>        <span class='hs-varid'>foldl'</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (a -&gt; Word8 -&gt; a) -&gt; a -&gt; ByteString -&gt; a</span>
<a name="line-76"></a>        <span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; ByteString -&gt; Word8</span>
<a name="line-77"></a>        <span class='hs-varid'>foldl1'</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; ByteString -&gt; Word8</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'>-- :: (Word8 -&gt; a -&gt; a) -&gt; a -&gt; ByteString -&gt; a</span>
<a name="line-80"></a>        <span class='hs-varid'>foldr'</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (Word8 -&gt; a -&gt; a) -&gt; a -&gt; ByteString -&gt; a</span>
<a name="line-81"></a>        <span class='hs-varid'>foldr1</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; ByteString -&gt; Word8</span>
<a name="line-82"></a>        <span class='hs-varid'>foldr1'</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; ByteString -&gt; Word8</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] -&gt; ByteString</span>
<a name="line-86"></a>        <span class='hs-varid'>concatMap</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (Word8 -&gt; ByteString) -&gt; ByteString -&gt; ByteString</span>
<a name="line-87"></a>        <span class='hs-varid'>any</span><span class='hs-layout'>,</span>                    <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; Bool</span>
<a name="line-88"></a>        <span class='hs-varid'>all</span><span class='hs-layout'>,</span>                    <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; Bool</span>
<a name="line-89"></a>        <span class='hs-varid'>maximum</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: ByteString -&gt; Word8</span>
<a name="line-90"></a>        <span class='hs-varid'>minimum</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: ByteString -&gt; Word8</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'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; Word8 -&gt; ByteString -&gt; ByteString</span>
<a name="line-95"></a>        <span class='hs-varid'>scanl1</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; ByteString -&gt; ByteString</span>
<a name="line-96"></a>        <span class='hs-varid'>scanr</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; Word8 -&gt; ByteString -&gt; ByteString</span>
<a name="line-97"></a>        <span class='hs-varid'>scanr1</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Word8) -&gt; ByteString -&gt; 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 -&gt; Word8 -&gt; (acc, Word8)) -&gt; acc -&gt; ByteString -&gt; (acc, ByteString)</span>
<a name="line-101"></a>        <span class='hs-varid'>mapAccumR</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (acc -&gt; Word8 -&gt; (acc, Word8)) -&gt; acc -&gt; ByteString -&gt; (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 -&gt; Word8 -&gt; ByteString</span>
<a name="line-105"></a>        <span class='hs-varid'>unfoldr</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: (a -&gt; Maybe (Word8, a)) -&gt; a -&gt; ByteString</span>
<a name="line-106"></a>        <span class='hs-varid'>unfoldrN</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: Int -&gt; (a -&gt; Maybe (Word8, a)) -&gt; a -&gt; (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 -&gt; ByteString -&gt; ByteString</span>
<a name="line-112"></a>        <span class='hs-varid'>drop</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: Int -&gt; ByteString -&gt; ByteString</span>
<a name="line-113"></a>        <span class='hs-varid'>splitAt</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: Int -&gt; ByteString -&gt; (ByteString, ByteString)</span>
<a name="line-114"></a>        <span class='hs-varid'>takeWhile</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; ByteString</span>
<a name="line-115"></a>        <span class='hs-varid'>dropWhile</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; ByteString</span>
<a name="line-116"></a>        <span class='hs-varid'>span</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; (ByteString, ByteString)</span>
<a name="line-117"></a>        <span class='hs-varid'>spanEnd</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; (ByteString, ByteString)</span>
<a name="line-118"></a>        <span class='hs-varid'>break</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; (ByteString, ByteString)</span>
<a name="line-119"></a>        <span class='hs-varid'>breakEnd</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; (ByteString, ByteString)</span>
<a name="line-120"></a>        <span class='hs-varid'>group</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: ByteString -&gt; [ByteString]</span>
<a name="line-121"></a>        <span class='hs-varid'>groupBy</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; Bool) -&gt; ByteString -&gt; [ByteString]</span>
<a name="line-122"></a>        <span class='hs-varid'>inits</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: ByteString -&gt; [ByteString]</span>
<a name="line-123"></a>        <span class='hs-varid'>tails</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: ByteString -&gt; [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'>-- :: Word8 -&gt; ByteString -&gt; [ByteString]</span>
<a name="line-127"></a>        <span class='hs-varid'>splitWith</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; [ByteString]</span>
<a name="line-128"></a>
<a name="line-129"></a>        <span class='hs-comment'>-- * Predicates</span>
<a name="line-130"></a>        <span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span>             <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; Bool</span>
<a name="line-131"></a>        <span class='hs-varid'>isSuffixOf</span><span class='hs-layout'>,</span>             <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; Bool</span>
<a name="line-132"></a>        <span class='hs-varid'>isInfixOf</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; Bool</span>
<a name="line-133"></a>
<a name="line-134"></a>        <span class='hs-comment'>-- ** Search for arbitrary substrings</span>
<a name="line-135"></a>        <span class='hs-varid'>breakSubstring</span><span class='hs-layout'>,</span>         <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; (ByteString,ByteString)</span>
<a name="line-136"></a>        <span class='hs-varid'>findSubstring</span><span class='hs-layout'>,</span>          <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; Maybe Int</span>
<a name="line-137"></a>        <span class='hs-varid'>findSubstrings</span><span class='hs-layout'>,</span>         <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; [Int]</span>
<a name="line-138"></a>
<a name="line-139"></a>        <span class='hs-comment'>-- * Searching ByteStrings</span>
<a name="line-140"></a>
<a name="line-141"></a>        <span class='hs-comment'>-- ** Searching by equality</span>
<a name="line-142"></a>        <span class='hs-varid'>elem</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; Bool</span>
<a name="line-143"></a>        <span class='hs-varid'>notElem</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; Bool</span>
<a name="line-144"></a>
<a name="line-145"></a>        <span class='hs-comment'>-- ** Searching with a predicate</span>
<a name="line-146"></a>        <span class='hs-varid'>find</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; Maybe Word8</span>
<a name="line-147"></a>        <span class='hs-varid'>filter</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; ByteString</span>
<a name="line-148"></a>        <span class='hs-varid'>partition</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; (ByteString, ByteString)</span>
<a name="line-149"></a>
<a name="line-150"></a>        <span class='hs-comment'>-- * Indexing ByteStrings</span>
<a name="line-151"></a>        <span class='hs-varid'>index</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: ByteString -&gt; Int -&gt; Word8</span>
<a name="line-152"></a>        <span class='hs-varid'>elemIndex</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; Maybe Int</span>
<a name="line-153"></a>        <span class='hs-varid'>elemIndices</span><span class='hs-layout'>,</span>            <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; [Int]</span>
<a name="line-154"></a>        <span class='hs-varid'>elemIndexEnd</span><span class='hs-layout'>,</span>           <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; Maybe Int</span>
<a name="line-155"></a>        <span class='hs-varid'>findIndex</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; Maybe Int</span>
<a name="line-156"></a>        <span class='hs-varid'>findIndices</span><span class='hs-layout'>,</span>            <span class='hs-comment'>-- :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; [Int]</span>
<a name="line-157"></a>        <span class='hs-varid'>count</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: Word8 -&gt; ByteString -&gt; Int</span>
<a name="line-158"></a>
<a name="line-159"></a>        <span class='hs-comment'>-- * Zipping and unzipping ByteStrings</span>
<a name="line-160"></a>        <span class='hs-varid'>zip</span><span class='hs-layout'>,</span>                    <span class='hs-comment'>-- :: ByteString -&gt; ByteString -&gt; [(Word8,Word8)]</span>
<a name="line-161"></a>        <span class='hs-varid'>zipWith</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: (Word8 -&gt; Word8 -&gt; c) -&gt; ByteString -&gt; ByteString -&gt; [c]</span>
<a name="line-162"></a>        <span class='hs-varid'>unzip</span><span class='hs-layout'>,</span>                  <span class='hs-comment'>-- :: [(Word8,Word8)] -&gt; (ByteString,ByteString)</span>
<a name="line-163"></a>
<a name="line-164"></a>        <span class='hs-comment'>-- * Ordered ByteStrings</span>
<a name="line-165"></a>        <span class='hs-varid'>sort</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; ByteString</span>
<a name="line-166"></a>
<a name="line-167"></a>        <span class='hs-comment'>-- * Low level conversions</span>
<a name="line-168"></a>        <span class='hs-comment'>-- ** Copying ByteStrings</span>
<a name="line-169"></a>        <span class='hs-varid'>copy</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: ByteString -&gt; ByteString</span>
<a name="line-170"></a>
<a name="line-171"></a>        <span class='hs-comment'>-- ** Packing 'CString's and pointers</span>
<a name="line-172"></a>        <span class='hs-varid'>packCString</span><span class='hs-layout'>,</span>            <span class='hs-comment'>-- :: CString -&gt; IO ByteString</span>
<a name="line-173"></a>        <span class='hs-varid'>packCStringLen</span><span class='hs-layout'>,</span>         <span class='hs-comment'>-- :: CStringLen -&gt; IO ByteString</span>
<a name="line-174"></a>
<a name="line-175"></a>        <span class='hs-comment'>-- ** Using ByteStrings as 'CString's</span>
<a name="line-176"></a>        <span class='hs-varid'>useAsCString</span><span class='hs-layout'>,</span>           <span class='hs-comment'>-- :: ByteString -&gt; (CString    -&gt; IO a) -&gt; IO a</span>
<a name="line-177"></a>        <span class='hs-varid'>useAsCStringLen</span><span class='hs-layout'>,</span>        <span class='hs-comment'>-- :: ByteString -&gt; (CStringLen -&gt; IO a) -&gt; IO a</span>
<a name="line-178"></a>
<a name="line-179"></a>        <span class='hs-comment'>-- * I\/O with 'ByteString's</span>
<a name="line-180"></a>
<a name="line-181"></a>        <span class='hs-comment'>-- ** Standard input and output</span>
<a name="line-182"></a>        <span class='hs-varid'>getLine</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: IO ByteString</span>
<a name="line-183"></a>        <span class='hs-varid'>getContents</span><span class='hs-layout'>,</span>            <span class='hs-comment'>-- :: IO ByteString</span>
<a name="line-184"></a>        <span class='hs-varid'>putStr</span><span class='hs-layout'>,</span>                 <span class='hs-comment'>-- :: ByteString -&gt; IO ()</span>
<a name="line-185"></a>        <span class='hs-varid'>putStrLn</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: ByteString -&gt; IO ()</span>
<a name="line-186"></a>        <span class='hs-varid'>interact</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: (ByteString -&gt; ByteString) -&gt; IO ()</span>
<a name="line-187"></a>
<a name="line-188"></a>        <span class='hs-comment'>-- ** Files</span>
<a name="line-189"></a>        <span class='hs-varid'>readFile</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: FilePath -&gt; IO ByteString</span>
<a name="line-190"></a>        <span class='hs-varid'>writeFile</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: FilePath -&gt; ByteString -&gt; IO ()</span>
<a name="line-191"></a>        <span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span>             <span class='hs-comment'>-- :: FilePath -&gt; ByteString -&gt; IO ()</span>
<a name="line-192"></a>
<a name="line-193"></a>        <span class='hs-comment'>-- ** I\/O with Handles</span>
<a name="line-194"></a>        <span class='hs-varid'>hGetLine</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: Handle -&gt; IO ByteString</span>
<a name="line-195"></a>        <span class='hs-varid'>hGetContents</span><span class='hs-layout'>,</span>           <span class='hs-comment'>-- :: Handle -&gt; IO ByteString</span>
<a name="line-196"></a>        <span class='hs-varid'>hGet</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: Handle -&gt; Int -&gt; IO ByteString</span>
<a name="line-197"></a>        <span class='hs-varid'>hGetSome</span><span class='hs-layout'>,</span>               <span class='hs-comment'>-- :: Handle -&gt; Int -&gt; IO ByteString</span>
<a name="line-198"></a>        <span class='hs-varid'>hGetNonBlocking</span><span class='hs-layout'>,</span>        <span class='hs-comment'>-- :: Handle -&gt; Int -&gt; IO ByteString</span>
<a name="line-199"></a>        <span class='hs-varid'>hPut</span><span class='hs-layout'>,</span>                   <span class='hs-comment'>-- :: Handle -&gt; ByteString -&gt; IO ()</span>
<a name="line-200"></a>        <span class='hs-varid'>hPutStr</span><span class='hs-layout'>,</span>                <span class='hs-comment'>-- :: Handle -&gt; ByteString -&gt; IO ()</span>
<a name="line-201"></a>        <span class='hs-varid'>hPutStrLn</span><span class='hs-layout'>,</span>              <span class='hs-comment'>-- :: Handle -&gt; ByteString -&gt; IO ()</span>
<a name="line-202"></a>
<a name="line-203"></a>        <span class='hs-varid'>breakByte</span>
<a name="line-204"></a>
<a name="line-205"></a>  <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-206"></a>
<a name="line-207"></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-208"></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-209"></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-210"></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-211"></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'>maximum</span>
<a name="line-212"></a>                                <span class='hs-layout'>,</span><span class='hs-varid'>minimum</span><span class='hs-layout'>,</span><span class='hs-varid'>all</span><span class='hs-layout'>,</span><span class='hs-varid'>concatMap</span><span class='hs-layout'>,</span><span class='hs-varid'>foldl1</span><span class='hs-layout'>,</span><span class='hs-varid'>foldr1</span>
<a name="line-213"></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-214"></a>                                <span class='hs-layout'>,</span><span class='hs-varid'>readFile</span><span class='hs-layout'>,</span><span class='hs-varid'>writeFile</span><span class='hs-layout'>,</span><span class='hs-varid'>appendFile</span><span class='hs-layout'>,</span><span class='hs-varid'>replicate</span>
<a name="line-215"></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-216"></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-217"></a>
<a name="line-218"></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>
<a name="line-219"></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'>Unsafe</span>
<a name="line-220"></a>
<a name="line-221"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>List</span>
<a name="line-222"></a>
<a name="line-223"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Word</span>                <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span>
<a name="line-224"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Maybe</span>               <span class='hs-layout'>(</span><span class='hs-varid'>isJust</span><span class='hs-layout'>,</span> <span class='hs-varid'>listToMaybe</span><span class='hs-layout'>)</span>
<a name="line-225"></a>
<a name="line-226"></a><span class='hs-comment'>-- Control.Exception.assert not available in yhc or nhc</span>
<a name="line-227"></a><span class='hs-cpp'>#ifndef __NHC__</span>
<a name="line-228"></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'>finally</span><span class='hs-layout'>,</span> <span class='hs-varid'>bracket</span><span class='hs-layout'>,</span> <span class='hs-varid'>assert</span><span class='hs-layout'>)</span>
<a name="line-229"></a><span class='hs-cpp'>#else</span>
<a name="line-230"></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> <span class='hs-varid'>finally</span><span class='hs-layout'>)</span>
<a name="line-231"></a><span class='hs-cpp'>#endif</span>
<a name="line-232"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span>            <span class='hs-layout'>(</span><span class='hs-varid'>when</span><span class='hs-layout'>)</span>
<a name="line-233"></a>
<a name="line-234"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>C</span><span class='hs-varop'>.</span><span class='hs-conid'>String</span>         <span class='hs-layout'>(</span><span class='hs-conid'>CString</span><span class='hs-layout'>,</span> <span class='hs-conid'>CStringLen</span><span class='hs-layout'>)</span>
<a name="line-235"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>C</span><span class='hs-varop'>.</span><span class='hs-conid'>Types</span>          <span class='hs-layout'>(</span><span class='hs-conid'>CSize</span><span class='hs-layout'>)</span>
<a name="line-236"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>ForeignPtr</span>
<a name="line-237"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Marshal</span><span class='hs-varop'>.</span><span class='hs-conid'>Alloc</span>    <span class='hs-layout'>(</span><span class='hs-varid'>allocaBytes</span><span class='hs-layout'>,</span> <span class='hs-varid'>mallocBytes</span><span class='hs-layout'>,</span> <span class='hs-varid'>reallocBytes</span><span class='hs-layout'>,</span> <span class='hs-varid'>finalizerFree</span><span class='hs-layout'>)</span>
<a name="line-238"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Marshal</span><span class='hs-varop'>.</span><span class='hs-conid'>Array</span>    <span class='hs-layout'>(</span><span class='hs-varid'>allocaArray</span><span class='hs-layout'>)</span>
<a name="line-239"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Ptr</span>
<a name="line-240"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Storable</span>         <span class='hs-layout'>(</span><span class='hs-conid'>Storable</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-241"></a>
<a name="line-242"></a><span class='hs-comment'>-- hGetBuf and hPutBuf not available in yhc or nhc</span>
<a name="line-243"></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'>stdin</span><span class='hs-layout'>,</span><span class='hs-varid'>stdout</span><span class='hs-layout'>,</span><span class='hs-varid'>hClose</span><span class='hs-layout'>,</span><span class='hs-varid'>hFileSize</span>
<a name="line-244"></a>                                <span class='hs-layout'>,</span><span class='hs-varid'>hGetBuf</span><span class='hs-layout'>,</span><span class='hs-varid'>hPutBuf</span><span class='hs-layout'>,</span><span class='hs-varid'>openBinaryFile</span>
<a name="line-245"></a>                                <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-246"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Error</span>          <span class='hs-layout'>(</span><span class='hs-varid'>mkIOError</span><span class='hs-layout'>,</span> <span class='hs-varid'>illegalOperationErrorType</span><span class='hs-layout'>)</span>
<a name="line-247"></a>
<a name="line-248"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span>              <span class='hs-layout'>(</span><span class='hs-conid'>Monoid</span><span class='hs-layout'>,</span> <span class='hs-varid'>mempty</span><span class='hs-layout'>,</span> <span class='hs-varid'>mappend</span><span class='hs-layout'>,</span> <span class='hs-varid'>mconcat</span><span class='hs-layout'>)</span>
<a name="line-249"></a>
<a name="line-250"></a><span class='hs-cpp'>#if !defined(__GLASGOW_HASKELL__)</span>
<a name="line-251"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Unsafe</span>
<a name="line-252"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Environment</span>
<a name="line-253"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</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'>hGetLine</span><span class='hs-layout'>)</span>
<a name="line-254"></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'>hIsEOF</span><span class='hs-layout'>)</span>
<a name="line-255"></a><span class='hs-cpp'>#endif</span>
<a name="line-256"></a>
<a name="line-257"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span>
<a name="line-258"></a>
<a name="line-259"></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'>hGetBufNonBlocking</span><span class='hs-layout'>)</span>
<a name="line-260"></a>
<a name="line-261"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0)</span>
<a name="line-262"></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'>hGetBufSome</span><span class='hs-layout'>)</span>
<a name="line-263"></a><span class='hs-cpp'>#else</span>
<a name="line-264"></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'>hWaitForInput</span><span class='hs-layout'>,</span> <span class='hs-varid'>hIsEOF</span><span class='hs-layout'>)</span>
<a name="line-265"></a><span class='hs-cpp'>#endif</span>
<a name="line-266"></a>
<a name="line-267"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ &gt;= 611</span>
<a name="line-268"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>IORef</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'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Handle</span><span class='hs-varop'>.</span><span class='hs-conid'>Internals</span>
<a name="line-270"></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-varop'>.</span><span class='hs-conid'>Handle</span><span class='hs-varop'>.</span><span class='hs-conid'>Types</span>
<a name="line-271"></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-varop'>.</span><span class='hs-conid'>Buffer</span>
<a name="line-272"></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-varop'>.</span><span class='hs-conid'>BufferedIO</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>Buffered</span>
<a name="line-273"></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-varid'>hiding</span> <span class='hs-layout'>(</span><span class='hs-varid'>finally</span><span class='hs-layout'>)</span>
<a name="line-274"></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'>ord</span><span class='hs-layout'>)</span>
<a name="line-275"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Foreign</span><span class='hs-varop'>.</span><span class='hs-conid'>Marshal</span><span class='hs-varop'>.</span><span class='hs-conid'>Utils</span>    <span class='hs-layout'>(</span><span class='hs-varid'>copyBytes</span><span class='hs-layout'>)</span>
<a name="line-276"></a><span class='hs-cpp'>#else</span>
<a name="line-277"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Error</span>          <span class='hs-layout'>(</span><span class='hs-varid'>isEOFError</span><span class='hs-layout'>)</span>
<a name="line-278"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>IOBase</span>
<a name="line-279"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>Handle</span>
<a name="line-280"></a><span class='hs-cpp'>#endif</span>
<a name="line-281"></a>
<a name="line-282"></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'>Word</span><span class='hs-cpp'>#</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>+#</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>writeWord8OffAddr</span><span class='hs-cpp'>#</span><span class='hs-layout'>)</span>
<a name="line-283"></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-varid'>build</span><span class='hs-layout'>)</span>
<a name="line-284"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>GHC</span><span class='hs-varop'>.</span><span class='hs-conid'>Word</span> <span class='hs-varid'>hiding</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span>
<a name="line-285"></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-286"></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-287"></a>
<a name="line-288"></a><span class='hs-cpp'>#endif</span>
<a name="line-289"></a>
<a name="line-290"></a><span class='hs-comment'>-- An alternative to Control.Exception (assert) for nhc98</span>
<a name="line-291"></a><span class='hs-cpp'>#ifdef __NHC__</span>
<a name="line-292"></a>
<a name="line-293"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Handle</span><span class='hs-layout'>)</span>
<a name="line-294"></a>
<a name="line-295"></a><span class='hs-cpp'>#define assert  assertS "__FILE__ : __LINE__"</span>
<a name="line-296"></a><a name="assertS"></a><span class='hs-definition'>assertS</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-297"></a><span class='hs-definition'>assertS</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>True</span>  <span class='hs-keyglyph'>=</span> <span class='hs-varid'>id</span>
<a name="line-298"></a><span class='hs-definition'>assertS</span> <span class='hs-varid'>s</span> <span class='hs-conid'>False</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-layout'>(</span><span class='hs-str'>"assertion failed at "</span><span class='hs-varop'>++</span><span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-299"></a>
<a name="line-300"></a><a name="hWaitForInput"></a><span class='hs-comment'>-- An alternative to hWaitForInput</span>
<a name="line-301"></a><span class='hs-definition'>hWaitForInput</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-302"></a><span class='hs-definition'>hWaitForInput</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</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-cpp'>#endif</span>
<a name="line-304"></a>
<a name="line-305"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-306"></a><span class='hs-comment'>--</span>
<a name="line-307"></a><span class='hs-comment'>-- Useful macros, until we have bang patterns</span>
<a name="line-308"></a><span class='hs-comment'>--</span>
<a name="line-309"></a>
<a name="line-310"></a><span class='hs-cpp'>#define STRICT1(f) f a | a `seq` False = undefined</span>
<a name="line-311"></a><span class='hs-cpp'>#define STRICT2(f) f a b | a `seq` b `seq` False = undefined</span>
<a name="line-312"></a><span class='hs-cpp'>#define STRICT3(f) f a b c | a `seq` b `seq` c `seq` False = undefined</span>
<a name="line-313"></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-314"></a><span class='hs-cpp'>#define STRICT5(f) f a b c d e | a `seq` b `seq` c `seq` d `seq` e `seq` False = undefined</span>
<a name="line-315"></a>
<a name="line-316"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-317"></a>
<a name="line-318"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Eq</span>  <span class='hs-conid'>ByteString</span> <span class='hs-keyword'>where</span>
<a name="line-319"></a>    <span class='hs-layout'>(</span><span class='hs-varop'>==</span><span class='hs-layout'>)</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>eq</span>
<a name="line-320"></a>
<a name="line-321"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Ord</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyword'>where</span>
<a name="line-322"></a>    <span class='hs-varid'>compare</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>compareBytes</span>
<a name="line-323"></a>
<a name="line-324"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monoid</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyword'>where</span>
<a name="line-325"></a>    <span class='hs-varid'>mempty</span>  <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span>
<a name="line-326"></a>    <span class='hs-varid'>mappend</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>append</span>
<a name="line-327"></a>    <span class='hs-varid'>mconcat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span>
<a name="line-328"></a>
<a name="line-329"></a><a name="eq"></a><span class='hs-comment'>-- | /O(n)/ Equality on the 'ByteString' type.</span>
<a name="line-330"></a><span class='hs-definition'>eq</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-331"></a><span class='hs-definition'>eq</span> <span class='hs-varid'>a</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>p'</span> <span class='hs-varid'>s'</span> <span class='hs-varid'>l'</span><span class='hs-layout'>)</span>
<a name="line-332"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'>/=</span> <span class='hs-varid'>l'</span>            <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span>    <span class='hs-comment'>-- short cut on length</span>
<a name="line-333"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>==</span> <span class='hs-varid'>p'</span> <span class='hs-varop'>&amp;&amp;</span> <span class='hs-varid'>s</span> <span class='hs-varop'>==</span> <span class='hs-varid'>s'</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span>     <span class='hs-comment'>-- short cut for the same string</span>
<a name="line-334"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>          <span class='hs-keyglyph'>=</span> <span class='hs-varid'>compareBytes</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-varop'>==</span> <span class='hs-conid'>EQ</span>
<a name="line-335"></a><span class='hs-comment'>{-# INLINE eq #-}</span>
<a name="line-336"></a><span class='hs-comment'>-- ^ still needed</span>
<a name="line-337"></a>
<a name="line-338"></a><a name="compareBytes"></a><span class='hs-comment'>-- | /O(n)/ 'compareBytes' provides an 'Ordering' for 'ByteStrings' supporting slices. </span>
<a name="line-339"></a><span class='hs-definition'>compareBytes</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ordering</span>
<a name="line-340"></a><span class='hs-definition'>compareBytes</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x1</span> <span class='hs-varid'>s1</span> <span class='hs-varid'>l1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x2</span> <span class='hs-varid'>s2</span> <span class='hs-varid'>l2</span><span class='hs-layout'>)</span>
<a name="line-341"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l1</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>  <span class='hs-varop'>&amp;&amp;</span> <span class='hs-varid'>l2</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>               <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EQ</span>  <span class='hs-comment'>-- short cut for empty strings</span>
<a name="line-342"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>                         <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inlinePerformIO</span> <span class='hs-varop'>$</span>
<a name="line-343"></a>        <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x1</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p1</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-344"></a>        <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x2</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p2</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-345"></a>            <span class='hs-varid'>i</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>memcmp</span> <span class='hs-layout'>(</span><span class='hs-varid'>p1</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p2</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s2</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varop'>$</span> <span class='hs-varid'>min</span> <span class='hs-varid'>l1</span> <span class='hs-varid'>l2</span><span class='hs-layout'>)</span>
<a name="line-346"></a>            <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>i</span> <span class='hs-varop'>`compare`</span> <span class='hs-num'>0</span> <span class='hs-keyword'>of</span>
<a name="line-347"></a>                        <span class='hs-conid'>EQ</span>  <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>l1</span> <span class='hs-varop'>`compare`</span> <span class='hs-varid'>l2</span>
<a name="line-348"></a>                        <span class='hs-varid'>x</span>   <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>x</span>
<a name="line-349"></a>
<a name="line-350"></a><span class='hs-comment'>{-
<a name="line-351"></a>
<a name="line-352"></a>-- Pure Haskell version
<a name="line-353"></a>
<a name="line-354"></a>compareBytes (PS fp1 off1 len1) (PS fp2 off2 len2)
<a name="line-355"></a>--    | len1 == 0  &amp;&amp; len2 == 0                     = EQ  -- short cut for empty strings
<a name="line-356"></a>--    | fp1 == fp2 &amp;&amp; off1 == off2 &amp;&amp; len1 == len2  = EQ  -- short cut for the same string
<a name="line-357"></a>    | otherwise                                   = inlinePerformIO $
<a name="line-358"></a>    withForeignPtr fp1 $ \p1 -&gt;
<a name="line-359"></a>        withForeignPtr fp2 $ \p2 -&gt;
<a name="line-360"></a>            cmp (p1 `plusPtr` off1)
<a name="line-361"></a>                (p2 `plusPtr` off2) 0 len1 len2
<a name="line-362"></a>
<a name="line-363"></a>-- XXX todo.
<a name="line-364"></a>cmp :: Ptr Word8 -&gt; Ptr Word8 -&gt; Int -&gt; Int -&gt; Int-&gt; IO Ordering
<a name="line-365"></a>cmp p1 p2 n len1 len2
<a name="line-366"></a>      | n == len1 = if n == len2 then return EQ else return LT
<a name="line-367"></a>      | n == len2 = return GT
<a name="line-368"></a>      | otherwise = do
<a name="line-369"></a>          a &lt;- peekByteOff p1 n :: IO Word8
<a name="line-370"></a>          b &lt;- peekByteOff p2 n
<a name="line-371"></a>          case a `compare` b of
<a name="line-372"></a>                EQ -&gt; cmp p1 p2 (n+1) len1 len2
<a name="line-373"></a>                LT -&gt; return LT
<a name="line-374"></a>                GT -&gt; return GT
<a name="line-375"></a>-}</span>
<a name="line-376"></a>
<a name="line-377"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-378"></a><span class='hs-comment'>-- Introducing and eliminating 'ByteString's</span>
<a name="line-379"></a>
<a name="line-380"></a><a name="empty"></a><span class='hs-comment'>-- | /O(1)/ The empty 'ByteString'</span>
<a name="line-381"></a><span class='hs-definition'>empty</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span>
<a name="line-382"></a><span class='hs-definition'>empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>nullForeignPtr</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span>
<a name="line-383"></a>
<a name="line-384"></a><a name="singleton"></a><span class='hs-comment'>-- | /O(1)/ Convert a 'Word8' into a 'ByteString'</span>
<a name="line-385"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-386"></a><span class='hs-definition'>singleton</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeCreate</span> <span class='hs-num'>1</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>poke</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span>
<a name="line-387"></a><span class='hs-comment'>{-# INLINE [1] singleton #-}</span>
<a name="line-388"></a>
<a name="line-389"></a><span class='hs-comment'>-- Inline [1] for intercalate rule</span>
<a name="line-390"></a>
<a name="line-391"></a><span class='hs-comment'>--</span>
<a name="line-392"></a><span class='hs-comment'>-- XXX The use of unsafePerformIO in allocating functions (unsafeCreate) is critical!</span>
<a name="line-393"></a><span class='hs-comment'>--</span>
<a name="line-394"></a><span class='hs-comment'>-- Otherwise:</span>
<a name="line-395"></a><span class='hs-comment'>--</span>
<a name="line-396"></a><span class='hs-comment'>--  singleton 255 `compare` singleton 127</span>
<a name="line-397"></a><span class='hs-comment'>--</span>
<a name="line-398"></a><span class='hs-comment'>-- is compiled to:</span>
<a name="line-399"></a><span class='hs-comment'>--</span>
<a name="line-400"></a><span class='hs-comment'>--  case mallocByteString 2 of </span>
<a name="line-401"></a><span class='hs-comment'>--      ForeignPtr f internals -&gt; </span>
<a name="line-402"></a><span class='hs-comment'>--           case writeWord8OffAddr# f 0 255 of _ -&gt; </span>
<a name="line-403"></a><span class='hs-comment'>--           case writeWord8OffAddr# f 0 127 of _ -&gt;</span>
<a name="line-404"></a><span class='hs-comment'>--           case eqAddr# f f of </span>
<a name="line-405"></a><span class='hs-comment'>--                  False -&gt; case compare (GHC.Prim.plusAddr# f 0) </span>
<a name="line-406"></a><span class='hs-comment'>--                                        (GHC.Prim.plusAddr# f 0)</span>
<a name="line-407"></a><span class='hs-comment'>--</span>
<a name="line-408"></a><span class='hs-comment'>--</span>
<a name="line-409"></a>
<a name="line-410"></a><a name="pack"></a><span class='hs-comment'>-- | /O(n)/ Convert a '[Word8]' into a 'ByteString'. </span>
<a name="line-411"></a><span class='hs-comment'>--</span>
<a name="line-412"></a><span class='hs-comment'>-- For applications with large numbers of string literals, pack can be a</span>
<a name="line-413"></a><span class='hs-comment'>-- bottleneck. In such cases, consider using packAddress (GHC only).</span>
<a name="line-414"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Word8</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-415"></a>
<a name="line-416"></a><span class='hs-cpp'>#if !defined(__GLASGOW_HASKELL__)</span>
<a name="line-417"></a>
<a name="line-418"></a><span class='hs-definition'>pack</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</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'>-&gt;</span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>str</span>
<a name="line-419"></a>    <span class='hs-keyword'>where</span>
<a name="line-420"></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-421"></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-varid'>x</span> <span class='hs-varop'>&gt;&gt;</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> <span class='hs-comment'>-- less space than pokeElemOff</span>
<a name="line-422"></a>
<a name="line-423"></a><span class='hs-cpp'>#else /* hack away */</span>
<a name="line-424"></a>
<a name="line-425"></a><span class='hs-definition'>pack</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</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'>-&gt;</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-num'>0</span><span class='hs-cpp'>#</span> <span class='hs-varid'>str</span><span class='hs-layout'>)</span>
<a name="line-426"></a>    <span class='hs-keyword'>where</span>
<a name="line-427"></a>        <span class='hs-varid'>go</span> <span class='hs-keyword'>_</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-428"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span> <span class='hs-layout'>(</span><span class='hs-conid'>W8</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-varid'>i</span> <span class='hs-varid'>c</span> <span class='hs-varop'>&gt;&gt;</span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</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-cpp'>#</span><span class='hs-layout'>)</span> <span class='hs-varid'>cs</span>
<a name="line-429"></a>
<a name="line-430"></a>        <span class='hs-varid'>writeByte</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</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'>-&gt;</span>
<a name="line-431"></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-varid'>i</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'>-&gt;</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-432"></a>
<a name="line-433"></a><span class='hs-cpp'>#endif</span>
<a name="line-434"></a>
<a name="line-435"></a><a name="unpack"></a><span class='hs-comment'>-- | /O(n)/ Converts a 'ByteString' to a '[Word8]'.</span>
<a name="line-436"></a><span class='hs-definition'>unpack</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Word8</span><span class='hs-keyglyph'>]</span>
<a name="line-437"></a>
<a name="line-438"></a><span class='hs-cpp'>#if !defined(__GLASGOW_HASKELL__)</span>
<a name="line-439"></a>
<a name="line-440"></a><span class='hs-definition'>unpack</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span>  <span class='hs-keyword'>_</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-441"></a><span class='hs-definition'>unpack</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>ps</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'>ps</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-442"></a>        <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-varid'>s</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-num'>1</span><span class='hs-layout'>)</span> <span class='hs-conid'>[]</span>
<a name="line-443"></a>    <span class='hs-keyword'>where</span>
<a name="line-444"></a>        <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-445"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-num'>0</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>p</span>          <span class='hs-varop'>&gt;&gt;=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-conop'>:</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span>
<a name="line-446"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>n</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;&gt;=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-conop'>:</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span>
<a name="line-447"></a><span class='hs-comment'>{-# INLINE unpack #-}</span>
<a name="line-448"></a>
<a name="line-449"></a><span class='hs-cpp'>#else</span>
<a name="line-450"></a>
<a name="line-451"></a><span class='hs-definition'>unpack</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>build</span> <span class='hs-layout'>(</span><span class='hs-varid'>unpackFoldr</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-452"></a><span class='hs-comment'>{-# INLINE unpack #-}</span>
<a name="line-453"></a>
<a name="line-454"></a><a name="unpackFoldr"></a><span class='hs-comment'>--</span>
<a name="line-455"></a><span class='hs-comment'>-- Have unpack fuse with good list consumers</span>
<a name="line-456"></a><span class='hs-comment'>--</span>
<a name="line-457"></a><span class='hs-comment'>-- critical this isn't strict in the acc</span>
<a name="line-458"></a><span class='hs-comment'>-- as it will break in the presence of list fusion. this is a known</span>
<a name="line-459"></a><span class='hs-comment'>-- issue with seq and build/foldr rewrite rules, which rely on lazy</span>
<a name="line-460"></a><span class='hs-comment'>-- demanding to avoid bottoms in the list.</span>
<a name="line-461"></a><span class='hs-comment'>--</span>
<a name="line-462"></a><span class='hs-definition'>unpackFoldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-463"></a><span class='hs-definition'>unpackFoldr</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ch</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>withPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-464"></a>    <span class='hs-keyword'>let</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span>    <span class='hs-keyword'>_</span>   <span class='hs-keyglyph'>|</span> <span class='hs-varid'>q</span> <span class='hs-varop'>`seq`</span> <span class='hs-varid'>n</span> <span class='hs-varop'>`seq`</span> <span class='hs-conid'>False</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>undefined</span> <span class='hs-comment'>-- n.b.</span>
<a name="line-465"></a>        <span class='hs-varid'>loop</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>acc</span>
<a name="line-466"></a>        <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span>    <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-467"></a>           <span class='hs-varid'>a</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span>
<a name="line-468"></a>           <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`f`</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span>
<a name="line-469"></a>    <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>ch</span>
<a name="line-470"></a><span class='hs-comment'>{-# INLINE [0] unpackFoldr #-}</span>
<a name="line-471"></a>
<a name="line-472"></a><a name="unpackList"></a><span class='hs-definition'>unpackList</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Word8</span><span class='hs-keyglyph'>]</span>
<a name="line-473"></a><span class='hs-definition'>unpackList</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>withPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-474"></a>    <span class='hs-keyword'>let</span> <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-475"></a>        <span class='hs-varid'>loop</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>acc</span>
<a name="line-476"></a>        <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-477"></a>           <span class='hs-varid'>a</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span>
<a name="line-478"></a>           <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-conop'>:</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span>
<a name="line-479"></a>    <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-conid'>[]</span>
<a name="line-480"></a>
<a name="line-481"></a><span class='hs-comment'>{-# RULES
<a name="line-482"></a>"ByteString unpack-list" [1]  forall p  .
<a name="line-483"></a>    unpackFoldr p (:) [] = unpackList p
<a name="line-484"></a> #-}</span>
<a name="line-485"></a>
<a name="line-486"></a><span class='hs-cpp'>#endif</span>
<a name="line-487"></a>
<a name="line-488"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-489"></a><span class='hs-comment'>-- Basic interface</span>
<a name="line-490"></a>
<a name="line-491"></a><a name="null"></a><span class='hs-comment'>-- | /O(1)/ Test whether a ByteString is empty.</span>
<a name="line-492"></a><span class='hs-definition'>null</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-493"></a><span class='hs-definition'>null</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>assert</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span> <span class='hs-varop'>&gt;=</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>l</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>
<a name="line-494"></a><span class='hs-comment'>{-# INLINE null #-}</span>
<a name="line-495"></a>
<a name="line-496"></a><a name="length"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-497"></a><span class='hs-comment'>-- | /O(1)/ 'length' returns the length of a ByteString as an 'Int'.</span>
<a name="line-498"></a><span class='hs-definition'>length</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span>
<a name="line-499"></a><span class='hs-definition'>length</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>assert</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span> <span class='hs-varop'>&gt;=</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>l</span>
<a name="line-500"></a><span class='hs-comment'>{-# INLINE length #-}</span>
<a name="line-501"></a>
<a name="line-502"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-503"></a>
<a name="line-504"></a><a name="cons"></a><span class='hs-comment'>-- | /O(n)/ 'cons' is analogous to (:) for lists, but of different</span>
<a name="line-505"></a><span class='hs-comment'>-- complexity, as it requires a memcpy.</span>
<a name="line-506"></a><span class='hs-definition'>cons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-507"></a><span class='hs-definition'>cons</span> <span class='hs-varid'>c</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'>unsafeCreate</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-varop'>+</span><span class='hs-num'>1</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'>-&gt;</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-508"></a>        <span class='hs-varid'>poke</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span>
<a name="line-509"></a>        <span class='hs-varid'>memcpy</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-510"></a><span class='hs-comment'>{-# INLINE cons #-}</span>
<a name="line-511"></a>
<a name="line-512"></a><a name="snoc"></a><span class='hs-comment'>-- | /O(n)/ Append a byte to the end of a 'ByteString'</span>
<a name="line-513"></a><span class='hs-definition'>snoc</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-514"></a><span class='hs-definition'>snoc</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'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeCreate</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-varop'>+</span><span class='hs-num'>1</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'>-&gt;</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-515"></a>        <span class='hs-varid'>memcpy</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-516"></a>        <span class='hs-varid'>poke</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span>
<a name="line-517"></a><span class='hs-comment'>{-# INLINE snoc #-}</span>
<a name="line-518"></a>
<a name="line-519"></a><span class='hs-comment'>-- todo fuse</span>
<a name="line-520"></a>
<a name="line-521"></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-522"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-523"></a><span class='hs-definition'>head</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-524"></a><span class='hs-definition'>head</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-525"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"head"</span>
<a name="line-526"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</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'>-&gt;</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span>
<a name="line-527"></a><span class='hs-comment'>{-# INLINE head #-}</span>
<a name="line-528"></a>
<a name="line-529"></a><a name="tail"></a><span class='hs-comment'>-- | /O(1)/ Extract the elements after the head of a ByteString, which must be non-empty.</span>
<a name="line-530"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-531"></a><span class='hs-definition'>tail</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-532"></a><span class='hs-definition'>tail</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-533"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"tail"</span>
<a name="line-534"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-num'>1</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-num'>1</span><span class='hs-layout'>)</span>
<a name="line-535"></a><span class='hs-comment'>{-# INLINE tail #-}</span>
<a name="line-536"></a>
<a name="line-537"></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-538"></a><span class='hs-comment'>-- if it is empty.</span>
<a name="line-539"></a><span class='hs-definition'>uncons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span>
<a name="line-540"></a><span class='hs-definition'>uncons</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-541"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span>
<a name="line-542"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>inlinePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span>
<a name="line-543"></a>                                        <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span><span class='hs-layout'>,</span>
<a name="line-544"></a>                        <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-num'>1</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-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-545"></a><span class='hs-comment'>{-# INLINE uncons #-}</span>
<a name="line-546"></a>
<a name="line-547"></a><a name="last"></a><span class='hs-comment'>-- | /O(1)/ Extract the last element of a ByteString, which must be finite and non-empty.</span>
<a name="line-548"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-549"></a><span class='hs-definition'>last</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-550"></a><span class='hs-definition'>last</span> <span class='hs-varid'>ps</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>
<a name="line-551"></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'>errorEmptyList</span> <span class='hs-str'>"last"</span>
<a name="line-552"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</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'>-&gt;</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-553"></a><span class='hs-comment'>{-# INLINE last #-}</span>
<a name="line-554"></a>
<a name="line-555"></a><a name="init"></a><span class='hs-comment'>-- | /O(1)/ Return all the elements of a 'ByteString' except the last one.</span>
<a name="line-556"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-557"></a><span class='hs-definition'>init</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-558"></a><span class='hs-definition'>init</span> <span class='hs-varid'>ps</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-559"></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'>errorEmptyList</span> <span class='hs-str'>"init"</span>
<a name="line-560"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-561"></a><span class='hs-comment'>{-# INLINE init #-}</span>
<a name="line-562"></a>
<a name="line-563"></a><a name="append"></a><span class='hs-comment'>-- | /O(n)/ Append two ByteStrings</span>
<a name="line-564"></a><span class='hs-definition'>append</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-565"></a><span class='hs-definition'>append</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>xs</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ys</span>
<a name="line-566"></a>             <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ys</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>xs</span>
<a name="line-567"></a>             <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>xs</span><span class='hs-layout'>,</span><span class='hs-varid'>ys</span><span class='hs-keyglyph'>]</span>
<a name="line-568"></a><span class='hs-comment'>{-# INLINE append #-}</span>
<a name="line-569"></a>
<a name="line-570"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-571"></a><span class='hs-comment'>-- Transformations</span>
<a name="line-572"></a>
<a name="line-573"></a><a name="map"></a><span class='hs-comment'>-- | /O(n)/ 'map' @f xs@ is the ByteString obtained by applying @f@ to each</span>
<a name="line-574"></a><span class='hs-comment'>-- element of @xs@. This function is subject to array fusion.</span>
<a name="line-575"></a><span class='hs-definition'>map</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-576"></a><span class='hs-definition'>map</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>s</span> <span class='hs-varid'>len</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'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-577"></a>    <span class='hs-varid'>create</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map_</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-578"></a>  <span class='hs-keyword'>where</span>
<a name="line-579"></a>    <span class='hs-varid'>map_</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-580"></a>    <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>map_</span><span class='hs-layout'>)</span>
<a name="line-581"></a>    <span class='hs-varid'>map_</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>p2</span>
<a name="line-582"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-583"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-584"></a>            <span class='hs-varid'>x</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>n</span>
<a name="line-585"></a>            <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>p2</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span>
<a name="line-586"></a>            <span class='hs-varid'>map_</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'>p1</span> <span class='hs-varid'>p2</span>
<a name="line-587"></a><span class='hs-comment'>{-# INLINE map #-}</span>
<a name="line-588"></a>
<a name="line-589"></a><a name="reverse"></a><span class='hs-comment'>-- | /O(n)/ 'reverse' @xs@ efficiently returns the elements of @xs@ in reverse order.</span>
<a name="line-590"></a><span class='hs-definition'>reverse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-591"></a><span class='hs-definition'>reverse</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'>unsafeCreate</span> <span class='hs-varid'>l</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-592"></a>        <span class='hs-varid'>c_reverse</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-593"></a>
<a name="line-594"></a><a name="intersperse"></a><span class='hs-comment'>-- | /O(n)/ The 'intersperse' function takes a 'Word8' and a</span>
<a name="line-595"></a><span class='hs-comment'>-- 'ByteString' and \`intersperses\' that byte between the elements of</span>
<a name="line-596"></a><span class='hs-comment'>-- the 'ByteString'.  It is analogous to the intersperse function on</span>
<a name="line-597"></a><span class='hs-comment'>-- Lists.</span>
<a name="line-598"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-599"></a><span class='hs-definition'>intersperse</span> <span class='hs-varid'>c</span> <span class='hs-varid'>ps</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>
<a name="line-600"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>length</span> <span class='hs-varid'>ps</span> <span class='hs-varop'>&lt;</span> <span class='hs-num'>2</span>  <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ps</span>
<a name="line-601"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>      <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeCreate</span> <span class='hs-layout'>(</span><span class='hs-num'>2</span><span class='hs-varop'>*</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-num'>1</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'>-&gt;</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-602"></a>        <span class='hs-varid'>c_intersperse</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span>
<a name="line-603"></a>
<a name="line-604"></a><a name="transpose"></a><span class='hs-comment'>-- | The 'transpose' function transposes the rows and columns of its</span>
<a name="line-605"></a><span class='hs-comment'>-- 'ByteString' argument.</span>
<a name="line-606"></a><span class='hs-definition'>transpose</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-607"></a><span class='hs-definition'>transpose</span> <span class='hs-varid'>ps</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'>pack</span> <span class='hs-layout'>(</span><span class='hs-conid'>List</span><span class='hs-varop'>.</span><span class='hs-varid'>transpose</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'>unpack</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-608"></a>
<a name="line-609"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-610"></a><span class='hs-comment'>-- Reducing 'ByteString's</span>
<a name="line-611"></a>
<a name="line-612"></a><a name="foldl"></a><span class='hs-comment'>-- | 'foldl', applied to a binary operator, a starting value (typically</span>
<a name="line-613"></a><span class='hs-comment'>-- the left-identity of the operator), and a ByteString, reduces the</span>
<a name="line-614"></a><span class='hs-comment'>-- ByteString using the binary operator, from left to right.</span>
<a name="line-615"></a><span class='hs-comment'>--</span>
<a name="line-616"></a><span class='hs-comment'>-- This function is subject to array fusion.</span>
<a name="line-617"></a><span class='hs-comment'>--</span>
<a name="line-618"></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'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-619"></a><span class='hs-definition'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>v</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'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-620"></a>        <span class='hs-varid'>lgo</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-621"></a>    <span class='hs-keyword'>where</span>
<a name="line-622"></a>        <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>lgo</span><span class='hs-layout'>)</span>
<a name="line-623"></a>        <span class='hs-varid'>lgo</span> <span class='hs-varid'>z</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>==</span> <span class='hs-varid'>q</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>z</span>
<a name="line-624"></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'>c</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>p</span>
<a name="line-625"></a>                                   <span class='hs-varid'>lgo</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>q</span>
<a name="line-626"></a><span class='hs-comment'>{-# INLINE foldl #-}</span>
<a name="line-627"></a>
<a name="line-628"></a><a name="foldl'"></a><span class='hs-comment'>-- | 'foldl\'' is like 'foldl', but strict in the accumulator.</span>
<a name="line-629"></a><span class='hs-comment'>-- However, for ByteStrings, all left folds are strict in the accumulator.</span>
<a name="line-630"></a><span class='hs-comment'>--</span>
<a name="line-631"></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'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-632"></a><span class='hs-definition'>foldl'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldl</span>
<a name="line-633"></a><span class='hs-comment'>{-# INLINE foldl' #-}</span>
<a name="line-634"></a>
<a name="line-635"></a><a name="foldr"></a><span class='hs-comment'>-- | 'foldr', applied to a binary operator, a starting value</span>
<a name="line-636"></a><span class='hs-comment'>-- (typically the right-identity of the operator), and a ByteString,</span>
<a name="line-637"></a><span class='hs-comment'>-- reduces the ByteString using the binary operator, from right to left.</span>
<a name="line-638"></a><span class='hs-definition'>foldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-639"></a><span class='hs-definition'>foldr</span> <span class='hs-varid'>k</span> <span class='hs-varid'>v</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'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-640"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-641"></a>    <span class='hs-keyword'>where</span>
<a name="line-642"></a>        <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-643"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>z</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>==</span> <span class='hs-varid'>q</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>z</span>
<a name="line-644"></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'>c</span>  <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>p</span>
<a name="line-645"></a>                                  <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-varop'>`k`</span> <span class='hs-varid'>z</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>q</span> <span class='hs-comment'>-- tail recursive</span>
<a name="line-646"></a><span class='hs-comment'>{-# INLINE foldr #-}</span>
<a name="line-647"></a>
<a name="line-648"></a><a name="foldr'"></a><span class='hs-comment'>-- | 'foldr\'' is like 'foldr', but strict in the accumulator.</span>
<a name="line-649"></a><span class='hs-definition'>foldr'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-650"></a><span class='hs-definition'>foldr'</span> <span class='hs-varid'>k</span> <span class='hs-varid'>v</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'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-651"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-652"></a>    <span class='hs-keyword'>where</span>
<a name="line-653"></a>        <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-654"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>z</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>==</span> <span class='hs-varid'>q</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>z</span>
<a name="line-655"></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'>c</span>  <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>p</span>
<a name="line-656"></a>                                  <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-varop'>`k`</span> <span class='hs-varid'>z</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varid'>q</span> <span class='hs-comment'>-- tail recursive</span>
<a name="line-657"></a><span class='hs-comment'>{-# INLINE foldr' #-}</span>
<a name="line-658"></a>
<a name="line-659"></a><a name="foldl1"></a><span class='hs-comment'>-- | 'foldl1' is a variant of 'foldl' that has no starting value</span>
<a name="line-660"></a><span class='hs-comment'>-- argument, and thus must be applied to non-empty 'ByteStrings'.</span>
<a name="line-661"></a><span class='hs-comment'>-- This function is subject to array fusion. </span>
<a name="line-662"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-663"></a><span class='hs-definition'>foldl1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-664"></a><span class='hs-definition'>foldl1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span>
<a name="line-665"></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'>errorEmptyList</span> <span class='hs-str'>"foldl1"</span>
<a name="line-666"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-667"></a><span class='hs-comment'>{-# INLINE foldl1 #-}</span>
<a name="line-668"></a>
<a name="line-669"></a><a name="foldl1'"></a><span class='hs-comment'>-- | 'foldl1\'' is like 'foldl1', but strict in the accumulator.</span>
<a name="line-670"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-671"></a><span class='hs-definition'>foldl1'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-672"></a><span class='hs-definition'>foldl1'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span>
<a name="line-673"></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'>errorEmptyList</span> <span class='hs-str'>"foldl1'"</span>
<a name="line-674"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldl'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-675"></a><span class='hs-comment'>{-# INLINE foldl1' #-}</span>
<a name="line-676"></a>
<a name="line-677"></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-678"></a><span class='hs-comment'>-- and thus must be applied to non-empty 'ByteString's</span>
<a name="line-679"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-680"></a><span class='hs-definition'>foldr1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-681"></a><span class='hs-definition'>foldr1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span>
<a name="line-682"></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'>errorEmptyList</span> <span class='hs-str'>"foldr1"</span>
<a name="line-683"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>      <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldr</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>last</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>init</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-684"></a><span class='hs-comment'>{-# INLINE foldr1 #-}</span>
<a name="line-685"></a>
<a name="line-686"></a><a name="foldr1'"></a><span class='hs-comment'>-- | 'foldr1\'' is a variant of 'foldr1', but is strict in the</span>
<a name="line-687"></a><span class='hs-comment'>-- accumulator.</span>
<a name="line-688"></a><span class='hs-definition'>foldr1'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-689"></a><span class='hs-definition'>foldr1'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span>
<a name="line-690"></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'>errorEmptyList</span> <span class='hs-str'>"foldr1"</span>
<a name="line-691"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>      <span class='hs-keyglyph'>=</span> <span class='hs-varid'>foldr'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>last</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>init</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-692"></a><span class='hs-comment'>{-# INLINE foldr1' #-}</span>
<a name="line-693"></a>
<a name="line-694"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-695"></a><span class='hs-comment'>-- Special folds</span>
<a name="line-696"></a>
<a name="line-697"></a><a name="concat"></a><span class='hs-comment'>-- | /O(n)/ Concatenate a list of ByteStrings.</span>
<a name="line-698"></a><span class='hs-definition'>concat</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-699"></a><span class='hs-definition'>concat</span> <span class='hs-conid'>[]</span>     <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span>
<a name="line-700"></a><span class='hs-definition'>concat</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>ps</span><span class='hs-keyglyph'>]</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ps</span>
<a name="line-701"></a><span class='hs-definition'>concat</span> <span class='hs-varid'>xs</span>     <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeCreate</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>ptr</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>go</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>ptr</span>
<a name="line-702"></a>  <span class='hs-keyword'>where</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>sum</span> <span class='hs-varop'>.</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>length</span> <span class='hs-varop'>$</span> <span class='hs-varid'>xs</span>
<a name="line-703"></a>        <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-704"></a>        <span class='hs-varid'>go</span> <span class='hs-conid'>[]</span>            <span class='hs-keyword'>_</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-705"></a>        <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-conop'>:</span><span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-varid'>ptr</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-706"></a>                <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>p</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>fp</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>memcpy</span> <span class='hs-varid'>ptr</span> <span class='hs-layout'>(</span><span class='hs-varid'>fp</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-707"></a>                <span class='hs-varid'>go</span> <span class='hs-varid'>ps</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-708"></a>
<a name="line-709"></a><a name="concatMap"></a><span class='hs-comment'>-- | Map a function over a 'ByteString' and concatenate the results</span>
<a name="line-710"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-711"></a><span class='hs-definition'>concatMap</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>foldr</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conop'>:</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-conid'>[]</span>
<a name="line-712"></a>
<a name="line-713"></a><span class='hs-comment'>-- foldr (append . f) empty</span>
<a name="line-714"></a>
<a name="line-715"></a><a name="any"></a><span class='hs-comment'>-- | /O(n)/ Applied to a predicate and a ByteString, 'any' determines if</span>
<a name="line-716"></a><span class='hs-comment'>-- any element of the 'ByteString' satisfies the predicate.</span>
<a name="line-717"></a><span class='hs-definition'>any</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-718"></a><span class='hs-definition'>any</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span>
<a name="line-719"></a><span class='hs-definition'>any</span> <span class='hs-varid'>f</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'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-720"></a>        <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-721"></a>    <span class='hs-keyword'>where</span>
<a name="line-722"></a>        <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-723"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>==</span> <span class='hs-varid'>q</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>False</span>
<a name="line-724"></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'>c</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>p</span>
<a name="line-725"></a>                                <span class='hs-keyword'>if</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-conid'>True</span>
<a name="line-726"></a>                                       <span class='hs-keyword'>else</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'>q</span>
<a name="line-727"></a><span class='hs-comment'>{-# INLINE any #-}</span>
<a name="line-728"></a>
<a name="line-729"></a><span class='hs-comment'>-- todo fuse</span>
<a name="line-730"></a>
<a name="line-731"></a><a name="all"></a><span class='hs-comment'>-- | /O(n)/ Applied to a predicate and a 'ByteString', 'all' determines</span>
<a name="line-732"></a><span class='hs-comment'>-- if all elements of the 'ByteString' satisfy the predicate.</span>
<a name="line-733"></a><span class='hs-definition'>all</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-734"></a><span class='hs-definition'>all</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span>
<a name="line-735"></a><span class='hs-definition'>all</span> <span class='hs-varid'>f</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'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-736"></a>        <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-737"></a>    <span class='hs-keyword'>where</span>
<a name="line-738"></a>        <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-739"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>==</span> <span class='hs-varid'>q</span>     <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>True</span>  <span class='hs-comment'>-- end of list</span>
<a name="line-740"></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'>c</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>p</span>
<a name="line-741"></a>                                 <span class='hs-keyword'>if</span> <span class='hs-varid'>f</span> <span class='hs-varid'>c</span>
<a name="line-742"></a>                                    <span class='hs-keyword'>then</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'>q</span>
<a name="line-743"></a>                                    <span class='hs-keyword'>else</span> <span class='hs-varid'>return</span> <span class='hs-conid'>False</span>
<a name="line-744"></a><span class='hs-comment'>{-# INLINE all #-}</span>
<a name="line-745"></a>
<a name="line-746"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-747"></a>
<a name="line-748"></a><a name="maximum"></a><span class='hs-comment'>-- | /O(n)/ 'maximum' returns the maximum value from a 'ByteString'</span>
<a name="line-749"></a><span class='hs-comment'>-- This function will fuse.</span>
<a name="line-750"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-751"></a><span class='hs-definition'>maximum</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-752"></a><span class='hs-definition'>maximum</span> <span class='hs-varid'>xs</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>
<a name="line-753"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>xs</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"maximum"</span>
<a name="line-754"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</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'>-&gt;</span>
<a name="line-755"></a>                      <span class='hs-varid'>c_maximum</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-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-756"></a><span class='hs-comment'>{-# INLINE maximum #-}</span>
<a name="line-757"></a>
<a name="line-758"></a><a name="minimum"></a><span class='hs-comment'>-- | /O(n)/ 'minimum' returns the minimum value from a 'ByteString'</span>
<a name="line-759"></a><span class='hs-comment'>-- This function will fuse.</span>
<a name="line-760"></a><span class='hs-comment'>-- An exception will be thrown in the case of an empty ByteString.</span>
<a name="line-761"></a><span class='hs-definition'>minimum</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-762"></a><span class='hs-definition'>minimum</span> <span class='hs-varid'>xs</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>
<a name="line-763"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>xs</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>errorEmptyList</span> <span class='hs-str'>"minimum"</span>
<a name="line-764"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</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'>-&gt;</span>
<a name="line-765"></a>                      <span class='hs-varid'>c_minimum</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-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-766"></a><span class='hs-comment'>{-# INLINE minimum #-}</span>
<a name="line-767"></a>
<a name="line-768"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-769"></a>
<a name="line-770"></a><a name="mapAccumL"></a><span class='hs-comment'>-- | The 'mapAccumL' function behaves like a combination of 'map' and</span>
<a name="line-771"></a><span class='hs-comment'>-- 'foldl'; it applies a function to each element of a ByteString,</span>
<a name="line-772"></a><span class='hs-comment'>-- passing an accumulating parameter from left to right, and returning a</span>
<a name="line-773"></a><span class='hs-comment'>-- final value of this accumulator together with the new list.</span>
<a name="line-774"></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'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-775"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>o</span> <span class='hs-varid'>len</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'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-776"></a>    <span class='hs-varid'>gp</span>   <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>mallocByteString</span> <span class='hs-varid'>len</span>
<a name="line-777"></a>    <span class='hs-varid'>acc'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>gp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>mapAccumL_</span> <span class='hs-varid'>acc</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>o</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span>
<a name="line-778"></a>    <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc'</span><span class='hs-layout'>,</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>gp</span> <span class='hs-num'>0</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-779"></a>  <span class='hs-keyword'>where</span>
<a name="line-780"></a>    <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>mapAccumL_</span><span class='hs-layout'>)</span>
<a name="line-781"></a>    <span class='hs-varid'>mapAccumL_</span> <span class='hs-varid'>s</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>p2</span>
<a name="line-782"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>s</span>
<a name="line-783"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-784"></a>            <span class='hs-varid'>x</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>n</span>
<a name="line-785"></a>            <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>s'</span><span class='hs-layout'>,</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-varid'>x</span>
<a name="line-786"></a>            <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>p2</span> <span class='hs-varid'>n</span> <span class='hs-varid'>y</span>
<a name="line-787"></a>            <span class='hs-varid'>mapAccumL_</span> <span class='hs-varid'>s'</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'>p1</span> <span class='hs-varid'>p2</span>
<a name="line-788"></a><span class='hs-comment'>{-# INLINE mapAccumL #-}</span>
<a name="line-789"></a>
<a name="line-790"></a><a name="mapAccumR"></a><span class='hs-comment'>-- | The 'mapAccumR' function behaves like a combination of 'map' and</span>
<a name="line-791"></a><span class='hs-comment'>-- 'foldr'; it applies a function to each element of a ByteString,</span>
<a name="line-792"></a><span class='hs-comment'>-- passing an accumulating parameter from right to left, and returning a</span>
<a name="line-793"></a><span class='hs-comment'>-- final value of this accumulator together with the new ByteString.</span>
<a name="line-794"></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'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc</span><span class='hs-layout'>,</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>acc</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-795"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-varid'>f</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>o</span> <span class='hs-varid'>len</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'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-796"></a>    <span class='hs-varid'>gp</span>   <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>mallocByteString</span> <span class='hs-varid'>len</span>
<a name="line-797"></a>    <span class='hs-varid'>acc'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>gp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>mapAccumR_</span> <span class='hs-varid'>acc</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>o</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span>
<a name="line-798"></a>    <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-layout'>(</span><span class='hs-varid'>acc'</span><span class='hs-layout'>,</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>gp</span> <span class='hs-num'>0</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-799"></a>  <span class='hs-keyword'>where</span>
<a name="line-800"></a>    <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>mapAccumR_</span><span class='hs-layout'>)</span>
<a name="line-801"></a>    <span class='hs-varid'>mapAccumR_</span> <span class='hs-varid'>s</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span>
<a name="line-802"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&lt;</span>  <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>s</span>
<a name="line-803"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-804"></a>            <span class='hs-varid'>x</span>  <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>n</span>
<a name="line-805"></a>            <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>s'</span><span class='hs-layout'>,</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-varid'>x</span>
<a name="line-806"></a>            <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span> <span class='hs-varid'>y</span>
<a name="line-807"></a>            <span class='hs-varid'>mapAccumR_</span> <span class='hs-varid'>s'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span>
<a name="line-808"></a><span class='hs-comment'>{-# INLINE mapAccumR #-}</span>
<a name="line-809"></a>
<a name="line-810"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-811"></a><span class='hs-comment'>-- Building ByteStrings</span>
<a name="line-812"></a>
<a name="line-813"></a><a name="scanl"></a><span class='hs-comment'>-- | 'scanl' is similar to 'foldl', but returns a list of successive</span>
<a name="line-814"></a><span class='hs-comment'>-- reduced values from the left. This function will fuse.</span>
<a name="line-815"></a><span class='hs-comment'>--</span>
<a name="line-816"></a><span class='hs-comment'>-- &gt; scanl f z [x1, x2, ...] == [z, z `f` x1, (z `f` x1) `f` x2, ...]</span>
<a name="line-817"></a><span class='hs-comment'>--</span>
<a name="line-818"></a><span class='hs-comment'>-- Note that</span>
<a name="line-819"></a><span class='hs-comment'>--</span>
<a name="line-820"></a><span class='hs-comment'>-- &gt; last (scanl f z xs) == foldl f z xs.</span>
<a name="line-821"></a><span class='hs-comment'>--</span>
<a name="line-822"></a><span class='hs-definition'>scanl</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-823"></a>
<a name="line-824"></a><span class='hs-definition'>scanl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>s</span> <span class='hs-varid'>len</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'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-825"></a>    <span class='hs-varid'>create</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>q</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-826"></a>        <span class='hs-varid'>poke</span> <span class='hs-varid'>q</span> <span class='hs-varid'>v</span>
<a name="line-827"></a>        <span class='hs-varid'>scanl_</span> <span class='hs-varid'>v</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>q</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-828"></a>  <span class='hs-keyword'>where</span>
<a name="line-829"></a>    <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>scanl_</span><span class='hs-layout'>)</span>
<a name="line-830"></a>    <span class='hs-varid'>scanl_</span> <span class='hs-varid'>z</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span>
<a name="line-831"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>len</span>  <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-832"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-833"></a>            <span class='hs-varid'>x</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>n</span>
<a name="line-834"></a>            <span class='hs-keyword'>let</span> <span class='hs-varid'>z'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>x</span>
<a name="line-835"></a>            <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span> <span class='hs-varid'>z'</span>
<a name="line-836"></a>            <span class='hs-varid'>scanl_</span> <span class='hs-varid'>z'</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'>p</span> <span class='hs-varid'>q</span>
<a name="line-837"></a><span class='hs-comment'>{-# INLINE scanl #-}</span>
<a name="line-838"></a>
<a name="line-839"></a>    <span class='hs-comment'>-- n.b. haskell's List scan returns a list one bigger than the</span>
<a name="line-840"></a>    <span class='hs-comment'>-- input, so we need to snoc here to get some extra space, however,</span>
<a name="line-841"></a>    <span class='hs-comment'>-- it breaks map/up fusion (i.e. scanl . map no longer fuses)</span>
<a name="line-842"></a>
<a name="line-843"></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-844"></a><span class='hs-comment'>-- This function will fuse.</span>
<a name="line-845"></a><span class='hs-comment'>--</span>
<a name="line-846"></a><span class='hs-comment'>-- &gt; scanl1 f [x1, x2, ...] == [x1, x1 `f` x2, ...]</span>
<a name="line-847"></a><span class='hs-definition'>scanl1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-848"></a><span class='hs-definition'>scanl1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span>
<a name="line-849"></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'>empty</span>
<a name="line-850"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>scanl</span> <span class='hs-varid'>f</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-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-851"></a><span class='hs-comment'>{-# INLINE scanl1 #-}</span>
<a name="line-852"></a>
<a name="line-853"></a><a name="scanr"></a><span class='hs-comment'>-- | scanr is the right-to-left dual of scanl.</span>
<a name="line-854"></a><span class='hs-definition'>scanr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-855"></a><span class='hs-definition'>scanr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>s</span> <span class='hs-varid'>len</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'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-856"></a>    <span class='hs-varid'>create</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>q</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-857"></a>        <span class='hs-varid'>poke</span> <span class='hs-layout'>(</span><span class='hs-varid'>q</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-varid'>v</span>
<a name="line-858"></a>        <span class='hs-varid'>scanr_</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-varid'>q</span>
<a name="line-859"></a>  <span class='hs-keyword'>where</span>
<a name="line-860"></a>    <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>scanr_</span><span class='hs-layout'>)</span>
<a name="line-861"></a>    <span class='hs-varid'>scanr_</span> <span class='hs-varid'>z</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span>
<a name="line-862"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&lt;</span>  <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-863"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-864"></a>            <span class='hs-varid'>x</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>n</span>
<a name="line-865"></a>            <span class='hs-keyword'>let</span> <span class='hs-varid'>z'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span> <span class='hs-varid'>z</span>
<a name="line-866"></a>            <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>q</span> <span class='hs-varid'>n</span> <span class='hs-varid'>z'</span>
<a name="line-867"></a>            <span class='hs-varid'>scanr_</span> <span class='hs-varid'>z'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span> <span class='hs-varid'>q</span>
<a name="line-868"></a><span class='hs-comment'>{-# INLINE scanr #-}</span>
<a name="line-869"></a>
<a name="line-870"></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-871"></a><span class='hs-definition'>scanr1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-872"></a><span class='hs-definition'>scanr1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span>
<a name="line-873"></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'>empty</span>
<a name="line-874"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>scanr</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>last</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>init</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- todo, unsafe versions</span>
<a name="line-875"></a><span class='hs-comment'>{-# INLINE scanr1 #-}</span>
<a name="line-876"></a>
<a name="line-877"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-878"></a><span class='hs-comment'>-- Unfolds and replicates</span>
<a name="line-879"></a>
<a name="line-880"></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-881"></a><span class='hs-comment'>-- the value of every element. The following holds:</span>
<a name="line-882"></a><span class='hs-comment'>--</span>
<a name="line-883"></a><span class='hs-comment'>-- &gt; replicate w c = unfoldr w (\u -&gt; Just (u,u)) c</span>
<a name="line-884"></a><span class='hs-comment'>--</span>
<a name="line-885"></a><span class='hs-comment'>-- This implemenation uses @memset(3)@</span>
<a name="line-886"></a><span class='hs-definition'>replicate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-887"></a><span class='hs-definition'>replicate</span> <span class='hs-varid'>w</span> <span class='hs-varid'>c</span>
<a name="line-888"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>w</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span>
<a name="line-889"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeCreate</span> <span class='hs-varid'>w</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-890"></a>                      <span class='hs-varid'>memset</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varop'>&gt;&gt;</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-891"></a>
<a name="line-892"></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-893"></a><span class='hs-comment'>-- function is analogous to the List \'unfoldr\'.  'unfoldr' builds a </span>
<a name="line-894"></a><span class='hs-comment'>-- ByteString from a seed value.  The function takes the element and </span>
<a name="line-895"></a><span class='hs-comment'>-- returns 'Nothing' if it is done producing the ByteString or returns </span>
<a name="line-896"></a><span class='hs-comment'>-- 'Just' @(a,b)@, in which case, @a@ is the next byte in the string, </span>
<a name="line-897"></a><span class='hs-comment'>-- and @b@ is the seed value for further production.</span>
<a name="line-898"></a><span class='hs-comment'>--</span>
<a name="line-899"></a><span class='hs-comment'>-- Examples:</span>
<a name="line-900"></a><span class='hs-comment'>--</span>
<a name="line-901"></a><span class='hs-comment'>-- &gt;    unfoldr (\x -&gt; if x &lt;= 5 then Just (x, x + 1) else Nothing) 0</span>
<a name="line-902"></a><span class='hs-comment'>-- &gt; == pack [0, 1, 2, 3, 4, 5]</span>
<a name="line-903"></a><span class='hs-comment'>--</span>
<a name="line-904"></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'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-905"></a><span class='hs-definition'>unfoldr</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>unfoldChunk</span> <span class='hs-num'>32</span> <span class='hs-num'>64</span>
<a name="line-906"></a>  <span class='hs-keyword'>where</span> <span class='hs-varid'>unfoldChunk</span> <span class='hs-varid'>n</span> <span class='hs-varid'>n'</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span>
<a name="line-907"></a>          <span class='hs-keyword'>case</span> <span class='hs-varid'>unfoldrN</span> <span class='hs-varid'>n</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>of</span>
<a name="line-908"></a>            <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>s</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span>
<a name="line-909"></a>            <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-conid'>Just</span> <span class='hs-varid'>x'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>s</span> <span class='hs-conop'>:</span> <span class='hs-varid'>unfoldChunk</span> <span class='hs-varid'>n'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>n'</span><span class='hs-layout'>)</span> <span class='hs-varid'>x'</span>
<a name="line-910"></a><span class='hs-comment'>{-# INLINE unfoldr #-}</span>
<a name="line-911"></a>
<a name="line-912"></a><a name="unfoldrN"></a><span class='hs-comment'>-- | /O(n)/ Like 'unfoldr', 'unfoldrN' builds a ByteString from a seed</span>
<a name="line-913"></a><span class='hs-comment'>-- value.  However, the length of the result is limited by the first</span>
<a name="line-914"></a><span class='hs-comment'>-- argument to 'unfoldrN'.  This function is more efficient than 'unfoldr'</span>
<a name="line-915"></a><span class='hs-comment'>-- when the maximum length of the result is known.</span>
<a name="line-916"></a><span class='hs-comment'>--</span>
<a name="line-917"></a><span class='hs-comment'>-- The following equation relates 'unfoldrN' and 'unfoldr':</span>
<a name="line-918"></a><span class='hs-comment'>--</span>
<a name="line-919"></a><span class='hs-comment'>-- &gt; snd (unfoldrN n f s) == take n (unfoldr f s)</span>
<a name="line-920"></a><span class='hs-comment'>--</span>
<a name="line-921"></a><span class='hs-definition'>unfoldrN</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</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-922"></a><span class='hs-definition'>unfoldrN</span> <span class='hs-varid'>i</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x0</span>
<a name="line-923"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&lt;</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'>Just</span> <span class='hs-varid'>x0</span><span class='hs-layout'>)</span>
<a name="line-924"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>createAndTrim'</span> <span class='hs-varid'>i</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>x0</span> <span class='hs-num'>0</span>
<a name="line-925"></a>  <span class='hs-keyword'>where</span> <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-926"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>x</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span>
<a name="line-927"></a>          <span class='hs-keyword'>case</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>of</span>
<a name="line-928"></a>            <span class='hs-conid'>Nothing</span>      <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span>
<a name="line-929"></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'>x'</span><span class='hs-layout'>)</span>
<a name="line-930"></a>             <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>==</span> <span class='hs-varid'>i</span>    <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>n</span><span class='hs-layout'>,</span> <span class='hs-conid'>Just</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span>
<a name="line-931"></a>             <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>poke</span> <span class='hs-varid'>p</span> <span class='hs-varid'>w</span>
<a name="line-932"></a>                               <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'>x'</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-933"></a><span class='hs-comment'>{-# INLINE unfoldrN #-}</span>
<a name="line-934"></a>
<a name="line-935"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-936"></a><span class='hs-comment'>-- Substrings</span>
<a name="line-937"></a>
<a name="line-938"></a><a name="take"></a><span class='hs-comment'>-- | /O(1)/ 'take' @n@, applied to a ByteString @xs@, returns the prefix</span>
<a name="line-939"></a><span class='hs-comment'>-- of @xs@ of length @n@, or @xs@ itself if @n &gt; 'length' xs@.</span>
<a name="line-940"></a><span class='hs-definition'>take</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-941"></a><span class='hs-definition'>take</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</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>
<a name="line-942"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span>
<a name="line-943"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>l</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ps</span>
<a name="line-944"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>n</span>
<a name="line-945"></a><span class='hs-comment'>{-# INLINE take #-}</span>
<a name="line-946"></a>
<a name="line-947"></a><a name="drop"></a><span class='hs-comment'>-- | /O(1)/ 'drop' @n xs@ returns the suffix of @xs@ after the first @n@</span>
<a name="line-948"></a><span class='hs-comment'>-- elements, or @[]@ if @n &gt; 'length' xs@.</span>
<a name="line-949"></a><span class='hs-definition'>drop</span>  <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-950"></a><span class='hs-definition'>drop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</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>
<a name="line-951"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&lt;=</span> <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ps</span>
<a name="line-952"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>l</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span>
<a name="line-953"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</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'>n</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'>n</span><span class='hs-layout'>)</span>
<a name="line-954"></a><span class='hs-comment'>{-# INLINE drop #-}</span>
<a name="line-955"></a>
<a name="line-956"></a><a name="splitAt"></a><span class='hs-comment'>-- | /O(1)/ 'splitAt' @n xs@ is equivalent to @('take' n xs, 'drop' n xs)@.</span>
<a name="line-957"></a><span class='hs-definition'>splitAt</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-958"></a><span class='hs-definition'>splitAt</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</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>
<a name="line-959"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&lt;=</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-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-960"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>l</span>    <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>ps</span><span class='hs-layout'>,</span> <span class='hs-varid'>empty</span><span class='hs-layout'>)</span>
<a name="line-961"></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'>n</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'>n</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'>n</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-962"></a><span class='hs-comment'>{-# INLINE splitAt #-}</span>
<a name="line-963"></a>
<a name="line-964"></a><a name="takeWhile"></a><span class='hs-comment'>-- | 'takeWhile', applied to a predicate @p@ and a ByteString @xs@,</span>
<a name="line-965"></a><span class='hs-comment'>-- returns the longest prefix (possibly empty) of @xs@ of elements that</span>
<a name="line-966"></a><span class='hs-comment'>-- satisfy @p@.</span>
<a name="line-967"></a><span class='hs-definition'>takeWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-968"></a><span class='hs-definition'>takeWhile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeTake</span> <span class='hs-layout'>(</span><span class='hs-varid'>findIndexOrEnd</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span>
<a name="line-969"></a><span class='hs-comment'>{-# INLINE takeWhile #-}</span>
<a name="line-970"></a>
<a name="line-971"></a><a name="dropWhile"></a><span class='hs-comment'>-- | 'dropWhile' @p xs@ returns the suffix remaining after 'takeWhile' @p xs@.</span>
<a name="line-972"></a><span class='hs-definition'>dropWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-973"></a><span class='hs-definition'>dropWhile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeDrop</span> <span class='hs-layout'>(</span><span class='hs-varid'>findIndexOrEnd</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span>
<a name="line-974"></a><span class='hs-comment'>{-# INLINE dropWhile #-}</span>
<a name="line-975"></a>
<a name="line-976"></a><span class='hs-comment'>-- instead of findIndexOrEnd, we could use memchr here.</span>
<a name="line-977"></a>
<a name="line-978"></a><a name="break"></a><span class='hs-comment'>-- | 'break' @p@ is equivalent to @'span' ('not' . p)@.</span>
<a name="line-979"></a><span class='hs-comment'>--</span>
<a name="line-980"></a><span class='hs-comment'>-- Under GHC, a rewrite rule will transform break (==) into a</span>
<a name="line-981"></a><span class='hs-comment'>-- call to the specialised breakByte:</span>
<a name="line-982"></a><span class='hs-comment'>--</span>
<a name="line-983"></a><span class='hs-comment'>-- &gt; break ((==) x) = breakByte x</span>
<a name="line-984"></a><span class='hs-comment'>-- &gt; break (==x) = breakByte x</span>
<a name="line-985"></a><span class='hs-comment'>--</span>
<a name="line-986"></a><span class='hs-definition'>break</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-987"></a><span class='hs-definition'>break</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>findIndexOrEnd</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyword'>of</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTake</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</span><span class='hs-layout'>,</span> <span class='hs-varid'>unsafeDrop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-988"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ </span>
<a name="line-989"></a><span class='hs-comment'>{-# INLINE [1] break #-}</span>
<a name="line-990"></a><span class='hs-cpp'>#endif</span>
<a name="line-991"></a>
<a name="line-992"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ &gt;= 606</span>
<a name="line-993"></a><span class='hs-comment'>-- This RULE LHS is not allowed by ghc-6.4</span>
<a name="line-994"></a><span class='hs-comment'>{-# RULES
<a name="line-995"></a>"ByteString specialise break (x==)" forall x.
<a name="line-996"></a>    break ((==) x) = breakByte x
<a name="line-997"></a>"ByteString specialise break (==x)" forall x.
<a name="line-998"></a>    break (==x) = breakByte x
<a name="line-999"></a>  #-}</span>
<a name="line-1000"></a><span class='hs-cpp'>#endif</span>
<a name="line-1001"></a>
<a name="line-1002"></a><span class='hs-comment'>-- INTERNAL:</span>
<a name="line-1003"></a>
<a name="line-1004"></a><a name="breakByte"></a><span class='hs-comment'>-- | 'breakByte' breaks its ByteString argument at the first occurence</span>
<a name="line-1005"></a><span class='hs-comment'>-- of the specified byte. It is more efficient than 'break' as it is</span>
<a name="line-1006"></a><span class='hs-comment'>-- implemented with @memchr(3)@. I.e.</span>
<a name="line-1007"></a><span class='hs-comment'>-- </span>
<a name="line-1008"></a><span class='hs-comment'>-- &gt; break (=='c') "abcd" == breakByte 'c' "abcd"</span>
<a name="line-1009"></a><span class='hs-comment'>--</span>
<a name="line-1010"></a><span class='hs-definition'>breakByte</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-1011"></a><span class='hs-definition'>breakByte</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-1012"></a>    <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-&gt;</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-1013"></a>    <span class='hs-conid'>Just</span> <span class='hs-varid'>n</span>  <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</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-varid'>unsafeDrop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span>
<a name="line-1014"></a><span class='hs-comment'>{-# INLINE breakByte #-}</span>
<a name="line-1015"></a>
<a name="line-1016"></a><a name="breakEnd"></a><span class='hs-comment'>-- | 'breakEnd' behaves like 'break' but from the end of the 'ByteString'</span>
<a name="line-1017"></a><span class='hs-comment'>-- </span>
<a name="line-1018"></a><span class='hs-comment'>-- breakEnd p == spanEnd (not.p)</span>
<a name="line-1019"></a><span class='hs-definition'>breakEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-1020"></a><span class='hs-definition'>breakEnd</span>  <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-varid'>findFromEndUntil</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span>
<a name="line-1021"></a>
<a name="line-1022"></a><a name="span"></a><span class='hs-comment'>-- | 'span' @p xs@ breaks the ByteString into two segments. It is</span>
<a name="line-1023"></a><span class='hs-comment'>-- equivalent to @('takeWhile' p xs, 'dropWhile' p xs)@</span>
<a name="line-1024"></a><span class='hs-definition'>span</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-1025"></a><span class='hs-definition'>span</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>break</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span>
<a name="line-1026"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__</span>
<a name="line-1027"></a><span class='hs-comment'>{-# INLINE [1] span #-}</span>
<a name="line-1028"></a><span class='hs-cpp'>#endif</span>
<a name="line-1029"></a>
<a name="line-1030"></a><a name="spanByte"></a><span class='hs-comment'>-- | 'spanByte' breaks its ByteString argument at the first</span>
<a name="line-1031"></a><span class='hs-comment'>-- occurence of a byte other than its argument. It is more efficient</span>
<a name="line-1032"></a><span class='hs-comment'>-- than 'span (==)'</span>
<a name="line-1033"></a><span class='hs-comment'>--</span>
<a name="line-1034"></a><span class='hs-comment'>-- &gt; span  (=='c') "abcd" == spanByte 'c' "abcd"</span>
<a name="line-1035"></a><span class='hs-comment'>--</span>
<a name="line-1036"></a><span class='hs-definition'>spanByte</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-1037"></a><span class='hs-definition'>spanByte</span> <span class='hs-varid'>c</span> <span class='hs-varid'>ps</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-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'>-&gt;</span>
<a name="line-1038"></a>    <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-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span>
<a name="line-1039"></a>  <span class='hs-keyword'>where</span>
<a name="line-1040"></a>    <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-1041"></a>    <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>l</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>ps</span><span class='hs-layout'>,</span> <span class='hs-varid'>empty</span><span class='hs-layout'>)</span>
<a name="line-1042"></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'>c'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span>
<a name="line-1043"></a>                            <span class='hs-keyword'>if</span> <span class='hs-varid'>c</span> <span class='hs-varop'>/=</span> <span class='hs-varid'>c'</span>
<a name="line-1044"></a>                                <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTake</span> <span class='hs-varid'>i</span> <span class='hs-varid'>ps</span><span class='hs-layout'>,</span> <span class='hs-varid'>unsafeDrop</span> <span class='hs-varid'>i</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-1045"></a>                                <span class='hs-keyword'>else</span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</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-1046"></a><span class='hs-comment'>{-# INLINE spanByte #-}</span>
<a name="line-1047"></a>
<a name="line-1048"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ &gt;= 606</span>
<a name="line-1049"></a><span class='hs-comment'>-- This RULE LHS is not allowed by ghc-6.4</span>
<a name="line-1050"></a><span class='hs-comment'>{-# RULES
<a name="line-1051"></a>"ByteString specialise span (x==)" forall x.
<a name="line-1052"></a>    span ((==) x) = spanByte x
<a name="line-1053"></a>"ByteString specialise span (==x)" forall x.
<a name="line-1054"></a>    span (==x) = spanByte x
<a name="line-1055"></a>  #-}</span>
<a name="line-1056"></a><span class='hs-cpp'>#endif</span>
<a name="line-1057"></a>
<a name="line-1058"></a><a name="spanEnd"></a><span class='hs-comment'>-- | 'spanEnd' behaves like 'span' but from the end of the 'ByteString'.</span>
<a name="line-1059"></a><span class='hs-comment'>-- We have</span>
<a name="line-1060"></a><span class='hs-comment'>--</span>
<a name="line-1061"></a><span class='hs-comment'>-- &gt; spanEnd (not.isSpace) "x y z" == ("x y ","z")</span>
<a name="line-1062"></a><span class='hs-comment'>--</span>
<a name="line-1063"></a><span class='hs-comment'>-- and</span>
<a name="line-1064"></a><span class='hs-comment'>--</span>
<a name="line-1065"></a><span class='hs-comment'>-- &gt; spanEnd (not . isSpace) ps</span>
<a name="line-1066"></a><span class='hs-comment'>-- &gt;    == </span>
<a name="line-1067"></a><span class='hs-comment'>-- &gt; let (x,y) = span (not.isSpace) (reverse ps) in (reverse y, reverse x) </span>
<a name="line-1068"></a><span class='hs-comment'>--</span>
<a name="line-1069"></a><span class='hs-definition'>spanEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-1070"></a><span class='hs-definition'>spanEnd</span>  <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-varid'>findFromEndUntil</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span><span class='hs-varop'>.</span><span class='hs-varid'>p</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span>
<a name="line-1071"></a>
<a name="line-1072"></a><a name="splitWith"></a><span class='hs-comment'>-- | /O(n)/ Splits a 'ByteString' into components delimited by</span>
<a name="line-1073"></a><span class='hs-comment'>-- separators, where the predicate returns True for a separator element.</span>
<a name="line-1074"></a><span class='hs-comment'>-- The resulting components do not contain the separators.  Two adjacent</span>
<a name="line-1075"></a><span class='hs-comment'>-- separators result in an empty component in the output.  eg.</span>
<a name="line-1076"></a><span class='hs-comment'>--</span>
<a name="line-1077"></a><span class='hs-comment'>-- &gt; splitWith (=='a') "aabbaca" == ["","","bb","c",""]</span>
<a name="line-1078"></a><span class='hs-comment'>-- &gt; splitWith (=='a') []        == []</span>
<a name="line-1079"></a><span class='hs-comment'>--</span>
<a name="line-1080"></a><span class='hs-definition'>splitWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1081"></a>
<a name="line-1082"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span>
<a name="line-1083"></a><span class='hs-definition'>splitWith</span> <span class='hs-sel'>_pred</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span>  <span class='hs-keyword'>_</span>   <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-1084"></a><span class='hs-definition'>splitWith</span> <span class='hs-varid'>pred_</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitWith0</span> <span class='hs-varid'>pred</span><span class='hs-cpp'>#</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span> <span class='hs-varid'>fp</span>
<a name="line-1085"></a>  <span class='hs-keyword'>where</span> <span class='hs-varid'>pred</span><span class='hs-cpp'>#</span> <span class='hs-varid'>c</span><span class='hs-cpp'>#</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>pred_</span> <span class='hs-layout'>(</span><span class='hs-conid'>W8</span><span class='hs-cpp'>#</span> <span class='hs-varid'>c</span><span class='hs-cpp'>#</span><span class='hs-layout'>)</span>
<a name="line-1086"></a>
<a name="line-1087"></a>        <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>splitWith0</span><span class='hs-layout'>)</span>
<a name="line-1088"></a>        <span class='hs-varid'>splitWith0</span> <span class='hs-varid'>pred'</span> <span class='hs-varid'>off'</span> <span class='hs-varid'>len'</span> <span class='hs-varid'>fp'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>withPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1089"></a>            <span class='hs-varid'>splitLoop</span> <span class='hs-varid'>pred'</span> <span class='hs-varid'>p</span> <span class='hs-num'>0</span> <span class='hs-varid'>off'</span> <span class='hs-varid'>len'</span> <span class='hs-varid'>fp'</span>
<a name="line-1090"></a>
<a name="line-1091"></a>        <span class='hs-varid'>splitLoop</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word</span><span class='hs-cpp'>#</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span>
<a name="line-1092"></a>                  <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span>
<a name="line-1093"></a>                  <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span>
<a name="line-1094"></a>                  <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ForeignPtr</span> <span class='hs-conid'>Word8</span>
<a name="line-1095"></a>                  <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1096"></a>
<a name="line-1097"></a>        <span class='hs-varid'>splitLoop</span> <span class='hs-varid'>pred'</span> <span class='hs-varid'>p</span> <span class='hs-varid'>idx'</span> <span class='hs-varid'>off'</span> <span class='hs-varid'>len'</span> <span class='hs-varid'>fp'</span>
<a name="line-1098"></a>            <span class='hs-keyglyph'>|</span> <span class='hs-varid'>idx'</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>len'</span>  <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp'</span> <span class='hs-varid'>off'</span> <span class='hs-varid'>idx'</span><span class='hs-keyglyph'>]</span>
<a name="line-1099"></a>            <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1100"></a>                <span class='hs-varid'>w</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekElemOff</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>off'</span><span class='hs-varop'>+</span><span class='hs-varid'>idx'</span><span class='hs-layout'>)</span>
<a name="line-1101"></a>                <span class='hs-keyword'>if</span> <span class='hs-varid'>pred'</span> <span class='hs-layout'>(</span><span class='hs-keyword'>case</span> <span class='hs-varid'>w</span> <span class='hs-keyword'>of</span> <span class='hs-conid'>W8</span><span class='hs-cpp'>#</span> <span class='hs-varid'>w</span><span class='hs-cpp'>#</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>w</span><span class='hs-cpp'>#</span><span class='hs-layout'>)</span>
<a name="line-1102"></a>                   <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp'</span> <span class='hs-varid'>off'</span> <span class='hs-varid'>idx'</span> <span class='hs-conop'>:</span>
<a name="line-1103"></a>                              <span class='hs-varid'>splitWith0</span> <span class='hs-varid'>pred'</span> <span class='hs-layout'>(</span><span class='hs-varid'>off'</span><span class='hs-varop'>+</span><span class='hs-varid'>idx'</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len'</span><span class='hs-comment'>-</span><span class='hs-varid'>idx'</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>fp'</span><span class='hs-layout'>)</span>
<a name="line-1104"></a>                   <span class='hs-keyword'>else</span> <span class='hs-varid'>splitLoop</span> <span class='hs-varid'>pred'</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>idx'</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>off'</span> <span class='hs-varid'>len'</span> <span class='hs-varid'>fp'</span>
<a name="line-1105"></a><span class='hs-comment'>{-# INLINE splitWith #-}</span>
<a name="line-1106"></a>
<a name="line-1107"></a><span class='hs-cpp'>#else</span>
<a name="line-1108"></a><span class='hs-definition'>splitWith</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-1109"></a><span class='hs-definition'>splitWith</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span>
<a name="line-1110"></a>    <span class='hs-keyword'>where</span>
<a name="line-1111"></a>        <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-1112"></a>        <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-varid'>qs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>null</span> <span class='hs-varid'>rest</span> <span class='hs-keyword'>then</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>chunk</span><span class='hs-keyglyph'>]</span>
<a name="line-1113"></a>                                 <span class='hs-keyword'>else</span> <span class='hs-varid'>chunk</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>q</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>rest</span><span class='hs-layout'>)</span>
<a name="line-1114"></a>            <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>chunk</span><span class='hs-layout'>,</span><span class='hs-varid'>rest</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>break</span> <span class='hs-varid'>q</span> <span class='hs-varid'>qs</span>
<a name="line-1115"></a><span class='hs-cpp'>#endif</span>
<a name="line-1116"></a>
<a name="line-1117"></a><a name="split"></a><span class='hs-comment'>-- | /O(n)/ Break a 'ByteString' into pieces separated by the byte</span>
<a name="line-1118"></a><span class='hs-comment'>-- argument, consuming the delimiter. I.e.</span>
<a name="line-1119"></a><span class='hs-comment'>--</span>
<a name="line-1120"></a><span class='hs-comment'>-- &gt; split '\n' "a\nb\nd\ne" == ["a","b","d","e"]</span>
<a name="line-1121"></a><span class='hs-comment'>-- &gt; split 'a'  "aXaXaXa"    == ["","X","X","X",""]</span>
<a name="line-1122"></a><span class='hs-comment'>-- &gt; split 'x'  "x"          == ["",""]</span>
<a name="line-1123"></a><span class='hs-comment'>-- </span>
<a name="line-1124"></a><span class='hs-comment'>-- and</span>
<a name="line-1125"></a><span class='hs-comment'>--</span>
<a name="line-1126"></a><span class='hs-comment'>-- &gt; intercalate [c] . split c == id</span>
<a name="line-1127"></a><span class='hs-comment'>-- &gt; split == splitWith . (==)</span>
<a name="line-1128"></a><span class='hs-comment'>-- </span>
<a name="line-1129"></a><span class='hs-comment'>-- As for all splitting functions in this library, this function does</span>
<a name="line-1130"></a><span class='hs-comment'>-- not copy the substrings, it just constructs new 'ByteStrings' that</span>
<a name="line-1131"></a><span class='hs-comment'>-- are slices of the original.</span>
<a name="line-1132"></a><span class='hs-comment'>--</span>
<a name="line-1133"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1134"></a><span class='hs-definition'>split</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-1135"></a><span class='hs-definition'>split</span> <span class='hs-varid'>w</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'>loop</span> <span class='hs-num'>0</span>
<a name="line-1136"></a>    <span class='hs-keyword'>where</span>
<a name="line-1137"></a>        <span class='hs-conid'>STRICT1</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-1138"></a>        <span class='hs-varid'>loop</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span>
<a name="line-1139"></a>            <span class='hs-keyword'>let</span> <span class='hs-varid'>q</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'>-&gt;</span>
<a name="line-1140"></a>                      <span class='hs-varid'>memchr</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1141"></a>                             <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1142"></a>            <span class='hs-keyword'>in</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>q</span> <span class='hs-varop'>==</span> <span class='hs-varid'>nullPtr</span>
<a name="line-1143"></a>                <span class='hs-keyword'>then</span> <span class='hs-keyglyph'>[</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'>n</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'>n</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-1144"></a>                <span class='hs-keyword'>else</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>i</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'>-&gt;</span>
<a name="line-1145"></a>                               <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>q</span> <span class='hs-varop'>`minusPtr`</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-layout'>)</span>
<a name="line-1146"></a>                      <span class='hs-keyword'>in</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'>n</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-comment'>-</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</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-1147"></a>
<a name="line-1148"></a><span class='hs-comment'>{-# INLINE split #-}</span>
<a name="line-1149"></a>
<a name="line-1150"></a><span class='hs-comment'>{-
<a name="line-1151"></a>-- slower. but stays inside Haskell.
<a name="line-1152"></a>split _ (PS _  _   0) = []
<a name="line-1153"></a>split (W8# w#) (PS fp off len) = splitWith' off len fp
<a name="line-1154"></a>    where
<a name="line-1155"></a>        splitWith' off' len' fp' = withPtr fp $ \p -&gt;
<a name="line-1156"></a>            splitLoop p 0 off' len' fp'
<a name="line-1157"></a>
<a name="line-1158"></a>        splitLoop :: Ptr Word8
<a name="line-1159"></a>                  -&gt; Int -&gt; Int -&gt; Int
<a name="line-1160"></a>                  -&gt; ForeignPtr Word8
<a name="line-1161"></a>                  -&gt; IO [ByteString]
<a name="line-1162"></a>
<a name="line-1163"></a>        STRICT5(splitLoop)
<a name="line-1164"></a>        splitLoop p idx' off' len' fp'
<a name="line-1165"></a>            | idx' &gt;= len'  = return [PS fp' off' idx']
<a name="line-1166"></a>            | otherwise = do
<a name="line-1167"></a>                (W8# x#) &lt;- peekElemOff p (off'+idx')
<a name="line-1168"></a>                if word2Int# w# ==# word2Int# x#
<a name="line-1169"></a>                   then return (PS fp' off' idx' :
<a name="line-1170"></a>                              splitWith' (off'+idx'+1) (len'-idx'-1) fp')
<a name="line-1171"></a>                   else splitLoop p (idx'+1) off' len' fp'
<a name="line-1172"></a>-}</span>
<a name="line-1173"></a>
<a name="line-1174"></a><span class='hs-comment'>{-
<a name="line-1175"></a>-- | Like 'splitWith', except that sequences of adjacent separators are
<a name="line-1176"></a>-- treated as a single separator. eg.
<a name="line-1177"></a>-- 
<a name="line-1178"></a>-- &gt; tokens (=='a') "aabbaca" == ["bb","c"]
<a name="line-1179"></a>--
<a name="line-1180"></a>tokens :: (Word8 -&gt; Bool) -&gt; ByteString -&gt; [ByteString]
<a name="line-1181"></a>tokens f = P.filter (not.null) . splitWith f
<a name="line-1182"></a>{-# INLINE tokens #-}
<a name="line-1183"></a>-}</span>
<a name="line-1184"></a>
<a name="line-1185"></a><a name="group"></a><span class='hs-comment'>-- | The 'group' function takes a ByteString and returns a list of</span>
<a name="line-1186"></a><span class='hs-comment'>-- ByteStrings such that the concatenation of the result is equal to the</span>
<a name="line-1187"></a><span class='hs-comment'>-- argument.  Moreover, each sublist in the result contains only equal</span>
<a name="line-1188"></a><span class='hs-comment'>-- elements.  For example,</span>
<a name="line-1189"></a><span class='hs-comment'>--</span>
<a name="line-1190"></a><span class='hs-comment'>-- &gt; group "Mississippi" = ["M","i","ss","i","ss","i","pp","i"]</span>
<a name="line-1191"></a><span class='hs-comment'>--</span>
<a name="line-1192"></a><span class='hs-comment'>-- It is a special case of 'groupBy', which allows the programmer to</span>
<a name="line-1193"></a><span class='hs-comment'>-- supply their own equality test. It is about 40% faster than </span>
<a name="line-1194"></a><span class='hs-comment'>-- /groupBy (==)/</span>
<a name="line-1195"></a><span class='hs-definition'>group</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1196"></a><span class='hs-definition'>group</span> <span class='hs-varid'>xs</span>
<a name="line-1197"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>xs</span>   <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-1198"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ys</span> <span class='hs-conop'>:</span> <span class='hs-varid'>group</span> <span class='hs-varid'>zs</span>
<a name="line-1199"></a>    <span class='hs-keyword'>where</span>
<a name="line-1200"></a>        <span class='hs-layout'>(</span><span class='hs-varid'>ys</span><span class='hs-layout'>,</span> <span class='hs-varid'>zs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>spanByte</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-1201"></a>
<a name="line-1202"></a><a name="groupBy"></a><span class='hs-comment'>-- | The 'groupBy' function is the non-overloaded version of 'group'.</span>
<a name="line-1203"></a><span class='hs-definition'>groupBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1204"></a><span class='hs-definition'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-varid'>xs</span>
<a name="line-1205"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>xs</span>   <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-1206"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeTake</span> <span class='hs-varid'>n</span> <span class='hs-varid'>xs</span> <span class='hs-conop'>:</span> <span class='hs-varid'>groupBy</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeDrop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-1207"></a>    <span class='hs-keyword'>where</span>
<a name="line-1208"></a>        <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-num'>1</span> <span class='hs-varop'>+</span> <span class='hs-varid'>findIndexOrEnd</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-1209"></a>
<a name="line-1210"></a><a name="intercalate"></a><span class='hs-comment'>-- | /O(n)/ The 'intercalate' function takes a 'ByteString' and a list of</span>
<a name="line-1211"></a><span class='hs-comment'>-- 'ByteString's and concatenates the list after interspersing the first</span>
<a name="line-1212"></a><span class='hs-comment'>-- argument between each element of the list.</span>
<a name="line-1213"></a><span class='hs-definition'>intercalate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-1214"></a><span class='hs-definition'>intercalate</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-layout'>(</span><span class='hs-conid'>List</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1215"></a><span class='hs-comment'>{-# INLINE [1] intercalate #-}</span>
<a name="line-1216"></a>
<a name="line-1217"></a><span class='hs-comment'>{-# RULES
<a name="line-1218"></a>"ByteString specialise intercalate c -&gt; intercalateByte" forall c s1 s2 .
<a name="line-1219"></a>    intercalate (singleton c) (s1 : s2 : []) = intercalateWithByte c s1 s2
<a name="line-1220"></a>  #-}</span>
<a name="line-1221"></a>
<a name="line-1222"></a><a name="intercalateWithByte"></a><span class='hs-comment'>-- | /O(n)/ intercalateWithByte. An efficient way to join to two ByteStrings</span>
<a name="line-1223"></a><span class='hs-comment'>-- with a char. Around 4 times faster than the generalised join.</span>
<a name="line-1224"></a><span class='hs-comment'>--</span>
<a name="line-1225"></a><span class='hs-definition'>intercalateWithByte</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-1226"></a><span class='hs-definition'>intercalateWithByte</span> <span class='hs-varid'>c</span> <span class='hs-varid'>f</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>ffp</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>g</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fgp</span> <span class='hs-varid'>t</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeCreate</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>ptr</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1227"></a>    <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>ffp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>fp</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1228"></a>    <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>fgp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>gp</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1229"></a>        <span class='hs-varid'>memcpy</span> <span class='hs-varid'>ptr</span> <span class='hs-layout'>(</span><span class='hs-varid'>fp</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-1230"></a>        <span class='hs-varid'>poke</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span>
<a name="line-1231"></a>        <span class='hs-varid'>memcpy</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>gp</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span>
<a name="line-1232"></a>    <span class='hs-keyword'>where</span>
<a name="line-1233"></a>      <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>length</span> <span class='hs-varid'>f</span> <span class='hs-varop'>+</span> <span class='hs-varid'>length</span> <span class='hs-varid'>g</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span>
<a name="line-1234"></a><span class='hs-comment'>{-# INLINE intercalateWithByte #-}</span>
<a name="line-1235"></a>
<a name="line-1236"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1237"></a><span class='hs-comment'>-- Indexing ByteStrings</span>
<a name="line-1238"></a>
<a name="line-1239"></a><a name="index"></a><span class='hs-comment'>-- | /O(1)/ 'ByteString' index (subscript) operator, starting from 0.</span>
<a name="line-1240"></a><span class='hs-definition'>index</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span>
<a name="line-1241"></a><span class='hs-definition'>index</span> <span class='hs-varid'>ps</span> <span class='hs-varid'>n</span>
<a name="line-1242"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&lt;</span> <span class='hs-num'>0</span>          <span class='hs-keyglyph'>=</span> <span class='hs-varid'>moduleError</span> <span class='hs-str'>"index"</span> <span class='hs-layout'>(</span><span class='hs-str'>"negative index: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span>
<a name="line-1243"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>length</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>moduleError</span> <span class='hs-str'>"index"</span> <span class='hs-layout'>(</span><span class='hs-str'>"index too large: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>n</span>
<a name="line-1244"></a>                                         <span class='hs-varop'>++</span> <span class='hs-str'>", length = "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1245"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>      <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ps</span> <span class='hs-varop'>`unsafeIndex`</span> <span class='hs-varid'>n</span>
<a name="line-1246"></a><span class='hs-comment'>{-# INLINE index #-}</span>
<a name="line-1247"></a>
<a name="line-1248"></a><a name="elemIndex"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndex' function returns the index of the first</span>
<a name="line-1249"></a><span class='hs-comment'>-- element in the given 'ByteString' which is equal to the query</span>
<a name="line-1250"></a><span class='hs-comment'>-- element, or 'Nothing' if there is no such element. </span>
<a name="line-1251"></a><span class='hs-comment'>-- This implementation uses memchr(3).</span>
<a name="line-1252"></a><span class='hs-definition'>elemIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-1253"></a><span class='hs-definition'>elemIndex</span> <span class='hs-varid'>c</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'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1254"></a>    <span class='hs-keyword'>let</span> <span class='hs-varid'>p'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span>
<a name="line-1255"></a>    <span class='hs-varid'>q</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>memchr</span> <span class='hs-varid'>p'</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-1256"></a>    <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>q</span> <span class='hs-varop'>==</span> <span class='hs-varid'>nullPtr</span> <span class='hs-keyword'>then</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyword'>else</span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>q</span> <span class='hs-varop'>`minusPtr`</span> <span class='hs-varid'>p'</span>
<a name="line-1257"></a><span class='hs-comment'>{-# INLINE elemIndex #-}</span>
<a name="line-1258"></a>
<a name="line-1259"></a><a name="elemIndexEnd"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndexEnd' function returns the last index of the</span>
<a name="line-1260"></a><span class='hs-comment'>-- element in the given 'ByteString' which is equal to the query</span>
<a name="line-1261"></a><span class='hs-comment'>-- element, or 'Nothing' if there is no such element. The following</span>
<a name="line-1262"></a><span class='hs-comment'>-- holds:</span>
<a name="line-1263"></a><span class='hs-comment'>--</span>
<a name="line-1264"></a><span class='hs-comment'>-- &gt; elemIndexEnd c xs == </span>
<a name="line-1265"></a><span class='hs-comment'>-- &gt; (-) (length xs - 1) `fmap` elemIndex c (reverse xs)</span>
<a name="line-1266"></a><span class='hs-comment'>--</span>
<a name="line-1267"></a><span class='hs-definition'>elemIndexEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-1268"></a><span class='hs-definition'>elemIndexEnd</span> <span class='hs-varid'>ch</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'>-&gt;</span>
<a name="line-1269"></a>    <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-varid'>s</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-num'>1</span><span class='hs-layout'>)</span>
<a name="line-1270"></a>  <span class='hs-keyword'>where</span>
<a name="line-1271"></a>    <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-1272"></a>    <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&lt;</span> <span class='hs-num'>0</span>     <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Nothing</span>
<a name="line-1273"></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'>ch'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span>
<a name="line-1274"></a>                            <span class='hs-keyword'>if</span> <span class='hs-varid'>ch</span> <span class='hs-varop'>==</span> <span class='hs-varid'>ch'</span>
<a name="line-1275"></a>                                <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Just</span> <span class='hs-varid'>i</span>
<a name="line-1276"></a>                                <span class='hs-keyword'>else</span> <span class='hs-varid'>go</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-1277"></a><span class='hs-comment'>{-# INLINE elemIndexEnd #-}</span>
<a name="line-1278"></a>
<a name="line-1279"></a><a name="elemIndices"></a><span class='hs-comment'>-- | /O(n)/ The 'elemIndices' function extends 'elemIndex', by returning</span>
<a name="line-1280"></a><span class='hs-comment'>-- the indices of all elements equal to the query element, in ascending order.</span>
<a name="line-1281"></a><span class='hs-comment'>-- This implementation uses memchr(3).</span>
<a name="line-1282"></a><span class='hs-definition'>elemIndices</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Int</span><span class='hs-keyglyph'>]</span>
<a name="line-1283"></a><span class='hs-definition'>elemIndices</span> <span class='hs-varid'>w</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'>loop</span> <span class='hs-num'>0</span>
<a name="line-1284"></a>    <span class='hs-keyword'>where</span>
<a name="line-1285"></a>        <span class='hs-conid'>STRICT1</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-1286"></a>        <span class='hs-varid'>loop</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>q</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'>-&gt;</span>
<a name="line-1287"></a>                           <span class='hs-varid'>memchr</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>s</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1288"></a>                                                <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span> <span class='hs-comment'>-</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1289"></a>                 <span class='hs-keyword'>in</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>q</span> <span class='hs-varop'>==</span> <span class='hs-varid'>nullPtr</span>
<a name="line-1290"></a>                        <span class='hs-keyword'>then</span> <span class='hs-conid'>[]</span>
<a name="line-1291"></a>                        <span class='hs-keyword'>else</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>i</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'>-&gt;</span>
<a name="line-1292"></a>                                       <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>q</span> <span class='hs-varop'>`minusPtr`</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-layout'>)</span>
<a name="line-1293"></a>                             <span class='hs-keyword'>in</span> <span class='hs-varid'>i</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</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-1294"></a><span class='hs-comment'>{-# INLINE elemIndices #-}</span>
<a name="line-1295"></a>
<a name="line-1296"></a><span class='hs-comment'>{-
<a name="line-1297"></a>-- much slower
<a name="line-1298"></a>elemIndices :: Word8 -&gt; ByteString -&gt; [Int]
<a name="line-1299"></a>elemIndices c ps = loop 0 ps
<a name="line-1300"></a>   where STRICT2(loop)
<a name="line-1301"></a>         loop _ ps' | null ps'            = []
<a name="line-1302"></a>         loop n ps' | c == unsafeHead ps' = n : loop (n+1) (unsafeTail ps')
<a name="line-1303"></a>                    | otherwise           = loop (n+1) (unsafeTail ps')
<a name="line-1304"></a>-}</span>
<a name="line-1305"></a>
<a name="line-1306"></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-1307"></a><span class='hs-comment'>--</span>
<a name="line-1308"></a><span class='hs-comment'>-- &gt; count = length . elemIndices</span>
<a name="line-1309"></a><span class='hs-comment'>--</span>
<a name="line-1310"></a><span class='hs-comment'>-- But more efficiently than using length on the intermediate list.</span>
<a name="line-1311"></a><span class='hs-definition'>count</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span>
<a name="line-1312"></a><span class='hs-definition'>count</span> <span class='hs-varid'>w</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'>m</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'>-&gt;</span>
<a name="line-1313"></a>    <span class='hs-varid'>fmap</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varop'>$</span> <span class='hs-varid'>c_count</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-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span>
<a name="line-1314"></a><span class='hs-comment'>{-# INLINE count #-}</span>
<a name="line-1315"></a>
<a name="line-1316"></a><span class='hs-comment'>{-
<a name="line-1317"></a>--
<a name="line-1318"></a>-- around 30% slower
<a name="line-1319"></a>--
<a name="line-1320"></a>count w (PS x s m) = inlinePerformIO $ withForeignPtr x $ \p -&gt;
<a name="line-1321"></a>     go (p `plusPtr` s) (fromIntegral m) 0
<a name="line-1322"></a>    where
<a name="line-1323"></a>        go :: Ptr Word8 -&gt; CSize -&gt; Int -&gt; IO Int
<a name="line-1324"></a>        STRICT3(go)
<a name="line-1325"></a>        go p l i = do
<a name="line-1326"></a>            q &lt;- memchr p w l
<a name="line-1327"></a>            if q == nullPtr
<a name="line-1328"></a>                then return i
<a name="line-1329"></a>                else do let k = fromIntegral $ q `minusPtr` p
<a name="line-1330"></a>                        go (q `plusPtr` 1) (l-k-1) (i+1)
<a name="line-1331"></a>-}</span>
<a name="line-1332"></a>
<a name="line-1333"></a><a name="findIndex"></a><span class='hs-comment'>-- | The 'findIndex' function takes a predicate and a 'ByteString' and</span>
<a name="line-1334"></a><span class='hs-comment'>-- returns the index of the first element in the ByteString</span>
<a name="line-1335"></a><span class='hs-comment'>-- satisfying the predicate.</span>
<a name="line-1336"></a><span class='hs-definition'>findIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-1337"></a><span class='hs-definition'>findIndex</span> <span class='hs-varid'>k</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'>f</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span>
<a name="line-1338"></a>  <span class='hs-keyword'>where</span>
<a name="line-1339"></a>    <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-1340"></a>    <span class='hs-varid'>go</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>l</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Nothing</span>
<a name="line-1341"></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'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>ptr</span>
<a name="line-1342"></a>                              <span class='hs-keyword'>if</span> <span class='hs-varid'>k</span> <span class='hs-varid'>w</span>
<a name="line-1343"></a>                                <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span>
<a name="line-1344"></a>                                <span class='hs-keyword'>else</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-1345"></a><span class='hs-comment'>{-# INLINE findIndex #-}</span>
<a name="line-1346"></a>
<a name="line-1347"></a><a name="findIndices"></a><span class='hs-comment'>-- | The 'findIndices' function extends 'findIndex', by returning the</span>
<a name="line-1348"></a><span class='hs-comment'>-- indices of all elements satisfying the predicate, in ascending order.</span>
<a name="line-1349"></a><span class='hs-definition'>findIndices</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Int</span><span class='hs-keyglyph'>]</span>
<a name="line-1350"></a><span class='hs-definition'>findIndices</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-varid'>ps</span>
<a name="line-1351"></a>   <span class='hs-keyword'>where</span>
<a name="line-1352"></a>     <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>loop</span><span class='hs-layout'>)</span>
<a name="line-1353"></a>     <span class='hs-varid'>loop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>qs</span> <span class='hs-keyglyph'>|</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-1354"></a>               <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</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-keyglyph'>=</span> <span class='hs-varid'>n</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</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-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>qs</span><span class='hs-layout'>)</span>
<a name="line-1355"></a>               <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>         <span class='hs-keyglyph'>=</span>     <span class='hs-varid'>loop</span> <span class='hs-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-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>qs</span><span class='hs-layout'>)</span>
<a name="line-1356"></a>
<a name="line-1357"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1358"></a><span class='hs-comment'>-- Searching ByteStrings</span>
<a name="line-1359"></a>
<a name="line-1360"></a><a name="elem"></a><span class='hs-comment'>-- | /O(n)/ 'elem' is the 'ByteString' membership predicate.</span>
<a name="line-1361"></a><span class='hs-definition'>elem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-1362"></a><span class='hs-definition'>elem</span> <span class='hs-varid'>c</span> <span class='hs-varid'>ps</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'>ps</span> <span class='hs-keyword'>of</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>False</span> <span class='hs-layout'>;</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>True</span>
<a name="line-1363"></a><span class='hs-comment'>{-# INLINE elem #-}</span>
<a name="line-1364"></a>
<a name="line-1365"></a><a name="notElem"></a><span class='hs-comment'>-- | /O(n)/ 'notElem' is the inverse of 'elem'</span>
<a name="line-1366"></a><span class='hs-definition'>notElem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-1367"></a><span class='hs-definition'>notElem</span> <span class='hs-varid'>c</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-varid'>elem</span> <span class='hs-varid'>c</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span>
<a name="line-1368"></a><span class='hs-comment'>{-# INLINE notElem #-}</span>
<a name="line-1369"></a>
<a name="line-1370"></a><a name="filter"></a><span class='hs-comment'>-- | /O(n)/ 'filter', applied to a predicate and a ByteString,</span>
<a name="line-1371"></a><span class='hs-comment'>-- returns a ByteString containing those characters that satisfy the</span>
<a name="line-1372"></a><span class='hs-comment'>-- predicate. This function is subject to array fusion.</span>
<a name="line-1373"></a><span class='hs-definition'>filter</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-1374"></a><span class='hs-definition'>filter</span> <span class='hs-varid'>k</span> <span class='hs-varid'>ps</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>
<a name="line-1375"></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'>ps</span>
<a name="line-1376"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>createAndTrim</span> <span class='hs-varid'>l</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1377"></a>        <span class='hs-varid'>t</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span> <span class='hs-varop'>+</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1378"></a>        <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>t</span> <span class='hs-varop'>`minusPtr`</span> <span class='hs-varid'>p</span> <span class='hs-comment'>-- actual length</span>
<a name="line-1379"></a>    <span class='hs-keyword'>where</span>
<a name="line-1380"></a>        <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-1381"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-varid'>end</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>f</span> <span class='hs-varop'>==</span> <span class='hs-varid'>end</span>  <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>t</span>
<a name="line-1382"></a>                   <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1383"></a>                        <span class='hs-varid'>w</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>f</span>
<a name="line-1384"></a>                        <span class='hs-keyword'>if</span> <span class='hs-varid'>k</span> <span class='hs-varid'>w</span>
<a name="line-1385"></a>                            <span class='hs-keyword'>then</span> <span class='hs-varid'>poke</span> <span class='hs-varid'>t</span> <span class='hs-varid'>w</span> <span class='hs-varop'>&gt;&gt;</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>end</span>
<a name="line-1386"></a>                            <span class='hs-keyword'>else</span>             <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>t</span>               <span class='hs-varid'>end</span>
<a name="line-1387"></a><span class='hs-comment'>{-# INLINE filter #-}</span>
<a name="line-1388"></a>
<a name="line-1389"></a><span class='hs-comment'>{-
<a name="line-1390"></a>--
<a name="line-1391"></a>-- | /O(n)/ A first order equivalent of /filter . (==)/, for the common
<a name="line-1392"></a>-- case of filtering a single byte. It is more efficient to use
<a name="line-1393"></a>-- /filterByte/ in this case.
<a name="line-1394"></a>--
<a name="line-1395"></a>-- &gt; filterByte == filter . (==)
<a name="line-1396"></a>--
<a name="line-1397"></a>-- filterByte is around 10x faster, and uses much less space, than its
<a name="line-1398"></a>-- filter equivalent
<a name="line-1399"></a>--
<a name="line-1400"></a>filterByte :: Word8 -&gt; ByteString -&gt; ByteString
<a name="line-1401"></a>filterByte w ps = replicate (count w ps) w
<a name="line-1402"></a>{-# INLINE filterByte #-}
<a name="line-1403"></a>
<a name="line-1404"></a>{-# RULES
<a name="line-1405"></a>"ByteString specialise filter (== x)" forall x.
<a name="line-1406"></a>    filter ((==) x) = filterByte x
<a name="line-1407"></a>"ByteString specialise filter (== x)" forall x.
<a name="line-1408"></a>    filter (== x) = filterByte x
<a name="line-1409"></a>  #-}
<a name="line-1410"></a>-}</span>
<a name="line-1411"></a>
<a name="line-1412"></a><a name="find"></a><span class='hs-comment'>-- | /O(n)/ The 'find' function takes a predicate and a ByteString,</span>
<a name="line-1413"></a><span class='hs-comment'>-- and returns the first element in matching the predicate, or 'Nothing'</span>
<a name="line-1414"></a><span class='hs-comment'>-- if there is no such element.</span>
<a name="line-1415"></a><span class='hs-comment'>--</span>
<a name="line-1416"></a><span class='hs-comment'>-- &gt; find f p = case findIndex f p of Just n -&gt; Just (p ! n) ; _ -&gt; Nothing</span>
<a name="line-1417"></a><span class='hs-comment'>--</span>
<a name="line-1418"></a><span class='hs-definition'>find</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Word8</span>
<a name="line-1419"></a><span class='hs-definition'>find</span> <span class='hs-varid'>f</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>findIndex</span> <span class='hs-varid'>f</span> <span class='hs-varid'>p</span> <span class='hs-keyword'>of</span>
<a name="line-1420"></a>                    <span class='hs-conid'>Just</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`unsafeIndex`</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span>
<a name="line-1421"></a>                    <span class='hs-keyword'>_</span>      <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Nothing</span>
<a name="line-1422"></a><span class='hs-comment'>{-# INLINE find #-}</span>
<a name="line-1423"></a>
<a name="line-1424"></a><span class='hs-comment'>{-
<a name="line-1425"></a>--
<a name="line-1426"></a>-- fuseable, but we don't want to walk the whole array.
<a name="line-1427"></a>-- 
<a name="line-1428"></a>find k = foldl findEFL Nothing
<a name="line-1429"></a>    where findEFL a@(Just _) _ = a
<a name="line-1430"></a>          findEFL _          c | k c       = Just c
<a name="line-1431"></a>                               | otherwise = Nothing
<a name="line-1432"></a>-}</span>
<a name="line-1433"></a>
<a name="line-1434"></a><a name="partition"></a><span class='hs-comment'>-- | /O(n)/ The 'partition' function takes a predicate a ByteString and returns</span>
<a name="line-1435"></a><span class='hs-comment'>-- the pair of ByteStrings with elements which do and do not satisfy the</span>
<a name="line-1436"></a><span class='hs-comment'>-- predicate, respectively; i.e.,</span>
<a name="line-1437"></a><span class='hs-comment'>--</span>
<a name="line-1438"></a><span class='hs-comment'>-- &gt; partition p bs == (filter p xs, filter (not . p) xs)</span>
<a name="line-1439"></a><span class='hs-comment'>--</span>
<a name="line-1440"></a><span class='hs-definition'>partition</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</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-1441"></a><span class='hs-definition'>partition</span> <span class='hs-varid'>p</span> <span class='hs-varid'>bs</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>filter</span> <span class='hs-varid'>p</span> <span class='hs-varid'>bs</span><span class='hs-layout'>,</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <span class='hs-varid'>bs</span><span class='hs-layout'>)</span>
<a name="line-1442"></a><span class='hs-comment'>--TODO: use a better implementation</span>
<a name="line-1443"></a>
<a name="line-1444"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1445"></a><span class='hs-comment'>-- Searching for substrings</span>
<a name="line-1446"></a>
<a name="line-1447"></a><a name="isPrefixOf"></a><span class='hs-comment'>-- | /O(n)/ The 'isPrefixOf' function takes two ByteStrings and returns 'True'</span>
<a name="line-1448"></a><span class='hs-comment'>-- iff the first is a prefix of the second.</span>
<a name="line-1449"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-1450"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x1</span> <span class='hs-varid'>s1</span> <span class='hs-varid'>l1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x2</span> <span class='hs-varid'>s2</span> <span class='hs-varid'>l2</span><span class='hs-layout'>)</span>
<a name="line-1451"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l1</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>   <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span>
<a name="line-1452"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l2</span> <span class='hs-varop'>&lt;</span> <span class='hs-varid'>l1</span>   <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span>
<a name="line-1453"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</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'>x1</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p1</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1454"></a>        <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x2</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p2</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1455"></a>            <span class='hs-varid'>i</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>memcmp</span> <span class='hs-layout'>(</span><span class='hs-varid'>p1</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p2</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s2</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l1</span><span class='hs-layout'>)</span>
<a name="line-1456"></a>            <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>i</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>
<a name="line-1457"></a>
<a name="line-1458"></a><a name="isSuffixOf"></a><span class='hs-comment'>-- | /O(n)/ The 'isSuffixOf' function takes two ByteStrings and returns 'True'</span>
<a name="line-1459"></a><span class='hs-comment'>-- iff the first is a suffix of the second.</span>
<a name="line-1460"></a><span class='hs-comment'>-- </span>
<a name="line-1461"></a><span class='hs-comment'>-- The following holds:</span>
<a name="line-1462"></a><span class='hs-comment'>--</span>
<a name="line-1463"></a><span class='hs-comment'>-- &gt; isSuffixOf x y == reverse x `isPrefixOf` reverse y</span>
<a name="line-1464"></a><span class='hs-comment'>--</span>
<a name="line-1465"></a><span class='hs-comment'>-- However, the real implemenation uses memcmp to compare the end of the</span>
<a name="line-1466"></a><span class='hs-comment'>-- string only, with no reverse required..</span>
<a name="line-1467"></a><span class='hs-definition'>isSuffixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-1468"></a><span class='hs-definition'>isSuffixOf</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x1</span> <span class='hs-varid'>s1</span> <span class='hs-varid'>l1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x2</span> <span class='hs-varid'>s2</span> <span class='hs-varid'>l2</span><span class='hs-layout'>)</span>
<a name="line-1469"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l1</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>   <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span>
<a name="line-1470"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l2</span> <span class='hs-varop'>&lt;</span> <span class='hs-varid'>l1</span>   <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span>
<a name="line-1471"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</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'>x1</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p1</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1472"></a>        <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x2</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p2</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1473"></a>            <span class='hs-varid'>i</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>memcmp</span> <span class='hs-layout'>(</span><span class='hs-varid'>p1</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>p2</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s2</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>l2</span> <span class='hs-comment'>-</span> <span class='hs-varid'>l1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l1</span><span class='hs-layout'>)</span>
<a name="line-1474"></a>            <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>i</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>
<a name="line-1475"></a>
<a name="line-1476"></a><a name="isInfixOf"></a><span class='hs-comment'>-- | Check whether one string is a substring of another. @isInfixOf</span>
<a name="line-1477"></a><span class='hs-comment'>-- p s@ is equivalent to @not (null (findSubstrings p s))@.</span>
<a name="line-1478"></a><span class='hs-definition'>isInfixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span>
<a name="line-1479"></a><span class='hs-definition'>isInfixOf</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>isJust</span> <span class='hs-layout'>(</span><span class='hs-varid'>findSubstring</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1480"></a>
<a name="line-1481"></a><a name="breakSubstring"></a><span class='hs-comment'>-- | Break a string on a substring, returning a pair of the part of the</span>
<a name="line-1482"></a><span class='hs-comment'>-- string prior to the match, and the rest of the string.</span>
<a name="line-1483"></a><span class='hs-comment'>--</span>
<a name="line-1484"></a><span class='hs-comment'>-- The following relationships hold:</span>
<a name="line-1485"></a><span class='hs-comment'>--</span>
<a name="line-1486"></a><span class='hs-comment'>-- &gt; break (== c) l == breakSubstring (singleton c) l</span>
<a name="line-1487"></a><span class='hs-comment'>--</span>
<a name="line-1488"></a><span class='hs-comment'>-- and:</span>
<a name="line-1489"></a><span class='hs-comment'>--</span>
<a name="line-1490"></a><span class='hs-comment'>-- &gt; findSubstring s l ==</span>
<a name="line-1491"></a><span class='hs-comment'>-- &gt;    if null s then Just 0</span>
<a name="line-1492"></a><span class='hs-comment'>-- &gt;              else case breakSubstring s l of</span>
<a name="line-1493"></a><span class='hs-comment'>-- &gt;                       (x,y) | null y    -&gt; Nothing</span>
<a name="line-1494"></a><span class='hs-comment'>-- &gt;                             | otherwise -&gt; Just (length x)</span>
<a name="line-1495"></a><span class='hs-comment'>--</span>
<a name="line-1496"></a><span class='hs-comment'>-- For example, to tokenise a string, dropping delimiters:</span>
<a name="line-1497"></a><span class='hs-comment'>--</span>
<a name="line-1498"></a><span class='hs-comment'>-- &gt; tokenise x y = h : if null t then [] else tokenise x (drop (length x) t)</span>
<a name="line-1499"></a><span class='hs-comment'>-- &gt;     where (h,t) = breakSubstring x y</span>
<a name="line-1500"></a><span class='hs-comment'>--</span>
<a name="line-1501"></a><span class='hs-comment'>-- To skip to the first occurence of a string:</span>
<a name="line-1502"></a><span class='hs-comment'>-- </span>
<a name="line-1503"></a><span class='hs-comment'>-- &gt; snd (breakSubstring x y) </span>
<a name="line-1504"></a><span class='hs-comment'>--</span>
<a name="line-1505"></a><span class='hs-comment'>-- To take the parts of a string before a delimiter:</span>
<a name="line-1506"></a><span class='hs-comment'>--</span>
<a name="line-1507"></a><span class='hs-comment'>-- &gt; fst (breakSubstring x y) </span>
<a name="line-1508"></a><span class='hs-comment'>--</span>
<a name="line-1509"></a><span class='hs-definition'>breakSubstring</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ String to search for</span>
<a name="line-1510"></a>               <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ String to search in</span>
<a name="line-1511"></a>               <span class='hs-keyglyph'>-&gt;</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> <span class='hs-comment'>-- ^ Head and tail of string broken at substring</span>
<a name="line-1512"></a>
<a name="line-1513"></a><span class='hs-definition'>breakSubstring</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>search</span> <span class='hs-num'>0</span> <span class='hs-varid'>src</span>
<a name="line-1514"></a>  <span class='hs-keyword'>where</span>
<a name="line-1515"></a>    <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>search</span><span class='hs-layout'>)</span>
<a name="line-1516"></a>    <span class='hs-varid'>search</span> <span class='hs-varid'>n</span> <span class='hs-varid'>s</span>
<a name="line-1517"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>s</span>             <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>src</span><span class='hs-layout'>,</span><span class='hs-varid'>empty</span><span class='hs-layout'>)</span>      <span class='hs-comment'>-- not found</span>
<a name="line-1518"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>pat</span> <span class='hs-varop'>`isPrefixOf`</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>take</span> <span class='hs-varid'>n</span> <span class='hs-varid'>src</span><span class='hs-layout'>,</span><span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1519"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>          <span class='hs-keyglyph'>=</span> <span class='hs-varid'>search</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-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1520"></a>
<a name="line-1521"></a><a name="findSubstring"></a><span class='hs-comment'>-- | Get the first index of a substring in another string,</span>
<a name="line-1522"></a><span class='hs-comment'>--   or 'Nothing' if the string is not found.</span>
<a name="line-1523"></a><span class='hs-comment'>--   @findSubstring p s@ is equivalent to @listToMaybe (findSubstrings p s)@.</span>
<a name="line-1524"></a><span class='hs-definition'>findSubstring</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ String to search for.</span>
<a name="line-1525"></a>              <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ String to seach in.</span>
<a name="line-1526"></a>              <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-1527"></a><span class='hs-definition'>findSubstring</span> <span class='hs-varid'>f</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>listToMaybe</span> <span class='hs-layout'>(</span><span class='hs-varid'>findSubstrings</span> <span class='hs-varid'>f</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span>
<a name="line-1528"></a>
<a name="line-1529"></a><span class='hs-comment'>{-# DEPRECATED findSubstring "findSubstring is deprecated in favour of breakSubstring." #-}</span>
<a name="line-1530"></a>
<a name="line-1531"></a><span class='hs-comment'>{-
<a name="line-1532"></a>findSubstring pat str = search 0 str
<a name="line-1533"></a>    where
<a name="line-1534"></a>        STRICT2(search)
<a name="line-1535"></a>        search n s
<a name="line-1536"></a>            = let x = pat `isPrefixOf` s
<a name="line-1537"></a>              in
<a name="line-1538"></a>                if null s
<a name="line-1539"></a>                    then if x then Just n else Nothing
<a name="line-1540"></a>                    else if x then Just n
<a name="line-1541"></a>                              else     search (n+1) (unsafeTail s)
<a name="line-1542"></a>-}</span>
<a name="line-1543"></a>
<a name="line-1544"></a><a name="findSubstrings"></a><span class='hs-comment'>-- | Find the indexes of all (possibly overlapping) occurances of a</span>
<a name="line-1545"></a><span class='hs-comment'>-- substring in a string.</span>
<a name="line-1546"></a><span class='hs-comment'>--</span>
<a name="line-1547"></a><span class='hs-definition'>findSubstrings</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ String to search for.</span>
<a name="line-1548"></a>               <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-comment'>-- ^ String to seach in.</span>
<a name="line-1549"></a>               <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Int</span><span class='hs-keyglyph'>]</span>
<a name="line-1550"></a><span class='hs-definition'>findSubstrings</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>str</span>
<a name="line-1551"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>pat</span>         <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>0</span> <span class='hs-keyglyph'>..</span> <span class='hs-varid'>length</span> <span class='hs-varid'>str</span><span class='hs-keyglyph'>]</span>
<a name="line-1552"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>        <span class='hs-keyglyph'>=</span> <span class='hs-varid'>search</span> <span class='hs-num'>0</span> <span class='hs-varid'>str</span>
<a name="line-1553"></a>  <span class='hs-keyword'>where</span>
<a name="line-1554"></a>    <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>search</span><span class='hs-layout'>)</span>
<a name="line-1555"></a>    <span class='hs-varid'>search</span> <span class='hs-varid'>n</span> <span class='hs-varid'>s</span>
<a name="line-1556"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>s</span>             <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-1557"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>pat</span> <span class='hs-varop'>`isPrefixOf`</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>n</span> <span class='hs-conop'>:</span> <span class='hs-varid'>search</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-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1558"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>          <span class='hs-keyglyph'>=</span>     <span class='hs-varid'>search</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-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1559"></a>
<a name="line-1560"></a><span class='hs-comment'>{-# DEPRECATED findSubstrings "findSubstrings is deprecated in favour of breakSubstring." #-}</span>
<a name="line-1561"></a>
<a name="line-1562"></a><span class='hs-comment'>{-
<a name="line-1563"></a>{- This function uses the Knuth-Morris-Pratt string matching algorithm.  -}
<a name="line-1564"></a>
<a name="line-1565"></a>findSubstrings pat@(PS _ _ m) str@(PS _ _ n) = search 0 0
<a name="line-1566"></a>  where
<a name="line-1567"></a>      patc x = pat `unsafeIndex` x
<a name="line-1568"></a>      strc x = str `unsafeIndex` x
<a name="line-1569"></a>
<a name="line-1570"></a>      -- maybe we should make kmpNext a UArray before using it in search?
<a name="line-1571"></a>      kmpNext = listArray (0,m) (-1:kmpNextL pat (-1))
<a name="line-1572"></a>      kmpNextL p _ | null p = []
<a name="line-1573"></a>      kmpNextL p j = let j' = next (unsafeHead p) j + 1
<a name="line-1574"></a>                         ps = unsafeTail p
<a name="line-1575"></a>                         x = if not (null ps) &amp;&amp; unsafeHead ps == patc j'
<a name="line-1576"></a>                                then kmpNext Array.! j' else j'
<a name="line-1577"></a>                        in x:kmpNextL ps j'
<a name="line-1578"></a>      search i j = match ++ rest -- i: position in string, j: position in pattern
<a name="line-1579"></a>        where match = if j == m then [(i - j)] else []
<a name="line-1580"></a>              rest = if i == n then [] else search (i+1) (next (strc i) j + 1)
<a name="line-1581"></a>      next c j | j &gt;= 0 &amp;&amp; (j == m || c /= patc j) = next c (kmpNext Array.! j)
<a name="line-1582"></a>               | otherwise = j
<a name="line-1583"></a>-}</span>
<a name="line-1584"></a>
<a name="line-1585"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1586"></a><span class='hs-comment'>-- Zipping</span>
<a name="line-1587"></a>
<a name="line-1588"></a><a name="zip"></a><span class='hs-comment'>-- | /O(n)/ 'zip' takes two ByteStrings and returns a list of</span>
<a name="line-1589"></a><span class='hs-comment'>-- corresponding pairs of bytes. If one input ByteString is short,</span>
<a name="line-1590"></a><span class='hs-comment'>-- excess elements of the longer ByteString are discarded. This is</span>
<a name="line-1591"></a><span class='hs-comment'>-- equivalent to a pair of 'unpack' operations.</span>
<a name="line-1592"></a><span class='hs-definition'>zip</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-1593"></a><span class='hs-definition'>zip</span> <span class='hs-varid'>ps</span> <span class='hs-varid'>qs</span>
<a name="line-1594"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</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-1595"></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-varid'>unsafeTail</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>qs</span><span class='hs-layout'>)</span>
<a name="line-1596"></a>
<a name="line-1597"></a><a name="zipWith"></a><span class='hs-comment'>-- | 'zipWith' generalises 'zip' by zipping with the function given as</span>
<a name="line-1598"></a><span class='hs-comment'>-- the first argument, instead of a tupling function.  For example,</span>
<a name="line-1599"></a><span class='hs-comment'>-- @'zipWith' (+)@ is applied to two ByteStrings to produce the list of</span>
<a name="line-1600"></a><span class='hs-comment'>-- corresponding sums. </span>
<a name="line-1601"></a><span class='hs-definition'>zipWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-1602"></a><span class='hs-definition'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</span> <span class='hs-varid'>qs</span>
<a name="line-1603"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</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-1604"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</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-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'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</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-varid'>unsafeTail</span> <span class='hs-varid'>qs</span><span class='hs-layout'>)</span>
<a name="line-1605"></a>
<a name="line-1606"></a><a name="zipWith'"></a><span class='hs-comment'>--</span>
<a name="line-1607"></a><span class='hs-comment'>-- | A specialised version of zipWith for the common case of a</span>
<a name="line-1608"></a><span class='hs-comment'>-- simultaneous map over two bytestrings, to build a 3rd. Rewrite rules</span>
<a name="line-1609"></a><span class='hs-comment'>-- are used to automatically covert zipWith into zipWith' when a pack is</span>
<a name="line-1610"></a><span class='hs-comment'>-- performed on the result of zipWith.</span>
<a name="line-1611"></a><span class='hs-comment'>--</span>
<a name="line-1612"></a><span class='hs-definition'>zipWith'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Word8</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-1613"></a><span class='hs-definition'>zipWith'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>s</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fq</span> <span class='hs-varid'>t</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inlinePerformIO</span> <span class='hs-varop'>$</span>
<a name="line-1614"></a>    <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1615"></a>    <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>fq</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1616"></a>    <span class='hs-varid'>create</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-varid'>zipWith_</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span>
<a name="line-1617"></a>  <span class='hs-keyword'>where</span>
<a name="line-1618"></a>    <span class='hs-varid'>zipWith_</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1619"></a>    <span class='hs-conid'>STRICT4</span><span class='hs-layout'>(</span><span class='hs-varid'>zipWith_</span><span class='hs-layout'>)</span>
<a name="line-1620"></a>    <span class='hs-varid'>zipWith_</span> <span class='hs-varid'>n</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>p2</span> <span class='hs-varid'>r</span>
<a name="line-1621"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-1622"></a>       <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1623"></a>            <span class='hs-varid'>x</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>n</span>
<a name="line-1624"></a>            <span class='hs-varid'>y</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekByteOff</span> <span class='hs-varid'>p2</span> <span class='hs-varid'>n</span>
<a name="line-1625"></a>            <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>r</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-1626"></a>            <span class='hs-varid'>zipWith_</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'>p1</span> <span class='hs-varid'>p2</span> <span class='hs-varid'>r</span>
<a name="line-1627"></a>
<a name="line-1628"></a>    <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>min</span> <span class='hs-varid'>l</span> <span class='hs-varid'>m</span>
<a name="line-1629"></a><span class='hs-comment'>{-# INLINE zipWith' #-}</span>
<a name="line-1630"></a>
<a name="line-1631"></a><span class='hs-comment'>{-# RULES
<a name="line-1632"></a>"ByteString specialise zipWith" forall (f :: Word8 -&gt; Word8 -&gt; Word8) p q .
<a name="line-1633"></a>    zipWith f p q = unpack (zipWith' f p q)
<a name="line-1634"></a>  #-}</span>
<a name="line-1635"></a>
<a name="line-1636"></a><a name="unzip"></a><span class='hs-comment'>-- | /O(n)/ 'unzip' transforms a list of pairs of bytes into a pair of</span>
<a name="line-1637"></a><span class='hs-comment'>-- ByteStrings. Note that this performs two 'pack' operations.</span>
<a name="line-1638"></a><span class='hs-definition'>unzip</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Word8</span><span class='hs-layout'>,</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-&gt;</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-1639"></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-1640"></a><span class='hs-comment'>{-# INLINE unzip #-}</span>
<a name="line-1641"></a>
<a name="line-1642"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1643"></a><span class='hs-comment'>-- Special lists</span>
<a name="line-1644"></a>
<a name="line-1645"></a><a name="inits"></a><span class='hs-comment'>-- | /O(n)/ Return all initial segments of the given 'ByteString', shortest first.</span>
<a name="line-1646"></a><span class='hs-definition'>inits</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1647"></a><span class='hs-definition'>inits</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-keyglyph'>[</span><span class='hs-conid'>PS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>s</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>0</span><span class='hs-keyglyph'>..</span><span class='hs-varid'>l</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>]</span>
<a name="line-1648"></a>
<a name="line-1649"></a><a name="tails"></a><span class='hs-comment'>-- | /O(n)/ Return all final segments of the given 'ByteString', longest first.</span>
<a name="line-1650"></a><span class='hs-definition'>tails</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span>
<a name="line-1651"></a><span class='hs-definition'>tails</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>p</span>    <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>empty</span><span class='hs-keyglyph'>]</span>
<a name="line-1652"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>p</span> <span class='hs-conop'>:</span> <span class='hs-varid'>tails</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span>
<a name="line-1653"></a>
<a name="line-1654"></a><span class='hs-comment'>-- less efficent spacewise: tails (PS x s l) = [PS x (s+n) (l-n) | n &lt;- [0..l]]</span>
<a name="line-1655"></a>
<a name="line-1656"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1657"></a><span class='hs-comment'>-- ** Ordered 'ByteString's</span>
<a name="line-1658"></a>
<a name="line-1659"></a><a name="sort"></a><span class='hs-comment'>-- | /O(n)/ Sort a ByteString efficiently, using counting sort.</span>
<a name="line-1660"></a><span class='hs-definition'>sort</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-1661"></a><span class='hs-definition'>sort</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>input</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'>unsafeCreate</span> <span class='hs-varid'>l</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>allocaArray</span> <span class='hs-num'>256</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>arr</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1662"></a>
<a name="line-1663"></a>    <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>memset</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>arr</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-num'>256</span> <span class='hs-varop'>*</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-varid'>sizeOf</span> <span class='hs-layout'>(</span><span class='hs-varid'>undefined</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>CSize</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1664"></a>    <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>input</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>countOccurrences</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-1665"></a>
<a name="line-1666"></a>    <span class='hs-keyword'>let</span> <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-1667"></a>        <span class='hs-varid'>go</span> <span class='hs-num'>256</span> <span class='hs-keyword'>_</span>   <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-1668"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>i</span>   <span class='hs-varid'>ptr</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekElemOff</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>i</span>
<a name="line-1669"></a>                        <span class='hs-varid'>when</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span> <span class='hs-varop'>/=</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>memset</span> <span class='hs-varid'>ptr</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;&gt;</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-1670"></a>                        <span class='hs-varid'>go</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> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1671"></a>    <span class='hs-varid'>go</span> <span class='hs-num'>0</span> <span class='hs-varid'>p</span>
<a name="line-1672"></a>  <span class='hs-keyword'>where</span>
<a name="line-1673"></a>    <span class='hs-comment'>-- | Count the number of occurrences of each byte.</span>
<a name="line-1674"></a>    <span class='hs-comment'>-- Used by 'sort'</span>
<a name="line-1675"></a>    <span class='hs-comment'>--</span>
<a name="line-1676"></a>    <span class='hs-varid'>countOccurrences</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>CSize</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Ptr</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1677"></a>    <span class='hs-conid'>STRICT3</span><span class='hs-layout'>(</span><span class='hs-varid'>countOccurrences</span><span class='hs-layout'>)</span>
<a name="line-1678"></a>    <span class='hs-varid'>countOccurrences</span> <span class='hs-varid'>counts</span> <span class='hs-varid'>str</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-num'>0</span>
<a name="line-1679"></a>     <span class='hs-keyword'>where</span>
<a name="line-1680"></a>        <span class='hs-conid'>STRICT1</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-1681"></a>        <span class='hs-varid'>go</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>==</span> <span class='hs-varid'>len</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-1682"></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'>k</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varop'>`fmap`</span> <span class='hs-varid'>peekElemOff</span> <span class='hs-varid'>str</span> <span class='hs-varid'>i</span>
<a name="line-1683"></a>                              <span class='hs-varid'>x</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>peekElemOff</span> <span class='hs-varid'>counts</span> <span class='hs-varid'>k</span>
<a name="line-1684"></a>                              <span class='hs-varid'>pokeElemOff</span> <span class='hs-varid'>counts</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-1685"></a>                              <span class='hs-varid'>go</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-1686"></a>
<a name="line-1687"></a><span class='hs-comment'>{-
<a name="line-1688"></a>sort :: ByteString -&gt; ByteString
<a name="line-1689"></a>sort (PS x s l) = unsafeCreate l $ \p -&gt; withForeignPtr x $ \f -&gt; do
<a name="line-1690"></a>        memcpy p (f `plusPtr` s) l
<a name="line-1691"></a>        c_qsort p l -- inplace
<a name="line-1692"></a>-}</span>
<a name="line-1693"></a>
<a name="line-1694"></a><span class='hs-comment'>-- The 'sortBy' function is the non-overloaded version of 'sort'.</span>
<a name="line-1695"></a><span class='hs-comment'>--</span>
<a name="line-1696"></a><span class='hs-comment'>-- Try some linear sorts: radix, counting</span>
<a name="line-1697"></a><span class='hs-comment'>-- Or mergesort.</span>
<a name="line-1698"></a><span class='hs-comment'>--</span>
<a name="line-1699"></a><span class='hs-comment'>-- sortBy :: (Word8 -&gt; Word8 -&gt; Ordering) -&gt; ByteString -&gt; ByteString</span>
<a name="line-1700"></a><span class='hs-comment'>-- sortBy f ps = undefined</span>
<a name="line-1701"></a>
<a name="line-1702"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1703"></a><span class='hs-comment'>-- Low level constructors</span>
<a name="line-1704"></a>
<a name="line-1705"></a><a name="useAsCString"></a><span class='hs-comment'>-- | /O(n) construction/ Use a @ByteString@ with a function requiring a</span>
<a name="line-1706"></a><span class='hs-comment'>-- null-terminated @CString@.  The @CString@ will be freed</span>
<a name="line-1707"></a><span class='hs-comment'>-- automatically. This is a memcpy(3).</span>
<a name="line-1708"></a><span class='hs-definition'>useAsCString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-conid'>CString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-1709"></a><span class='hs-definition'>useAsCString</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>o</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>action</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1710"></a> <span class='hs-varid'>allocaBytes</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>buf</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1711"></a>   <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1712"></a>     <span class='hs-varid'>memcpy</span> <span class='hs-varid'>buf</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>o</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-1713"></a>     <span class='hs-varid'>pokeByteOff</span> <span class='hs-varid'>buf</span> <span class='hs-varid'>l</span> <span class='hs-layout'>(</span><span class='hs-num'>0</span><span class='hs-keyglyph'>::</span><span class='hs-conid'>Word8</span><span class='hs-layout'>)</span>
<a name="line-1714"></a>     <span class='hs-varid'>action</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>buf</span><span class='hs-layout'>)</span>
<a name="line-1715"></a>
<a name="line-1716"></a><a name="useAsCStringLen"></a><span class='hs-comment'>-- | /O(n) construction/ Use a @ByteString@ with a function requiring a @CStringLen@.</span>
<a name="line-1717"></a><span class='hs-comment'>-- As for @useAsCString@ this function makes a copy of the original @ByteString@.</span>
<a name="line-1718"></a><span class='hs-definition'>useAsCStringLen</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-conid'>CStringLen</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-1719"></a><span class='hs-definition'>useAsCStringLen</span> <span class='hs-varid'>p</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>useAsCString</span> <span class='hs-varid'>p</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>cstr</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>cstr</span><span class='hs-layout'>,</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-1720"></a>
<a name="line-1721"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-1722"></a>
<a name="line-1723"></a><a name="packCString"></a><span class='hs-comment'>-- | /O(n)./ Construct a new @ByteString@ from a @CString@. The</span>
<a name="line-1724"></a><span class='hs-comment'>-- resulting @ByteString@ is an immutable copy of the original</span>
<a name="line-1725"></a><span class='hs-comment'>-- @CString@, and is managed on the Haskell heap. The original</span>
<a name="line-1726"></a><span class='hs-comment'>-- @CString@ must be null terminated.</span>
<a name="line-1727"></a><span class='hs-definition'>packCString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>CString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1728"></a><span class='hs-definition'>packCString</span> <span class='hs-varid'>cstr</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1729"></a>    <span class='hs-varid'>len</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>c_strlen</span> <span class='hs-varid'>cstr</span>
<a name="line-1730"></a>    <span class='hs-varid'>packCStringLen</span> <span class='hs-layout'>(</span><span class='hs-varid'>cstr</span><span class='hs-layout'>,</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-1731"></a>
<a name="line-1732"></a><a name="packCStringLen"></a><span class='hs-comment'>-- | /O(n)./ Construct a new @ByteString@ from a @CStringLen@. The</span>
<a name="line-1733"></a><span class='hs-comment'>-- resulting @ByteString@ is an immutable copy of the original @CStringLen@.</span>
<a name="line-1734"></a><span class='hs-comment'>-- The @ByteString@ is a normal Haskell value and will be managed on the</span>
<a name="line-1735"></a><span class='hs-comment'>-- Haskell heap.</span>
<a name="line-1736"></a><span class='hs-definition'>packCStringLen</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>CStringLen</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1737"></a><span class='hs-definition'>packCStringLen</span> <span class='hs-layout'>(</span><span class='hs-varid'>cstr</span><span class='hs-layout'>,</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'>&gt;=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>create</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1738"></a>    <span class='hs-varid'>memcpy</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>cstr</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-1739"></a><span class='hs-definition'>packCStringLen</span> <span class='hs-layout'>(</span><span class='hs-keyword'>_</span><span class='hs-layout'>,</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span>
<a name="line-1740"></a>    <span class='hs-varid'>moduleError</span> <span class='hs-str'>"packCStringLen"</span> <span class='hs-layout'>(</span><span class='hs-str'>"negative length: "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-1741"></a>
<a name="line-1742"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-1743"></a>
<a name="line-1744"></a><a name="copy"></a><span class='hs-comment'>-- | /O(n)/ Make a copy of the 'ByteString' with its own storage. </span>
<a name="line-1745"></a><span class='hs-comment'>-- This is mainly useful to allow the rest of the data pointed</span>
<a name="line-1746"></a><span class='hs-comment'>-- to by the 'ByteString' to be garbage collected, for example</span>
<a name="line-1747"></a><span class='hs-comment'>-- if a large string has been read in, and only a small part of it </span>
<a name="line-1748"></a><span class='hs-comment'>-- is needed in the rest of the program.</span>
<a name="line-1749"></a><span class='hs-comment'>-- </span>
<a name="line-1750"></a><span class='hs-definition'>copy</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span>
<a name="line-1751"></a><span class='hs-definition'>copy</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'>unsafeCreate</span> <span class='hs-varid'>l</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1752"></a>    <span class='hs-varid'>memcpy</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-1753"></a>
<a name="line-1754"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1755"></a><span class='hs-comment'>-- Line IO</span>
<a name="line-1756"></a>
<a name="line-1757"></a><a name="getLine"></a><span class='hs-comment'>-- | Read a line from stdin.</span>
<a name="line-1758"></a><span class='hs-definition'>getLine</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1759"></a><span class='hs-definition'>getLine</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetLine</span> <span class='hs-varid'>stdin</span>
<a name="line-1760"></a>
<a name="line-1761"></a><span class='hs-comment'>-- | Read a line from a handle</span>
<a name="line-1762"></a>
<a name="line-1763"></a><a name="hGetLine"></a><span class='hs-definition'>hGetLine</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1764"></a>
<a name="line-1765"></a><span class='hs-cpp'>#if !defined(__GLASGOW_HASKELL__)</span>
<a name="line-1766"></a>
<a name="line-1767"></a><span class='hs-definition'>hGetLine</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-varid'>hGetLine</span> <span class='hs-varid'>h</span> <span class='hs-varop'>&gt;&gt;=</span> <span class='hs-varid'>return</span> <span class='hs-varop'>.</span> <span class='hs-varid'>pack</span> <span class='hs-varop'>.</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>c2w</span>
<a name="line-1768"></a>
<a name="line-1769"></a><span class='hs-cpp'>#elif __GLASGOW_HASKELL__ &gt;= 611</span>
<a name="line-1770"></a>
<a name="line-1771"></a><span class='hs-definition'>hGetLine</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>=</span>
<a name="line-1772"></a>  <span class='hs-varid'>wantReadableHandle_</span> <span class='hs-str'>"Data.ByteString.hGetLine"</span> <span class='hs-varid'>h</span> <span class='hs-varop'>$</span>
<a name="line-1773"></a>    <span class='hs-keyglyph'>\</span> <span class='hs-varid'>h_</span><span class='hs-keyglyph'>@</span><span class='hs-conid'>Handle__</span><span class='hs-layout'>{</span><span class='hs-varid'>haByteBuffer</span><span class='hs-layout'>}</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1774"></a>      <span class='hs-varid'>flushCharReadBuffer</span> <span class='hs-varid'>h_</span>
<a name="line-1775"></a>      <span class='hs-varid'>buf</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>readIORef</span> <span class='hs-varid'>haByteBuffer</span>
<a name="line-1776"></a>      <span class='hs-keyword'>if</span> <span class='hs-varid'>isEmptyBuffer</span> <span class='hs-varid'>buf</span>
<a name="line-1777"></a>         <span class='hs-keyword'>then</span> <span class='hs-varid'>fill</span> <span class='hs-varid'>h_</span> <span class='hs-varid'>buf</span> <span class='hs-num'>0</span> <span class='hs-conid'>[]</span>
<a name="line-1778"></a>         <span class='hs-keyword'>else</span> <span class='hs-varid'>haveBuf</span> <span class='hs-varid'>h_</span> <span class='hs-varid'>buf</span> <span class='hs-num'>0</span> <span class='hs-conid'>[]</span>
<a name="line-1779"></a> <span class='hs-keyword'>where</span>
<a name="line-1780"></a>
<a name="line-1781"></a>  <span class='hs-varid'>fill</span> <span class='hs-varid'>h_</span><span class='hs-keyglyph'>@</span><span class='hs-conid'>Handle__</span><span class='hs-layout'>{</span><span class='hs-varid'>haByteBuffer</span><span class='hs-layout'>,</span><span class='hs-varid'>haDevice</span><span class='hs-layout'>}</span> <span class='hs-varid'>buf</span> <span class='hs-varid'>len</span> <span class='hs-varid'>xss</span> <span class='hs-keyglyph'>=</span>
<a name="line-1782"></a>    <span class='hs-varid'>len</span> <span class='hs-varop'>`seq`</span> <span class='hs-keyword'>do</span>
<a name="line-1783"></a>    <span class='hs-layout'>(</span><span class='hs-varid'>r</span><span class='hs-layout'>,</span><span class='hs-varid'>buf'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-conid'>Buffered</span><span class='hs-varop'>.</span><span class='hs-varid'>fillReadBuffer</span> <span class='hs-varid'>haDevice</span> <span class='hs-varid'>buf</span>
<a name="line-1784"></a>    <span class='hs-keyword'>if</span> <span class='hs-varid'>r</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span>
<a name="line-1785"></a>       <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>haByteBuffer</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufR</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufL</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span> <span class='hs-layout'>}</span>
<a name="line-1786"></a>               <span class='hs-keyword'>if</span> <span class='hs-varid'>len</span> <span class='hs-varop'>&gt;</span> <span class='hs-num'>0</span>
<a name="line-1787"></a>                  <span class='hs-keyword'>then</span> <span class='hs-varid'>mkBigPS</span> <span class='hs-varid'>len</span> <span class='hs-varid'>xss</span>
<a name="line-1788"></a>                  <span class='hs-keyword'>else</span> <span class='hs-varid'>ioe_EOF</span>
<a name="line-1789"></a>       <span class='hs-keyword'>else</span> <span class='hs-varid'>haveBuf</span> <span class='hs-varid'>h_</span> <span class='hs-varid'>buf'</span> <span class='hs-varid'>len</span> <span class='hs-varid'>xss</span>
<a name="line-1790"></a>
<a name="line-1791"></a>  <span class='hs-varid'>haveBuf</span> <span class='hs-varid'>h_</span><span class='hs-keyglyph'>@</span><span class='hs-conid'>Handle__</span><span class='hs-layout'>{</span><span class='hs-varid'>haByteBuffer</span><span class='hs-layout'>}</span>
<a name="line-1792"></a>          <span class='hs-varid'>buf</span><span class='hs-keyglyph'>@</span><span class='hs-conid'>Buffer</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufRaw</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>raw</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufR</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>w</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufL</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>r</span> <span class='hs-layout'>}</span>
<a name="line-1793"></a>          <span class='hs-varid'>len</span> <span class='hs-varid'>xss</span> <span class='hs-keyglyph'>=</span>
<a name="line-1794"></a>    <span class='hs-keyword'>do</span>
<a name="line-1795"></a>        <span class='hs-varid'>off</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>findEOL</span> <span class='hs-varid'>r</span> <span class='hs-varid'>w</span> <span class='hs-varid'>raw</span>
<a name="line-1796"></a>        <span class='hs-keyword'>let</span> <span class='hs-varid'>new_len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>+</span> <span class='hs-varid'>off</span> <span class='hs-comment'>-</span> <span class='hs-varid'>r</span>
<a name="line-1797"></a>        <span class='hs-varid'>xs</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>mkPS</span> <span class='hs-varid'>raw</span> <span class='hs-varid'>r</span> <span class='hs-varid'>off</span>
<a name="line-1798"></a>
<a name="line-1799"></a>      <span class='hs-comment'>-- if eol == True, then off is the offset of the '\n'</span>
<a name="line-1800"></a>      <span class='hs-comment'>-- otherwise off == w and the buffer is now empty.</span>
<a name="line-1801"></a>        <span class='hs-keyword'>if</span> <span class='hs-varid'>off</span> <span class='hs-varop'>/=</span> <span class='hs-varid'>w</span>
<a name="line-1802"></a>            <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-keyword'>if</span> <span class='hs-layout'>(</span><span class='hs-varid'>w</span> <span class='hs-varop'>==</span> <span class='hs-varid'>off</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-1803"></a>                            <span class='hs-keyword'>then</span> <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>haByteBuffer</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufL</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufR</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span> <span class='hs-layout'>}</span>
<a name="line-1804"></a>                            <span class='hs-keyword'>else</span> <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>haByteBuffer</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufL</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>off</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span> <span class='hs-layout'>}</span>
<a name="line-1805"></a>                    <span class='hs-varid'>mkBigPS</span> <span class='hs-varid'>new_len</span> <span class='hs-layout'>(</span><span class='hs-varid'>xs</span><span class='hs-conop'>:</span><span class='hs-varid'>xss</span><span class='hs-layout'>)</span>
<a name="line-1806"></a>            <span class='hs-keyword'>else</span> <span class='hs-keyword'>do</span>
<a name="line-1807"></a>                 <span class='hs-varid'>fill</span> <span class='hs-varid'>h_</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufL</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufR</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span> <span class='hs-layout'>}</span> <span class='hs-varid'>new_len</span> <span class='hs-layout'>(</span><span class='hs-varid'>xs</span><span class='hs-conop'>:</span><span class='hs-varid'>xss</span><span class='hs-layout'>)</span>
<a name="line-1808"></a>
<a name="line-1809"></a>  <span class='hs-comment'>-- find the end-of-line character, if there is one</span>
<a name="line-1810"></a>  <span class='hs-varid'>findEOL</span> <span class='hs-varid'>r</span> <span class='hs-varid'>w</span> <span class='hs-varid'>raw</span>
<a name="line-1811"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>r</span> <span class='hs-varop'>==</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>w</span>
<a name="line-1812"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span>  <span class='hs-keyword'>do</span>
<a name="line-1813"></a>            <span class='hs-varid'>c</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>readWord8Buf</span> <span class='hs-varid'>raw</span> <span class='hs-varid'>r</span>
<a name="line-1814"></a>            <span class='hs-keyword'>if</span> <span class='hs-varid'>c</span> <span class='hs-varop'>==</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-layout'>(</span><span class='hs-varid'>ord</span> <span class='hs-chr'>'\n'</span><span class='hs-layout'>)</span>
<a name="line-1815"></a>                <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varid'>r</span> <span class='hs-comment'>-- NB. not r+1: don't include the '\n'</span>
<a name="line-1816"></a>                <span class='hs-keyword'>else</span> <span class='hs-varid'>findEOL</span> <span class='hs-layout'>(</span><span class='hs-varid'>r</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span> <span class='hs-varid'>raw</span>
<a name="line-1817"></a>
<a name="line-1818"></a><a name="mkPS"></a><span class='hs-definition'>mkPS</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>RawBuffer</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1819"></a><span class='hs-definition'>mkPS</span> <span class='hs-varid'>buf</span> <span class='hs-varid'>start</span> <span class='hs-varid'>end</span> <span class='hs-keyglyph'>=</span>
<a name="line-1820"></a> <span class='hs-varid'>create</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1821"></a>   <span class='hs-varid'>withRawBuffer</span> <span class='hs-varid'>buf</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>pbuf</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1822"></a>   <span class='hs-varid'>copyBytes</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>pbuf</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>start</span><span class='hs-layout'>)</span> <span class='hs-varid'>len</span>
<a name="line-1823"></a> <span class='hs-keyword'>where</span>
<a name="line-1824"></a>   <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>end</span> <span class='hs-comment'>-</span> <span class='hs-varid'>start</span>
<a name="line-1825"></a>
<a name="line-1826"></a><span class='hs-cpp'>#else</span>
<a name="line-1827"></a><span class='hs-comment'>-- GHC 6.10 and older, pre-Unicode IO library</span>
<a name="line-1828"></a>
<a name="line-1829"></a><span class='hs-definition'>hGetLine</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>wantReadableHandle</span> <span class='hs-str'>"Data.ByteString.hGetLine"</span> <span class='hs-varid'>h</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span> <span class='hs-varid'>handle_</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1830"></a>    <span class='hs-keyword'>case</span> <span class='hs-varid'>haBufferMode</span> <span class='hs-varid'>handle_</span> <span class='hs-keyword'>of</span>
<a name="line-1831"></a>       <span class='hs-conid'>NoBuffering</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>error</span> <span class='hs-str'>"no buffering"</span>
<a name="line-1832"></a>       <span class='hs-sel'>_other</span>      <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>hGetLineBuffered</span> <span class='hs-varid'>handle_</span>
<a name="line-1833"></a>
<a name="line-1834"></a> <span class='hs-keyword'>where</span>
<a name="line-1835"></a>    <span class='hs-varid'>hGetLineBuffered</span> <span class='hs-varid'>handle_</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1836"></a>        <span class='hs-keyword'>let</span> <span class='hs-varid'>ref</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>haBuffer</span> <span class='hs-varid'>handle_</span>
<a name="line-1837"></a>        <span class='hs-varid'>buf</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>readIORef</span> <span class='hs-varid'>ref</span>
<a name="line-1838"></a>        <span class='hs-varid'>hGetLineBufferedLoop</span> <span class='hs-varid'>handle_</span> <span class='hs-varid'>ref</span> <span class='hs-varid'>buf</span> <span class='hs-num'>0</span> <span class='hs-conid'>[]</span>
<a name="line-1839"></a>
<a name="line-1840"></a>    <span class='hs-varid'>hGetLineBufferedLoop</span> <span class='hs-varid'>handle_</span> <span class='hs-varid'>ref</span>
<a name="line-1841"></a>            <span class='hs-varid'>buf</span><span class='hs-keyglyph'>@</span><span class='hs-conid'>Buffer</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufRPtr</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>r</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufWPtr</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>w</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufBuf</span><span class='hs-keyglyph'>=</span><span class='hs-varid'>raw</span> <span class='hs-layout'>}</span> <span class='hs-varid'>len</span> <span class='hs-varid'>xss</span> <span class='hs-keyglyph'>=</span>
<a name="line-1842"></a>        <span class='hs-varid'>len</span> <span class='hs-varop'>`seq`</span> <span class='hs-keyword'>do</span>
<a name="line-1843"></a>        <span class='hs-varid'>off</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>findEOL</span> <span class='hs-varid'>r</span> <span class='hs-varid'>w</span> <span class='hs-varid'>raw</span>
<a name="line-1844"></a>        <span class='hs-keyword'>let</span> <span class='hs-varid'>new_len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>+</span> <span class='hs-varid'>off</span> <span class='hs-comment'>-</span> <span class='hs-varid'>r</span>
<a name="line-1845"></a>        <span class='hs-varid'>xs</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>mkPS</span> <span class='hs-varid'>raw</span> <span class='hs-varid'>r</span> <span class='hs-varid'>off</span>
<a name="line-1846"></a>
<a name="line-1847"></a>      <span class='hs-comment'>-- if eol == True, then off is the offset of the '\n'</span>
<a name="line-1848"></a>      <span class='hs-comment'>-- otherwise off == w and the buffer is now empty.</span>
<a name="line-1849"></a>        <span class='hs-keyword'>if</span> <span class='hs-varid'>off</span> <span class='hs-varop'>/=</span> <span class='hs-varid'>w</span>
<a name="line-1850"></a>            <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-keyword'>if</span> <span class='hs-layout'>(</span><span class='hs-varid'>w</span> <span class='hs-varop'>==</span> <span class='hs-varid'>off</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-1851"></a>                            <span class='hs-keyword'>then</span> <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>ref</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufRPtr</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufWPtr</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span> <span class='hs-layout'>}</span>
<a name="line-1852"></a>                            <span class='hs-keyword'>else</span> <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>ref</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufRPtr</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>off</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span> <span class='hs-layout'>}</span>
<a name="line-1853"></a>                    <span class='hs-varid'>mkBigPS</span> <span class='hs-varid'>new_len</span> <span class='hs-layout'>(</span><span class='hs-varid'>xs</span><span class='hs-conop'>:</span><span class='hs-varid'>xss</span><span class='hs-layout'>)</span>
<a name="line-1854"></a>            <span class='hs-keyword'>else</span> <span class='hs-keyword'>do</span>
<a name="line-1855"></a>                 <span class='hs-varid'>maybe_buf</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>maybeFillReadBuffer</span> <span class='hs-layout'>(</span><span class='hs-varid'>haFD</span> <span class='hs-varid'>handle_</span><span class='hs-layout'>)</span> <span class='hs-conid'>True</span> <span class='hs-layout'>(</span><span class='hs-varid'>haIsStream</span> <span class='hs-varid'>handle_</span><span class='hs-layout'>)</span>
<a name="line-1856"></a>                                    <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufWPtr</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufRPtr</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span> <span class='hs-layout'>}</span>
<a name="line-1857"></a>                 <span class='hs-keyword'>case</span> <span class='hs-varid'>maybe_buf</span> <span class='hs-keyword'>of</span>
<a name="line-1858"></a>                    <span class='hs-comment'>-- Nothing indicates we caught an EOF, and we may have a</span>
<a name="line-1859"></a>                    <span class='hs-comment'>-- partial line to return.</span>
<a name="line-1860"></a>                    <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1861"></a>                         <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>ref</span> <span class='hs-varid'>buf</span><span class='hs-layout'>{</span> <span class='hs-varid'>bufRPtr</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span><span class='hs-layout'>,</span> <span class='hs-varid'>bufWPtr</span><span class='hs-keyglyph'>=</span><span class='hs-num'>0</span> <span class='hs-layout'>}</span>
<a name="line-1862"></a>                         <span class='hs-keyword'>if</span> <span class='hs-varid'>new_len</span> <span class='hs-varop'>&gt;</span> <span class='hs-num'>0</span>
<a name="line-1863"></a>                            <span class='hs-keyword'>then</span> <span class='hs-varid'>mkBigPS</span> <span class='hs-varid'>new_len</span> <span class='hs-layout'>(</span><span class='hs-varid'>xs</span><span class='hs-conop'>:</span><span class='hs-varid'>xss</span><span class='hs-layout'>)</span>
<a name="line-1864"></a>                            <span class='hs-keyword'>else</span> <span class='hs-varid'>ioe_EOF</span>
<a name="line-1865"></a>                    <span class='hs-conid'>Just</span> <span class='hs-varid'>new_buf</span> <span class='hs-keyglyph'>-&gt;</span>
<a name="line-1866"></a>                         <span class='hs-varid'>hGetLineBufferedLoop</span> <span class='hs-varid'>handle_</span> <span class='hs-varid'>ref</span> <span class='hs-varid'>new_buf</span> <span class='hs-varid'>new_len</span> <span class='hs-layout'>(</span><span class='hs-varid'>xs</span><span class='hs-conop'>:</span><span class='hs-varid'>xss</span><span class='hs-layout'>)</span>
<a name="line-1867"></a>
<a name="line-1868"></a>    <span class='hs-comment'>-- find the end-of-line character, if there is one</span>
<a name="line-1869"></a>    <span class='hs-varid'>findEOL</span> <span class='hs-varid'>r</span> <span class='hs-varid'>w</span> <span class='hs-varid'>raw</span>
<a name="line-1870"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>r</span> <span class='hs-varop'>==</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>w</span>
<a name="line-1871"></a>        <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span>  <span class='hs-keyword'>do</span>
<a name="line-1872"></a>            <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-layout'>,</span><span class='hs-varid'>r'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>readCharFromBuffer</span> <span class='hs-varid'>raw</span> <span class='hs-varid'>r</span>
<a name="line-1873"></a>            <span class='hs-keyword'>if</span> <span class='hs-varid'>c</span> <span class='hs-varop'>==</span> <span class='hs-chr'>'\n'</span>
<a name="line-1874"></a>                <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varid'>r</span> <span class='hs-comment'>-- NB. not r': don't include the '\n'</span>
<a name="line-1875"></a>                <span class='hs-keyword'>else</span> <span class='hs-varid'>findEOL</span> <span class='hs-varid'>r'</span> <span class='hs-varid'>w</span> <span class='hs-varid'>raw</span>
<a name="line-1876"></a>
<a name="line-1877"></a>    <span class='hs-varid'>maybeFillReadBuffer</span> <span class='hs-varid'>fd</span> <span class='hs-varid'>is_line</span> <span class='hs-varid'>is_stream</span> <span class='hs-varid'>buf</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>catch</span>
<a name="line-1878"></a>        <span class='hs-layout'>(</span><span class='hs-keyword'>do</span> <span class='hs-varid'>buf'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>fillReadBuffer</span> <span class='hs-varid'>fd</span> <span class='hs-varid'>is_line</span> <span class='hs-varid'>is_stream</span> <span class='hs-varid'>buf</span>
<a name="line-1879"></a>            <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>buf'</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-1880"></a>        <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>isEOFError</span> <span class='hs-varid'>e</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyword'>else</span> <span class='hs-varid'>ioError</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span>
<a name="line-1881"></a>
<a name="line-1882"></a><span class='hs-comment'>-- TODO, rewrite to use normal memcpy</span>
<a name="line-1883"></a><span class='hs-definition'>mkPS</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>RawBuffer</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1884"></a><span class='hs-definition'>mkPS</span> <span class='hs-varid'>buf</span> <span class='hs-varid'>start</span> <span class='hs-varid'>end</span> <span class='hs-keyglyph'>=</span>
<a name="line-1885"></a>    <span class='hs-keyword'>let</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>end</span> <span class='hs-comment'>-</span> <span class='hs-varid'>start</span>
<a name="line-1886"></a>    <span class='hs-keyword'>in</span> <span class='hs-varid'>create</span> <span class='hs-varid'>len</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyword'>do</span>
<a name="line-1887"></a>        <span class='hs-varid'>memcpy_ptr_baoff</span> <span class='hs-varid'>p</span> <span class='hs-varid'>buf</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>start</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-1888"></a>        <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-1889"></a>
<a name="line-1890"></a><span class='hs-cpp'>#endif</span>
<a name="line-1891"></a>
<a name="line-1892"></a><a name="mkBigPS"></a><span class='hs-definition'>mkBigPS</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>ByteString</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1893"></a><span class='hs-definition'>mkBigPS</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>ps</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>ps</span>
<a name="line-1894"></a><span class='hs-definition'>mkBigPS</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>pss</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>concat</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>pss</span><span class='hs-layout'>)</span>
<a name="line-1895"></a>
<a name="line-1896"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-1897"></a><span class='hs-comment'>-- Block IO</span>
<a name="line-1898"></a>
<a name="line-1899"></a><a name="hPut"></a><span class='hs-comment'>-- | Outputs a 'ByteString' to the specified 'Handle'.</span>
<a name="line-1900"></a><span class='hs-definition'>hPut</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1901"></a><span class='hs-definition'>hPut</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-keyword'>_</span>  <span class='hs-keyword'>_</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-1902"></a><span class='hs-definition'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-layout'>(</span><span class='hs-conid'>PS</span> <span class='hs-varid'>ps</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'>withForeignPtr</span> <span class='hs-varid'>ps</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span><span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>hPutBuf</span> <span class='hs-varid'>h</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-varid'>l</span>
<a name="line-1903"></a>
<a name="line-1904"></a><a name="hPutStr"></a><span class='hs-comment'>-- | A synonym for @hPut@, for compatibility </span>
<a name="line-1905"></a><span class='hs-definition'>hPutStr</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1906"></a><span class='hs-definition'>hPutStr</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span>
<a name="line-1907"></a>
<a name="line-1908"></a><a name="hPutStrLn"></a><span class='hs-comment'>-- | Write a ByteString to a handle, appending a newline byte</span>
<a name="line-1909"></a><span class='hs-definition'>hPutStrLn</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1910"></a><span class='hs-definition'>hPutStrLn</span> <span class='hs-varid'>h</span> <span class='hs-varid'>ps</span>
<a name="line-1911"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>length</span> <span class='hs-varid'>ps</span> <span class='hs-varop'>&lt;</span> <span class='hs-num'>1024</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-layout'>(</span><span class='hs-varid'>ps</span> <span class='hs-varop'>`snoc`</span> <span class='hs-num'>0x0a</span><span class='hs-layout'>)</span>
<a name="line-1912"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span>        <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-varid'>ps</span> <span class='hs-varop'>&gt;&gt;</span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>h</span> <span class='hs-layout'>(</span><span class='hs-varid'>singleton</span> <span class='hs-layout'>(</span><span class='hs-num'>0x0a</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- don't copy</span>
<a name="line-1913"></a>
<a name="line-1914"></a><a name="putStr"></a><span class='hs-comment'>-- | Write a ByteString to stdout</span>
<a name="line-1915"></a><span class='hs-definition'>putStr</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1916"></a><span class='hs-definition'>putStr</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPut</span> <span class='hs-varid'>stdout</span>
<a name="line-1917"></a>
<a name="line-1918"></a><a name="putStrLn"></a><span class='hs-comment'>-- | Write a ByteString to stdout, appending a newline byte</span>
<a name="line-1919"></a><span class='hs-definition'>putStrLn</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-1920"></a><span class='hs-definition'>putStrLn</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hPutStrLn</span> <span class='hs-varid'>stdout</span>
<a name="line-1921"></a>
<a name="line-1922"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
<a name="line-1923"></a><span class='hs-comment'>-- Low level IO</span>
<a name="line-1924"></a>
<a name="line-1925"></a><a name="hGet"></a><span class='hs-comment'>-- | Read a 'ByteString' directly from the specified 'Handle'.  This</span>
<a name="line-1926"></a><span class='hs-comment'>-- is far more efficient than reading the characters into a 'String'</span>
<a name="line-1927"></a><span class='hs-comment'>-- and then using 'pack'. First argument is the Handle to read from, </span>
<a name="line-1928"></a><span class='hs-comment'>-- and the second is the number of bytes to read. It returns the bytes</span>
<a name="line-1929"></a><span class='hs-comment'>-- read, up to n, or 'null' if EOF has been reached.</span>
<a name="line-1930"></a><span class='hs-comment'>--</span>
<a name="line-1931"></a><span class='hs-comment'>-- 'hGet' is implemented in terms of 'hGetBuf'.</span>
<a name="line-1932"></a><span class='hs-comment'>--</span>
<a name="line-1933"></a><span class='hs-comment'>-- If the handle is a pipe or socket, and the writing end</span>
<a name="line-1934"></a><span class='hs-comment'>-- is closed, 'hGet' will behave as if EOF was reached.</span>
<a name="line-1935"></a><span class='hs-comment'>--</span>
<a name="line-1936"></a><span class='hs-definition'>hGet</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1937"></a><span class='hs-definition'>hGet</span> <span class='hs-varid'>h</span> <span class='hs-varid'>i</span>
<a name="line-1938"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&gt;</span>  <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>createAndTrim</span> <span class='hs-varid'>i</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>hGetBuf</span> <span class='hs-varid'>h</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span>
<a name="line-1939"></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-varid'>return</span> <span class='hs-varid'>empty</span>
<a name="line-1940"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>illegalBufferSize</span> <span class='hs-varid'>h</span> <span class='hs-str'>"hGet"</span> <span class='hs-varid'>i</span>
<a name="line-1941"></a>
<a name="line-1942"></a><a name="hGetNonBlocking"></a><span class='hs-comment'>-- | hGetNonBlocking is identical to 'hGet', except that it will never</span>
<a name="line-1943"></a><span class='hs-comment'>-- block waiting for data to become available.  If there is no data</span>
<a name="line-1944"></a><span class='hs-comment'>-- available to be read, 'hGetNonBlocking' returns 'null'.</span>
<a name="line-1945"></a><span class='hs-comment'>--</span>
<a name="line-1946"></a><span class='hs-definition'>hGetNonBlocking</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1947"></a><span class='hs-cpp'>#if defined(__GLASGOW_HASKELL__)</span>
<a name="line-1948"></a><span class='hs-definition'>hGetNonBlocking</span> <span class='hs-varid'>h</span> <span class='hs-varid'>i</span>
<a name="line-1949"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&gt;</span>  <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>createAndTrim</span> <span class='hs-varid'>i</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>hGetBufNonBlocking</span> <span class='hs-varid'>h</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span>
<a name="line-1950"></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-varid'>return</span> <span class='hs-varid'>empty</span>
<a name="line-1951"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>illegalBufferSize</span> <span class='hs-varid'>h</span> <span class='hs-str'>"hGetNonBlocking"</span> <span class='hs-varid'>i</span>
<a name="line-1952"></a><span class='hs-cpp'>#else</span>
<a name="line-1953"></a><span class='hs-definition'>hGetNonBlocking</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGet</span>
<a name="line-1954"></a><span class='hs-cpp'>#endif</span>
<a name="line-1955"></a>
<a name="line-1956"></a><a name="hGetSome"></a><span class='hs-comment'>-- | Like 'hGet', except that a shorter 'ByteString' may be returned</span>
<a name="line-1957"></a><span class='hs-comment'>-- if there are not enough bytes immediately available to satisfy the</span>
<a name="line-1958"></a><span class='hs-comment'>-- whole request.  'hGetSome' only blocks if there is no data</span>
<a name="line-1959"></a><span class='hs-comment'>-- available, and EOF has not yet been reached.</span>
<a name="line-1960"></a><span class='hs-comment'>--</span>
<a name="line-1961"></a><span class='hs-definition'>hGetSome</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-1962"></a><span class='hs-definition'>hGetSome</span> <span class='hs-varid'>hh</span> <span class='hs-varid'>i</span>
<a name="line-1963"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0)</span>
<a name="line-1964"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&gt;</span>  <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>createAndTrim</span> <span class='hs-varid'>i</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>hGetBufSome</span> <span class='hs-varid'>hh</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span>
<a name="line-1965"></a><span class='hs-cpp'>#else</span>
<a name="line-1966"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&gt;</span>  <span class='hs-num'>0</span>    <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span>
<a name="line-1967"></a>                   <span class='hs-varid'>loop</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-1968"></a>                     <span class='hs-varid'>s</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>hGetNonBlocking</span> <span class='hs-varid'>hh</span> <span class='hs-varid'>i</span>
<a name="line-1969"></a>                     <span class='hs-keyword'>if</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-varid'>null</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-1970"></a>                        <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varid'>s</span>
<a name="line-1971"></a>                        <span class='hs-keyword'>else</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>eof</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>hIsEOF</span> <span class='hs-varid'>hh</span>
<a name="line-1972"></a>                                <span class='hs-keyword'>if</span> <span class='hs-varid'>eof</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varid'>s</span>
<a name="line-1973"></a>                                       <span class='hs-keyword'>else</span> <span class='hs-varid'>hWaitForInput</span> <span class='hs-varid'>hh</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varop'>&gt;&gt;</span> <span class='hs-varid'>loop</span>
<a name="line-1974"></a>                                         <span class='hs-comment'>-- for this to work correctly, the</span>
<a name="line-1975"></a>                                         <span class='hs-comment'>-- Handle should be in binary mode</span>
<a name="line-1976"></a>                                         <span class='hs-comment'>-- (see GHC ticket #3808)</span>
<a name="line-1977"></a>                  <span class='hs-keyword'>in</span> <span class='hs-varid'>loop</span>
<a name="line-1978"></a><span class='hs-cpp'>#endif</span>
<a name="line-1979"></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-varid'>return</span> <span class='hs-varid'>empty</span>
<a name="line-1980"></a>    <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>illegalBufferSize</span> <span class='hs-varid'>hh</span> <span class='hs-str'>"hGetSome"</span> <span class='hs-varid'>i</span>
<a name="line-1981"></a>
<a name="line-1982"></a><a name="illegalBufferSize"></a><span class='hs-definition'>illegalBufferSize</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-1983"></a><span class='hs-definition'>illegalBufferSize</span> <span class='hs-varid'>handle</span> <span class='hs-varid'>fn</span> <span class='hs-varid'>sz</span> <span class='hs-keyglyph'>=</span>
<a name="line-1984"></a>    <span class='hs-varid'>ioError</span> <span class='hs-layout'>(</span><span class='hs-varid'>mkIOError</span> <span class='hs-varid'>illegalOperationErrorType</span> <span class='hs-varid'>msg</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>handle</span><span class='hs-layout'>)</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span>
<a name="line-1985"></a>    <span class='hs-comment'>--TODO: System.IO uses InvalidArgument here, but it's not exported :-(</span>
<a name="line-1986"></a>    <span class='hs-keyword'>where</span>
<a name="line-1987"></a>      <span class='hs-varid'>msg</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fn</span> <span class='hs-varop'>++</span> <span class='hs-str'>": illegal ByteString size "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>showsPrec</span> <span class='hs-num'>9</span> <span class='hs-varid'>sz</span> <span class='hs-conid'>[]</span>
<a name="line-1988"></a>
<a name="line-1989"></a>
<a name="line-1990"></a><a name="hGetContents"></a><span class='hs-comment'>-- | Read entire handle contents strictly into a 'ByteString'.</span>
<a name="line-1991"></a><span class='hs-comment'>--</span>
<a name="line-1992"></a><span class='hs-comment'>-- This function reads chunks at a time, doubling the chunksize on each</span>
<a name="line-1993"></a><span class='hs-comment'>-- read. The final buffer is then realloced to the appropriate size. For</span>
<a name="line-1994"></a><span class='hs-comment'>-- files &gt; half of available memory, this may lead to memory exhaustion.</span>
<a name="line-1995"></a><span class='hs-comment'>-- Consider using 'readFile' in this case.</span>
<a name="line-1996"></a><span class='hs-comment'>--</span>
<a name="line-1997"></a><span class='hs-comment'>-- As with 'hGet', the string representation in the file is assumed to</span>
<a name="line-1998"></a><span class='hs-comment'>-- be ISO-8859-1.</span>
<a name="line-1999"></a><span class='hs-comment'>--</span>
<a name="line-2000"></a><span class='hs-comment'>-- The Handle is closed once the contents have been read,</span>
<a name="line-2001"></a><span class='hs-comment'>-- or if an exception is thrown.</span>
<a name="line-2002"></a><span class='hs-comment'>--</span>
<a name="line-2003"></a><span class='hs-definition'>hGetContents</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Handle</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-2004"></a><span class='hs-definition'>hGetContents</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>always</span> <span class='hs-layout'>(</span><span class='hs-varid'>hClose</span> <span class='hs-varid'>h</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span> <span class='hs-comment'>-- strict, so hClose</span>
<a name="line-2005"></a>    <span class='hs-keyword'>let</span> <span class='hs-varid'>start_size</span> <span class='hs-keyglyph'>=</span> <span class='hs-num'>1024</span>
<a name="line-2006"></a>    <span class='hs-varid'>p</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>mallocBytes</span> <span class='hs-varid'>start_size</span>
<a name="line-2007"></a>    <span class='hs-varid'>i</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>hGetBuf</span> <span class='hs-varid'>h</span> <span class='hs-varid'>p</span> <span class='hs-varid'>start_size</span>
<a name="line-2008"></a>    <span class='hs-keyword'>if</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&lt;</span> <span class='hs-varid'>start_size</span>
<a name="line-2009"></a>        <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>p'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>reallocBytes</span> <span class='hs-varid'>p</span> <span class='hs-varid'>i</span>
<a name="line-2010"></a>                <span class='hs-varid'>fp</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>newForeignPtr</span> <span class='hs-varid'>finalizerFree</span> <span class='hs-varid'>p'</span>
<a name="line-2011"></a>                <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-num'>0</span> <span class='hs-varid'>i</span>
<a name="line-2012"></a>        <span class='hs-keyword'>else</span> <span class='hs-varid'>f</span> <span class='hs-varid'>p</span> <span class='hs-varid'>start_size</span>
<a name="line-2013"></a>    <span class='hs-keyword'>where</span>
<a name="line-2014"></a>        <span class='hs-varid'>always</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>flip</span> <span class='hs-varid'>finally</span>
<a name="line-2015"></a>        <span class='hs-varid'>f</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-2016"></a>            <span class='hs-keyword'>let</span> <span class='hs-varid'>s'</span> <span class='hs-keyglyph'>=</span> <span class='hs-num'>2</span> <span class='hs-varop'>*</span> <span class='hs-varid'>s</span>
<a name="line-2017"></a>            <span class='hs-varid'>p'</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>reallocBytes</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s'</span>
<a name="line-2018"></a>            <span class='hs-varid'>i</span>  <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>hGetBuf</span> <span class='hs-varid'>h</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-varid'>s</span>
<a name="line-2019"></a>            <span class='hs-keyword'>if</span> <span class='hs-varid'>i</span> <span class='hs-varop'>&lt;</span> <span class='hs-varid'>s</span>
<a name="line-2020"></a>                <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>i'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>s</span> <span class='hs-varop'>+</span> <span class='hs-varid'>i</span>
<a name="line-2021"></a>                        <span class='hs-varid'>p''</span> <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>reallocBytes</span> <span class='hs-varid'>p'</span> <span class='hs-varid'>i'</span>
<a name="line-2022"></a>                        <span class='hs-varid'>fp</span>  <span class='hs-keyglyph'>&lt;-</span> <span class='hs-varid'>newForeignPtr</span> <span class='hs-varid'>finalizerFree</span> <span class='hs-varid'>p''</span>
<a name="line-2023"></a>                        <span class='hs-varid'>return</span> <span class='hs-varop'>$!</span> <span class='hs-conid'>PS</span> <span class='hs-varid'>fp</span> <span class='hs-num'>0</span> <span class='hs-varid'>i'</span>
<a name="line-2024"></a>                <span class='hs-keyword'>else</span> <span class='hs-varid'>f</span> <span class='hs-varid'>p'</span> <span class='hs-varid'>s'</span>
<a name="line-2025"></a>
<a name="line-2026"></a><a name="getContents"></a><span class='hs-comment'>-- | getContents. Read stdin strictly. Equivalent to hGetContents stdin</span>
<a name="line-2027"></a><span class='hs-comment'>-- The 'Handle' is closed after the contents have been read.</span>
<a name="line-2028"></a><span class='hs-comment'>--</span>
<a name="line-2029"></a><span class='hs-definition'>getContents</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-2030"></a><span class='hs-definition'>getContents</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>hGetContents</span> <span class='hs-varid'>stdin</span>
<a name="line-2031"></a>
<a name="line-2032"></a><a name="interact"></a><span class='hs-comment'>-- | The interact function takes a function of type @ByteString -&gt; ByteString@</span>
<a name="line-2033"></a><span class='hs-comment'>-- as its argument. The entire input from the standard input device is passed</span>
<a name="line-2034"></a><span class='hs-comment'>-- to this function as its argument, and the resulting string is output on the</span>
<a name="line-2035"></a><span class='hs-comment'>-- standard output device.</span>
<a name="line-2036"></a><span class='hs-comment'>--</span>
<a name="line-2037"></a><span class='hs-definition'>interact</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-2038"></a><span class='hs-definition'>interact</span> <span class='hs-varid'>transformer</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>putStr</span> <span class='hs-varop'>.</span> <span class='hs-varid'>transformer</span> <span class='hs-varop'>=&lt;&lt;</span> <span class='hs-varid'>getContents</span>
<a name="line-2039"></a>
<a name="line-2040"></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-2041"></a><span class='hs-comment'>-- efficient than reading the characters into a 'String' and then using</span>
<a name="line-2042"></a><span class='hs-comment'>-- 'pack'.  It also may be more efficient than opening the file and</span>
<a name="line-2043"></a><span class='hs-comment'>-- reading it using hGet. Files are read using 'binary mode' on Windows,</span>
<a name="line-2044"></a><span class='hs-comment'>-- for 'text mode' use the Char8 version of this function.</span>
<a name="line-2045"></a><span class='hs-comment'>--</span>
<a name="line-2046"></a><span class='hs-definition'>readFile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>ByteString</span>
<a name="line-2047"></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'>openBinaryFile</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-2048"></a>    <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>h</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>hFileSize</span> <span class='hs-varid'>h</span> <span class='hs-varop'>&gt;&gt;=</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-2049"></a>
<a name="line-2050"></a><a name="writeFile"></a><span class='hs-comment'>-- | Write a 'ByteString' to a file.</span>
<a name="line-2051"></a><span class='hs-definition'>writeFile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-2052"></a><span class='hs-definition'>writeFile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>txt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>bracket</span> <span class='hs-layout'>(</span><span class='hs-varid'>openBinaryFile</span> <span class='hs-varid'>f</span> <span class='hs-conid'>WriteMode</span><span class='hs-layout'>)</span> <span class='hs-varid'>hClose</span>
<a name="line-2053"></a>    <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>h</span> <span class='hs-keyglyph'>-&gt;</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-2054"></a>
<a name="line-2055"></a><a name="appendFile"></a><span class='hs-comment'>-- | Append a 'ByteString' to a file.</span>
<a name="line-2056"></a><span class='hs-definition'>appendFile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>FilePath</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-2057"></a><span class='hs-definition'>appendFile</span> <span class='hs-varid'>f</span> <span class='hs-varid'>txt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>bracket</span> <span class='hs-layout'>(</span><span class='hs-varid'>openBinaryFile</span> <span class='hs-varid'>f</span> <span class='hs-conid'>AppendMode</span><span class='hs-layout'>)</span> <span class='hs-varid'>hClose</span>
<a name="line-2058"></a>    <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>h</span> <span class='hs-keyglyph'>-&gt;</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-2059"></a>
<a name="line-2060"></a><span class='hs-comment'>-- ---------------------------------------------------------------------</span>
<a name="line-2061"></a><span class='hs-comment'>-- Internal utilities</span>
<a name="line-2062"></a>
<a name="line-2063"></a><a name="findIndexOrEnd"></a><span class='hs-comment'>-- | 'findIndexOrEnd' is a variant of findIndex, that returns the length</span>
<a name="line-2064"></a><span class='hs-comment'>-- of the string if no element is found, rather than Nothing.</span>
<a name="line-2065"></a><span class='hs-definition'>findIndexOrEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span>
<a name="line-2066"></a><span class='hs-definition'>findIndexOrEnd</span> <span class='hs-varid'>k</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'>f</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span>
<a name="line-2067"></a>  <span class='hs-keyword'>where</span>
<a name="line-2068"></a>    <span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>go</span><span class='hs-layout'>)</span>
<a name="line-2069"></a>    <span class='hs-varid'>go</span> <span class='hs-varid'>ptr</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>&gt;=</span> <span class='hs-varid'>l</span>    <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>l</span>
<a name="line-2070"></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'>&lt;-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>ptr</span>
<a name="line-2071"></a>                              <span class='hs-keyword'>if</span> <span class='hs-varid'>k</span> <span class='hs-varid'>w</span>
<a name="line-2072"></a>                                <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-varid'>n</span>
<a name="line-2073"></a>                                <span class='hs-keyword'>else</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>ptr</span> <span class='hs-varop'>`plusPtr`</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span>
<a name="line-2074"></a><span class='hs-comment'>{-# INLINE findIndexOrEnd #-}</span>
<a name="line-2075"></a>
<a name="line-2076"></a><a name="withPtr"></a><span class='hs-comment'>-- | Perform an operation with a temporary ByteString</span>
<a name="line-2077"></a><span class='hs-definition'>withPtr</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>ForeignPtr</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>b</span>
<a name="line-2078"></a><span class='hs-definition'>withPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>io</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inlinePerformIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>fp</span> <span class='hs-varid'>io</span><span class='hs-layout'>)</span>
<a name="line-2079"></a><span class='hs-comment'>{-# INLINE withPtr #-}</span>
<a name="line-2080"></a>
<a name="line-2081"></a><a name="errorEmptyList"></a><span class='hs-comment'>-- Common up near identical calls to `error' to reduce the number</span>
<a name="line-2082"></a><span class='hs-comment'>-- constant strings created when compiled:</span>
<a name="line-2083"></a><span class='hs-definition'>errorEmptyList</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-2084"></a><span class='hs-definition'>errorEmptyList</span> <span class='hs-varid'>fun</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>moduleError</span> <span class='hs-varid'>fun</span> <span class='hs-str'>"empty ByteString"</span>
<a name="line-2085"></a><span class='hs-comment'>{-# NOINLINE errorEmptyList #-}</span>
<a name="line-2086"></a>
<a name="line-2087"></a><a name="moduleError"></a><span class='hs-definition'>moduleError</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-varid'>a</span>
<a name="line-2088"></a><span class='hs-definition'>moduleError</span> <span class='hs-varid'>fun</span> <span class='hs-varid'>msg</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-layout'>(</span><span class='hs-str'>"Data.ByteString."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>fun</span> <span class='hs-varop'>++</span> <span class='hs-chr'>':'</span><span class='hs-conop'>:</span><span class='hs-chr'>' '</span><span class='hs-conop'>:</span><span class='hs-varid'>msg</span><span class='hs-layout'>)</span>
<a name="line-2089"></a><span class='hs-comment'>{-# NOINLINE moduleError #-}</span>
<a name="line-2090"></a>
<a name="line-2091"></a><a name="findFromEndUntil"></a><span class='hs-comment'>-- Find from the end of the string using predicate</span>
<a name="line-2092"></a><span class='hs-definition'>findFromEndUntil</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-&gt;</span> <span class='hs-conid'>Int</span>
<a name="line-2093"></a><span class='hs-conid'>STRICT2</span><span class='hs-layout'>(</span><span class='hs-varid'>findFromEndUntil</span><span class='hs-layout'>)</span>
<a name="line-2094"></a><span class='hs-definition'>findFromEndUntil</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ps</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-keyglyph'>=</span>
<a name="line-2095"></a>    <span class='hs-keyword'>if</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</span> <span class='hs-keyword'>then</span> <span class='hs-num'>0</span>
<a name="line-2096"></a>    <span class='hs-keyword'>else</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>last</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>l</span>
<a name="line-2097"></a>         <span class='hs-keyword'>else</span> <span class='hs-varid'>findFromEndUntil</span> <span class='hs-varid'>f</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-layout'>(</span><span class='hs-varid'>l</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
</pre></body>
</html>