<?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>hs/Data/Enumerator.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a>
<a name="line-2"></a>
<a name="line-3"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span>
<a name="line-4"></a><span class='hs-comment'>-- |</span>
<a name="line-5"></a><span class='hs-comment'>-- Module: Data.Enumerator</span>
<a name="line-6"></a><span class='hs-comment'>-- Copyright: 2010 John Millikin</span>
<a name="line-7"></a><span class='hs-comment'>-- License: MIT</span>
<a name="line-8"></a><span class='hs-comment'>--</span>
<a name="line-9"></a><span class='hs-comment'>-- Maintainer: jmillikin@gmail.com</span>
<a name="line-10"></a><span class='hs-comment'>-- Portability: portable</span>
<a name="line-11"></a><span class='hs-comment'>--</span>
<a name="line-12"></a><span class='hs-comment'>-- Core enumerator types, and some useful primitives.</span>
<a name="line-13"></a><span class='hs-comment'>--</span>
<a name="line-14"></a><span class='hs-comment'>-- This module is intended to be imported qualified:</span>
<a name="line-15"></a><span class='hs-comment'>--</span>
<a name="line-16"></a><span class='hs-comment'>-- @</span>
<a name="line-17"></a><span class='hs-comment'>-- import qualified Data.Enumerator as E</span>
<a name="line-18"></a><span class='hs-comment'>-- @</span>
<a name="line-19"></a><span class='hs-comment'>--</span>
<a name="line-20"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span>
<a name="line-21"></a>
<a name="line-22"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span> <span class='hs-layout'>(</span>
<a name="line-23"></a>
<a name="line-24"></a> <span class='hs-comment'>-- * Types</span>
<a name="line-25"></a> <span class='hs-conid'>Stream</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span>
<a name="line-26"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Iteratee</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span>
<a name="line-27"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Step</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span>
<a name="line-28"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Enumerator</span>
<a name="line-29"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Enumeratee</span>
<a name="line-30"></a>
<a name="line-31"></a> <span class='hs-comment'>-- * Primitives</span>
<a name="line-32"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>returnI</span>
<a name="line-33"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>continue</span>
<a name="line-34"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>yield</span>
<a name="line-35"></a>
<a name="line-36"></a> <span class='hs-comment'>-- ** Operators</span>
<a name="line-37"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>>>==</span><span class='hs-layout'>)</span>
<a name="line-38"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>==<<</span><span class='hs-layout'>)</span>
<a name="line-39"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>$$</span><span class='hs-layout'>)</span>
<a name="line-40"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>>==></span><span class='hs-layout'>)</span>
<a name="line-41"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'><==<</span><span class='hs-layout'>)</span>
<a name="line-42"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>=$</span><span class='hs-layout'>)</span>
<a name="line-43"></a> <span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>$=</span><span class='hs-layout'>)</span>
<a name="line-44"></a>
<a name="line-45"></a> <span class='hs-comment'>-- ** Running iteratees</span>
<a name="line-46"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>run</span>
<a name="line-47"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>run_</span>
<a name="line-48"></a>
<a name="line-49"></a> <span class='hs-comment'>-- ** Error handling</span>
<a name="line-50"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>throwError</span>
<a name="line-51"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>catchError</span>
<a name="line-52"></a>
<a name="line-53"></a> <span class='hs-comment'>-- * Miscellaneous</span>
<a name="line-54"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>concatEnums</span>
<a name="line-55"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>joinI</span>
<a name="line-56"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>joinE</span>
<a name="line-57"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>sequence</span>
<a name="line-58"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>enumEOF</span>
<a name="line-59"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>checkContinue0</span>
<a name="line-60"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>checkContinue1</span>
<a name="line-61"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>checkDoneEx</span>
<a name="line-62"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>checkDone</span>
<a name="line-63"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>isEOF</span>
<a name="line-64"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>tryIO</span>
<a name="line-65"></a>
<a name="line-66"></a> <span class='hs-comment'>-- ** Testing and debugging</span>
<a name="line-67"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>printChunks</span>
<a name="line-68"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>enumList</span>
<a name="line-69"></a>
<a name="line-70"></a> <span class='hs-comment'>-- * Legacy compatibility</span>
<a name="line-71"></a>
<a name="line-72"></a> <span class='hs-comment'>-- ** Obsolete</span>
<a name="line-73"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>liftTrans</span>
<a name="line-74"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>liftI</span>
<a name="line-75"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>peek</span>
<a name="line-76"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>last</span>
<a name="line-77"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span>
<a name="line-78"></a>
<a name="line-79"></a> <span class='hs-comment'>-- ** Aliases</span>
<a name="line-80"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>head</span>
<a name="line-81"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span>
<a name="line-82"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>dropWhile</span>
<a name="line-83"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>span</span>
<a name="line-84"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>break</span>
<a name="line-85"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>consume</span>
<a name="line-86"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span>
<a name="line-87"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl'</span>
<a name="line-88"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldM</span>
<a name="line-89"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>iterate</span>
<a name="line-90"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>iterateM</span>
<a name="line-91"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>repeat</span>
<a name="line-92"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>repeatM</span>
<a name="line-93"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span>
<a name="line-94"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>replicateM</span>
<a name="line-95"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>generateM</span>
<a name="line-96"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span>
<a name="line-97"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>mapM</span>
<a name="line-98"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>concatMap</span>
<a name="line-99"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>concatMapM</span>
<a name="line-100"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>filter</span>
<a name="line-101"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>filterM</span>
<a name="line-102"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>liftFoldL</span>
<a name="line-103"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>liftFoldL'</span>
<a name="line-104"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>liftFoldM</span>
<a name="line-105"></a>
<a name="line-106"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-107"></a>
<a name="line-108"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Typeable</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Typeable</span><span class='hs-layout'>,</span> <span class='hs-varid'>typeOf</span>
<a name="line-109"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Typeable1</span><span class='hs-layout'>,</span> <span class='hs-varid'>typeOf1</span>
<a name="line-110"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>mkTyConApp</span><span class='hs-layout'>,</span> <span class='hs-varid'>mkTyCon</span><span class='hs-layout'>)</span>
<a name="line-111"></a>
<a name="line-112"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-layout'>(</span><span class='hs-varid'>genericSplitAt</span><span class='hs-layout'>)</span>
<a name="line-113"></a>
<a name="line-114"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>Exc</span>
<a name="line-115"></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-116"></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-varop'>.</span><span class='hs-conid'>Trans</span><span class='hs-varop'>.</span><span class='hs-conid'>Class</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadTrans</span><span class='hs-layout'>,</span> <span class='hs-varid'>lift</span><span class='hs-layout'>)</span>
<a name="line-117"></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-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Class</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadIO</span><span class='hs-layout'>,</span> <span class='hs-varid'>liftIO</span><span class='hs-layout'>)</span>
<a name="line-118"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Applicative</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>A</span>
<a name="line-119"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>CM</span>
<a name="line-120"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Function</span> <span class='hs-layout'>(</span><span class='hs-varid'>fix</span><span class='hs-layout'>)</span>
<a name="line-121"></a><span class='hs-keyword'>import</span> <span class='hs-comment'>{-# SOURCE #-}</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>EL</span>
<a name="line-122"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-layout'>(</span><span class='hs-varid'>genericLength</span><span class='hs-layout'>)</span>
<a name="line-123"></a>
<a name="line-124"></a>
<a name="line-125"></a>
<a name="line-126"></a>
<a name="line-127"></a><span class='hs-comment'>-- | A 'Stream' is a sequence of chunks generated by an 'Enumerator'.</span>
<a name="line-128"></a><span class='hs-comment'>--</span>
<a name="line-129"></a><span class='hs-comment'>-- @('Chunks' [])@ is used to indicate that a stream is still active, but</span>
<a name="line-130"></a><span class='hs-comment'>-- currently has no available data. Iteratees should ignore empty chunks.</span>
<a name="line-131"></a>
<a name="line-132"></a><a name="Stream"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span>
<a name="line-133"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunks</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-134"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>EOF</span>
<a name="line-135"></a> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Show</span><span class='hs-layout'>,</span> <span class='hs-conid'>Eq</span><span class='hs-layout'>)</span>
<a name="line-136"></a>
<a name="line-137"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monad</span> <span class='hs-conid'>Stream</span> <span class='hs-keyword'>where</span>
<a name="line-138"></a> <span class='hs-varid'>return</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunks</span> <span class='hs-varop'>.</span> <span class='hs-varid'>return</span>
<a name="line-139"></a> <span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mconcat</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-140"></a> <span class='hs-conid'>EOF</span> <span class='hs-varop'>>>=</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EOF</span>
<a name="line-141"></a>
<a name="line-142"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monoid</span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-143"></a> <span class='hs-varid'>mempty</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunks</span> <span class='hs-varid'>mempty</span>
<a name="line-144"></a> <span class='hs-varid'>mappend</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>xs</span> <span class='hs-varop'>++</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span>
<a name="line-145"></a> <span class='hs-varid'>mappend</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EOF</span>
<a name="line-146"></a>
<a name="line-147"></a><a name="Step"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-148"></a>
<a name="line-149"></a> <span class='hs-comment'>-- | The 'Iteratee' is capable of accepting more input. Note that more input</span>
<a name="line-150"></a> <span class='hs-comment'>-- is not necessarily required; the 'Iteratee' might be able to generate a</span>
<a name="line-151"></a> <span class='hs-comment'>-- value immediately if it receives 'EOF'.</span>
<a name="line-152"></a>
<a name="line-153"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Continue</span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-154"></a>
<a name="line-155"></a>
<a name="line-156"></a> <span class='hs-comment'>-- | The 'Iteratee' cannot receive any more input, and has generated a</span>
<a name="line-157"></a> <span class='hs-comment'>-- result. Included in this value is left-over input, which can be passed to</span>
<a name="line-158"></a> <span class='hs-comment'>-- composed 'Iteratee's.</span>
<a name="line-159"></a>
<a name="line-160"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Yield</span> <span class='hs-varid'>b</span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span>
<a name="line-161"></a>
<a name="line-162"></a>
<a name="line-163"></a> <span class='hs-comment'>-- | The 'Iteratee' encountered an error which prevents it from proceeding</span>
<a name="line-164"></a> <span class='hs-comment'>-- further.</span>
<a name="line-165"></a>
<a name="line-166"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Error</span> <span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-conid'>SomeException</span>
<a name="line-167"></a>
<a name="line-168"></a>
<a name="line-169"></a><span class='hs-comment'>-- | The primary data type for this library, which consumes</span>
<a name="line-170"></a><span class='hs-comment'>-- input from a 'Stream' until it either generates a value or encounters</span>
<a name="line-171"></a><span class='hs-comment'>-- an error. Rather than requiring all input at once, an iteratee will</span>
<a name="line-172"></a><span class='hs-comment'>-- return 'Continue' when it is capable of processing more data.</span>
<a name="line-173"></a><span class='hs-comment'>--</span>
<a name="line-174"></a><span class='hs-comment'>-- In general, iteratees begin in the 'Continue' state. As each chunk is</span>
<a name="line-175"></a><span class='hs-comment'>-- passed to the continuation, the iteratee returns the next step:</span>
<a name="line-176"></a><span class='hs-comment'>-- 'Continue' for more data, 'Yield' when it's finished, or 'Error' to</span>
<a name="line-177"></a><span class='hs-comment'>-- abort processing.</span>
<a name="line-178"></a>
<a name="line-179"></a><a name="Iteratee"></a><span class='hs-keyword'>newtype</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span>
<a name="line-180"></a> <span class='hs-layout'>{</span> <span class='hs-varid'>runIteratee</span> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-181"></a> <span class='hs-layout'>}</span>
<a name="line-182"></a>
<a name="line-183"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-184"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</span> <span class='hs-varid'>x</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-185"></a>
<a name="line-186"></a> <span class='hs-varid'>m0</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varop'>$</span> <span class='hs-varid'>m0</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>fix</span> <span class='hs-varop'>$</span>
<a name="line-187"></a> <span class='hs-keyglyph'>\</span><span class='hs-varid'>bind</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-varid'>runIteratee</span> <span class='hs-varid'>m</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>r1</span> <span class='hs-keyglyph'>-></span>
<a name="line-188"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>r1</span> <span class='hs-keyword'>of</span>
<a name="line-189"></a> <span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>bind</span> <span class='hs-varop'>.</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-190"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Error</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span>
<a name="line-191"></a> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runIteratee</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-192"></a> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-varid'>extra</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>r2</span> <span class='hs-keyglyph'>-></span>
<a name="line-193"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>r2</span> <span class='hs-keyword'>of</span>
<a name="line-194"></a> <span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span> <span class='hs-varid'>extra</span><span class='hs-layout'>)</span>
<a name="line-195"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Error</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span>
<a name="line-196"></a> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x'</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Yield</span> <span class='hs-varid'>x'</span> <span class='hs-varid'>extra</span><span class='hs-layout'>)</span>
<a name="line-197"></a>
<a name="line-198"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>MonadTrans</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-199"></a> <span class='hs-varid'>lift</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>m</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>runIteratee</span> <span class='hs-varop'>.</span> <span class='hs-varid'>return</span><span class='hs-layout'>)</span>
<a name="line-200"></a>
<a name="line-201"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>MonadIO</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>MonadIO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-202"></a> <span class='hs-varid'>liftIO</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>lift</span> <span class='hs-varop'>.</span> <span class='hs-varid'>liftIO</span>
<a name="line-203"></a>
<a name="line-204"></a>
<a name="line-205"></a><span class='hs-comment'>-- | While 'Iteratee's consume data, enumerators generate it. Since</span>
<a name="line-206"></a><span class='hs-comment'>-- @'Iteratee'@ is an alias for @m ('Step' a m b)@, 'Enumerator's can</span>
<a name="line-207"></a><span class='hs-comment'>-- be considered step transformers of type</span>
<a name="line-208"></a><span class='hs-comment'>-- @'Step' a m b -> m ('Step' a m b)@.</span>
<a name="line-209"></a><span class='hs-comment'>--</span>
<a name="line-210"></a><span class='hs-comment'>-- 'Enumerator's typically read from an external source (parser, handle,</span>
<a name="line-211"></a><span class='hs-comment'>-- random generator, etc). They feed chunks into an 'Iteratee' until the</span>
<a name="line-212"></a><span class='hs-comment'>-- source runs out of data (triggering 'EOF') or the iteratee finishes</span>
<a name="line-213"></a><span class='hs-comment'>-- processing ('Yield's a value).</span>
<a name="line-214"></a>
<a name="line-215"></a><a name="Enumerator"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-216"></a>
<a name="line-217"></a>
<a name="line-218"></a><span class='hs-comment'>-- | In cases where an enumerator acts as both a source and sink, the resulting</span>
<a name="line-219"></a><span class='hs-comment'>-- type is named an 'Enumeratee'. Enumeratees have two input types,</span>
<a name="line-220"></a><span class='hs-comment'>-- &#x201c;outer a&#x201d; (@aOut@) and &#x201c;inner a&#x201d; (@aIn@).</span>
<a name="line-221"></a>
<a name="line-222"></a><a name="Enumeratee"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Step</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-223"></a>
<a name="line-224"></a>
<a name="line-225"></a><span class='hs-comment'>-- | Since: 0.4.8</span>
<a name="line-226"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Typeable1</span> <span class='hs-conid'>Stream</span> <span class='hs-keyword'>where</span>
<a name="line-227"></a> <span class='hs-varid'>typeOf1</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mkTyConApp</span> <span class='hs-varid'>tyCon</span> <span class='hs-conid'>[]</span> <span class='hs-keyword'>where</span>
<a name="line-228"></a> <span class='hs-varid'>tyCon</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mkTyCon</span> <span class='hs-str'>"Data.Enumerator.Stream"</span>
<a name="line-229"></a>
<a name="line-230"></a><span class='hs-comment'>-- | Since: 0.4.6</span>
<a name="line-231"></a><span class='hs-keyword'>instance</span> <span class='hs-layout'>(</span><span class='hs-conid'>Typeable</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>Typeable1</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span>
<a name="line-232"></a> <span class='hs-conid'>Typeable1</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-233"></a> <span class='hs-varid'>typeOf1</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span>
<a name="line-234"></a> <span class='hs-varid'>tyCon</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mkTyCon</span> <span class='hs-str'>"Data.Enumerator.Iteratee"</span>
<a name="line-235"></a> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>peel</span> <span class='hs-varid'>i</span>
<a name="line-236"></a>
<a name="line-237"></a> <span class='hs-varid'>peel</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>m</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span>
<a name="line-238"></a> <span class='hs-varid'>peel</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>undefined</span>
<a name="line-239"></a>
<a name="line-240"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>mkTyConApp</span> <span class='hs-varid'>tyCon</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>typeOf</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>typeOf1</span> <span class='hs-varid'>m</span><span class='hs-keyglyph'>]</span>
<a name="line-241"></a>
<a name="line-242"></a><span class='hs-comment'>-- | Since: 0.4.8</span>
<a name="line-243"></a><span class='hs-keyword'>instance</span> <span class='hs-layout'>(</span><span class='hs-conid'>Typeable</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>Typeable1</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span>
<a name="line-244"></a> <span class='hs-conid'>Typeable1</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-245"></a> <span class='hs-varid'>typeOf1</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span>
<a name="line-246"></a> <span class='hs-varid'>tyCon</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mkTyCon</span> <span class='hs-str'>"Data.Enumerator.Step"</span>
<a name="line-247"></a> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>peel</span> <span class='hs-varid'>s</span>
<a name="line-248"></a>
<a name="line-249"></a> <span class='hs-varid'>peel</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>m</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span>
<a name="line-250"></a> <span class='hs-varid'>peel</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>undefined</span>
<a name="line-251"></a>
<a name="line-252"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>mkTyConApp</span> <span class='hs-varid'>tyCon</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>typeOf</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>typeOf1</span> <span class='hs-varid'>m</span><span class='hs-keyglyph'>]</span>
<a name="line-253"></a>
<a name="line-254"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Functor</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-255"></a> <span class='hs-varid'>fmap</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>CM</span><span class='hs-varop'>.</span><span class='hs-varid'>liftM</span>
<a name="line-256"></a>
<a name="line-257"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-conid'>Applicative</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-258"></a> <span class='hs-varid'>pure</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span>
<a name="line-259"></a> <span class='hs-layout'>(</span><span class='hs-varop'><*></span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>CM</span><span class='hs-varop'>.</span><span class='hs-varid'>ap</span>
<a name="line-260"></a>
<a name="line-261"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Functor</span> <span class='hs-conid'>Stream</span> <span class='hs-keyword'>where</span>
<a name="line-262"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Chunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-263"></a> <span class='hs-varid'>fmap</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EOF</span>
<a name="line-264"></a>
<a name="line-265"></a><span class='hs-comment'>-- | Since: 0.4.5</span>
<a name="line-266"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-conid'>Applicative</span> <span class='hs-conid'>Stream</span> <span class='hs-keyword'>where</span>
<a name="line-267"></a> <span class='hs-varid'>pure</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span>
<a name="line-268"></a> <span class='hs-layout'>(</span><span class='hs-varop'><*></span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>CM</span><span class='hs-varop'>.</span><span class='hs-varid'>ap</span>
<a name="line-269"></a>
<a name="line-270"></a>
<a name="line-271"></a>
<a name="line-272"></a><span class='hs-comment'>-- | @'returnI' step = 'Iteratee' (return step)@</span>
<a name="line-273"></a>
<a name="line-274"></a><a name="returnI"></a><span class='hs-definition'>returnI</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-275"></a><span class='hs-definition'>returnI</span> <span class='hs-varid'>step</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-varid'>step</span><span class='hs-layout'>)</span>
<a name="line-276"></a>
<a name="line-277"></a>
<a name="line-278"></a><span class='hs-comment'>-- | @'yield' x extra = 'returnI' ('Yield' x extra)@</span>
<a name="line-279"></a><span class='hs-comment'>--</span>
<a name="line-280"></a><span class='hs-comment'>-- WARNING: due to the current encoding of iteratees in this library,</span>
<a name="line-281"></a><span class='hs-comment'>-- careless use of the 'yield' primitive may violate the monad laws.</span>
<a name="line-282"></a><span class='hs-comment'>-- To prevent this, always make sure that an iteratee never yields</span>
<a name="line-283"></a><span class='hs-comment'>-- extra data unless it has received at least one input element.</span>
<a name="line-284"></a><span class='hs-comment'>--</span>
<a name="line-285"></a><span class='hs-comment'>-- More strictly, iteratees may not yield data that they did not</span>
<a name="line-286"></a><span class='hs-comment'>-- receive as input. Don't use 'yield' to &#x201c;inject&#x201d; elements</span>
<a name="line-287"></a><span class='hs-comment'>-- into the stream.</span>
<a name="line-288"></a>
<a name="line-289"></a><a name="yield"></a><span class='hs-definition'>yield</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-290"></a><span class='hs-definition'>yield</span> <span class='hs-varid'>x</span> <span class='hs-varid'>extra</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>returnI</span> <span class='hs-layout'>(</span><span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-varid'>extra</span><span class='hs-layout'>)</span>
<a name="line-291"></a>
<a name="line-292"></a>
<a name="line-293"></a><span class='hs-comment'>-- | @'continue' k = 'returnI' ('Continue' k)@</span>
<a name="line-294"></a>
<a name="line-295"></a><a name="continue"></a><span class='hs-definition'>continue</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-296"></a><span class='hs-definition'>continue</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>returnI</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span>
<a name="line-297"></a>
<a name="line-298"></a>
<a name="line-299"></a><span class='hs-comment'>-- | Run an iteratee until it finishes, and return either the final value</span>
<a name="line-300"></a><span class='hs-comment'>-- (if it succeeded) or the error (if it failed).</span>
<a name="line-301"></a>
<a name="line-302"></a><a name="run"></a><span class='hs-definition'>run</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-303"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Either</span> <span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-conid'>SomeException</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-304"></a><span class='hs-definition'>run</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-305"></a> <span class='hs-varid'>mStep</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runIteratee</span> <span class='hs-varop'>$</span> <span class='hs-varid'>enumEOF</span> <span class='hs-varop'>==<<</span> <span class='hs-varid'>i</span>
<a name="line-306"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>mStep</span> <span class='hs-keyword'>of</span>
<a name="line-307"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Left</span> <span class='hs-varid'>err</span>
<a name="line-308"></a> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Right</span> <span class='hs-varid'>x</span>
<a name="line-309"></a> <span class='hs-conid'>Continue</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"run: divergent iteratee"</span>
<a name="line-310"></a>
<a name="line-311"></a>
<a name="line-312"></a><span class='hs-comment'>-- | Like 'run', except errors are converted to exceptions and thrown.</span>
<a name="line-313"></a><span class='hs-comment'>-- Primarily useful for small scripts or other simple cases.</span>
<a name="line-314"></a><span class='hs-comment'>--</span>
<a name="line-315"></a><span class='hs-comment'>-- Since: 0.4.1</span>
<a name="line-316"></a>
<a name="line-317"></a><a name="run_"></a><span class='hs-definition'>run_</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-318"></a><span class='hs-definition'>run_</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>run</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>either</span> <span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-varid'>throw</span> <span class='hs-varid'>return</span>
<a name="line-319"></a>
<a name="line-320"></a>
<a name="line-321"></a><span class='hs-comment'>-- | @'throwError' exc = 'returnI' ('Error' ('Exc.toException' exc))@</span>
<a name="line-322"></a>
<a name="line-323"></a><a name="throwError"></a><span class='hs-definition'>throwError</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>e</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-324"></a><span class='hs-definition'>throwError</span> <span class='hs-varid'>exc</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>returnI</span> <span class='hs-layout'>(</span><span class='hs-conid'>Error</span> <span class='hs-layout'>(</span><span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-varid'>toException</span> <span class='hs-varid'>exc</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-325"></a>
<a name="line-326"></a>
<a name="line-327"></a><span class='hs-comment'>-- | Runs the iteratee, and calls an exception handler if an 'Error' is</span>
<a name="line-328"></a><span class='hs-comment'>-- returned. By handling errors within the enumerator library, and requiring</span>
<a name="line-329"></a><span class='hs-comment'>-- all errors to be represented by 'Exc.SomeException', libraries with</span>
<a name="line-330"></a><span class='hs-comment'>-- varying error types can be easily composed.</span>
<a name="line-331"></a><span class='hs-comment'>--</span>
<a name="line-332"></a><span class='hs-comment'>-- WARNING: after a few rounds of "catchError doesn't work because X", this</span>
<a name="line-333"></a><span class='hs-comment'>-- function has grown into a horrible monster. I have no concept of what</span>
<a name="line-334"></a><span class='hs-comment'>-- unexpected behaviors lurk in its dark crevices. Users are strongly advised</span>
<a name="line-335"></a><span class='hs-comment'>-- to wrap all uses of @catchError@ with an appropriate @isolate@, such as</span>
<a name="line-336"></a><span class='hs-comment'>-- @Data.Enumerator.List.isolate@ or @Data.Enumerator.Binary.isolate@, which</span>
<a name="line-337"></a><span class='hs-comment'>-- will handle input framing even in the face of unexpected errors.</span>
<a name="line-338"></a><span class='hs-comment'>--</span>
<a name="line-339"></a><span class='hs-comment'>-- Within the error handler, it is difficult or impossible to know how much</span>
<a name="line-340"></a><span class='hs-comment'>-- input the original iteratee has consumed.</span>
<a name="line-341"></a><span class='hs-comment'>--</span>
<a name="line-342"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-343"></a>
<a name="line-344"></a><a name="catchError"></a><span class='hs-definition'>catchError</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-345"></a> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-346"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-conid'>SomeException</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-347"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-348"></a><span class='hs-definition'>catchError</span> <span class='hs-varid'>i</span> <span class='hs-varid'>h</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-varid'>i</span> <span class='hs-keyword'>where</span>
<a name="line-349"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>iter</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-350"></a> <span class='hs-varid'>step</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runIteratee</span> <span class='hs-varid'>iter</span>
<a name="line-351"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>step</span> <span class='hs-keyword'>of</span>
<a name="line-352"></a> <span class='hs-conid'>Yield</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-varid'>step</span>
<a name="line-353"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>h</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span>
<a name="line-354"></a> <span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>wrap</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-355"></a>
<a name="line-356"></a> <span class='hs-varid'>wrap</span> <span class='hs-varid'>k</span> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-357"></a> <span class='hs-varid'>res</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>run</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span> <span class='hs-conid'>EOF</span><span class='hs-layout'>)</span>
<a name="line-358"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>res</span> <span class='hs-keyword'>of</span>
<a name="line-359"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>enumEOF</span> <span class='hs-varop'>$$</span> <span class='hs-varid'>h</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span>
<a name="line-360"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Yield</span> <span class='hs-varid'>b</span> <span class='hs-conid'>EOF</span><span class='hs-layout'>)</span>
<a name="line-361"></a>
<a name="line-362"></a> <span class='hs-varid'>wrap</span> <span class='hs-varid'>k</span> <span class='hs-varid'>stream</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-363"></a> <span class='hs-varid'>step</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span> <span class='hs-varid'>stream</span><span class='hs-layout'>)</span>
<a name="line-364"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>step</span> <span class='hs-keyword'>of</span>
<a name="line-365"></a> <span class='hs-conid'>Yield</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-varid'>step</span>
<a name="line-366"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-367"></a> <span class='hs-varid'>step'</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>h</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span>
<a name="line-368"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>step'</span> <span class='hs-keyword'>of</span>
<a name="line-369"></a> <span class='hs-conid'>Continue</span> <span class='hs-varid'>k'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>k'</span> <span class='hs-varid'>stream</span><span class='hs-layout'>)</span>
<a name="line-370"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>step'</span>
<a name="line-371"></a> <span class='hs-conid'>Continue</span> <span class='hs-varid'>k'</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>wrap</span> <span class='hs-varid'>k'</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-372"></a>
<a name="line-373"></a>
<a name="line-374"></a><span class='hs-keyword'>infixl</span> <span class='hs-num'>1</span> <span class='hs-varop'>>>==</span>
<a name="line-375"></a><span class='hs-keyword'>infixr</span> <span class='hs-num'>1</span> <span class='hs-varop'>==<<</span>
<a name="line-376"></a><span class='hs-keyword'>infixr</span> <span class='hs-num'>0</span> <span class='hs-varop'>$$</span>
<a name="line-377"></a><span class='hs-keyword'>infixr</span> <span class='hs-num'>1</span> <span class='hs-varop'>>==></span>
<a name="line-378"></a><span class='hs-keyword'>infixr</span> <span class='hs-num'>1</span> <span class='hs-varop'><==<</span>
<a name="line-379"></a>
<a name="line-380"></a>
<a name="line-381"></a><span class='hs-comment'>-- | Equivalent to '(>>=)' for @m ('Step' a m b)@; allows 'Iteratee's with</span>
<a name="line-382"></a><span class='hs-comment'>-- different input types to be composed.</span>
<a name="line-383"></a>
<a name="line-384"></a><a name=">>=="></a><span class='hs-layout'>(</span><span class='hs-varop'>>>==</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-385"></a> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-386"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span><span class='hs-layout'>)</span>
<a name="line-387"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span>
<a name="line-388"></a><a name="i"></a><span class='hs-definition'>i</span> <span class='hs-varop'>>>==</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>runIteratee</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>runIteratee</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span>
<a name="line-389"></a>
<a name="line-390"></a>
<a name="line-391"></a><span class='hs-comment'>-- | @'(==\<\<)' = flip '(\>\>==)'@</span>
<a name="line-392"></a>
<a name="line-393"></a><a name="==<<"></a><span class='hs-layout'>(</span><span class='hs-varop'>==<<</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-394"></a> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span><span class='hs-layout'>)</span>
<a name="line-395"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-396"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span>
<a name="line-397"></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'>flip</span> <span class='hs-layout'>(</span><span class='hs-varop'>>>==</span><span class='hs-layout'>)</span>
<a name="line-398"></a>
<a name="line-399"></a>
<a name="line-400"></a><span class='hs-comment'>-- | @'($$)' = '(==\<\<)'@</span>
<a name="line-401"></a><span class='hs-comment'>--</span>
<a name="line-402"></a><span class='hs-comment'>-- This might be easier to read when passing a chain of iteratees to an</span>
<a name="line-403"></a><span class='hs-comment'>-- enumerator.</span>
<a name="line-404"></a><span class='hs-comment'>--</span>
<a name="line-405"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-406"></a>
<a name="line-407"></a><a name="$$"></a><span class='hs-layout'>(</span><span class='hs-varop'>$$</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-408"></a> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span><span class='hs-layout'>)</span>
<a name="line-409"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-410"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span>
<a name="line-411"></a><span class='hs-layout'>(</span><span class='hs-varop'>$$</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varop'>==<<</span><span class='hs-layout'>)</span>
<a name="line-412"></a>
<a name="line-413"></a>
<a name="line-414"></a><span class='hs-comment'>-- | @'(>==>)' e1 e2 s = e1 s '>>==' e2@</span>
<a name="line-415"></a><span class='hs-comment'>--</span>
<a name="line-416"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-417"></a>
<a name="line-418"></a><a name=">==>"></a><span class='hs-layout'>(</span><span class='hs-varop'>>==></span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-419"></a> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-420"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span><span class='hs-layout'>)</span>
<a name="line-421"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-422"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span>
<a name="line-423"></a><span class='hs-layout'>(</span><span class='hs-varop'>>==></span><span class='hs-layout'>)</span> <span class='hs-varid'>e1</span> <span class='hs-varid'>e2</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>e1</span> <span class='hs-varid'>s</span> <span class='hs-varop'>>>==</span> <span class='hs-varid'>e2</span>
<a name="line-424"></a>
<a name="line-425"></a>
<a name="line-426"></a><span class='hs-comment'>-- | @'(\<==\<)' = flip '(>==>)'@</span>
<a name="line-427"></a><span class='hs-comment'>--</span>
<a name="line-428"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-429"></a>
<a name="line-430"></a><a name="<==<"></a><span class='hs-layout'>(</span><span class='hs-varop'><==<</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-431"></a> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span><span class='hs-layout'>)</span>
<a name="line-432"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-433"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-434"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b'</span>
<a name="line-435"></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'>flip</span> <span class='hs-layout'>(</span><span class='hs-varop'>>==></span><span class='hs-layout'>)</span>
<a name="line-436"></a>
<a name="line-437"></a>
<a name="line-438"></a>
<a name="line-439"></a><span class='hs-comment'>-- | Print chunks as they're received from the enumerator, optionally</span>
<a name="line-440"></a><span class='hs-comment'>-- printing empty chunks.</span>
<a name="line-441"></a>
<a name="line-442"></a><a name="printChunks"></a><span class='hs-definition'>printChunks</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadIO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span>
<a name="line-443"></a> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Bool</span> <span class='hs-comment'>-- ^ Print empty chunks</span>
<a name="line-444"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-conid'>()</span>
<a name="line-445"></a><span class='hs-definition'>printChunks</span> <span class='hs-varid'>printEmpty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-446"></a> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-447"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>hide</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>null</span> <span class='hs-varid'>xs</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>not</span> <span class='hs-varid'>printEmpty</span>
<a name="line-448"></a> <span class='hs-conid'>CM</span><span class='hs-varop'>.</span><span class='hs-varid'>unless</span> <span class='hs-varid'>hide</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>print</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-449"></a> <span class='hs-varid'>continue</span> <span class='hs-varid'>loop</span>
<a name="line-450"></a>
<a name="line-451"></a> <span class='hs-varid'>loop</span> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-452"></a> <span class='hs-varid'>liftIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>putStrLn</span> <span class='hs-str'>"EOF"</span><span class='hs-layout'>)</span>
<a name="line-453"></a> <span class='hs-varid'>yield</span> <span class='hs-conid'>()</span> <span class='hs-conid'>EOF</span>
<a name="line-454"></a>
<a name="line-455"></a>
<a name="line-456"></a><span class='hs-comment'>-- | @'enumList' n xs@ enumerates /xs/ as a stream, passing /n/ inputs per</span>
<a name="line-457"></a><span class='hs-comment'>-- chunk.</span>
<a name="line-458"></a><span class='hs-comment'>--</span>
<a name="line-459"></a><span class='hs-comment'>-- Primarily useful for testing and debugging.</span>
<a name="line-460"></a>
<a name="line-461"></a><a name="enumList"></a><span class='hs-definition'>enumList</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Integer</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-462"></a><span class='hs-definition'>enumList</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-463"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>xs</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-varid'>null</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span>
<a name="line-464"></a> <span class='hs-layout'>(</span><span class='hs-varid'>s1</span><span class='hs-layout'>,</span> <span class='hs-varid'>s2</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>genericSplitAt</span> <span class='hs-varid'>n</span> <span class='hs-varid'>xs</span>
<a name="line-465"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>s1</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>==</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>s2</span>
<a name="line-466"></a> <span class='hs-varid'>loop</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>step</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>returnI</span> <span class='hs-varid'>step</span>
<a name="line-467"></a>
<a name="line-468"></a>
<a name="line-469"></a>
<a name="line-470"></a><span class='hs-comment'>-- | Compose a list of 'Enumerator's using @'(>>==)'@</span>
<a name="line-471"></a>
<a name="line-472"></a><a name="concatEnums"></a><span class='hs-definition'>concatEnums</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-keyglyph'>]</span>
<a name="line-473"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-474"></a><span class='hs-definition'>concatEnums</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Prelude</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span> <span class='hs-layout'>(</span><span class='hs-varop'>>==></span><span class='hs-layout'>)</span> <span class='hs-varid'>returnI</span>
<a name="line-475"></a>
<a name="line-476"></a>
<a name="line-477"></a><span class='hs-comment'>-- | 'joinI' is used to &#x201C;flatten&#x201D; 'Enumeratee's into an</span>
<a name="line-478"></a><span class='hs-comment'>-- 'Iteratee'.</span>
<a name="line-479"></a>
<a name="line-480"></a><a name="joinI"></a><span class='hs-definition'>joinI</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-481"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-482"></a><span class='hs-definition'>joinI</span> <span class='hs-varid'>outer</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>outer</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>check</span> <span class='hs-keyword'>where</span>
<a name="line-483"></a> <span class='hs-varid'>check</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>k</span> <span class='hs-conid'>EOF</span> <span class='hs-varop'>>>==</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>s</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>s</span> <span class='hs-keyword'>of</span>
<a name="line-484"></a> <span class='hs-conid'>Continue</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"joinI: divergent iteratee"</span>
<a name="line-485"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>check</span> <span class='hs-varid'>s</span>
<a name="line-486"></a> <span class='hs-varid'>check</span> <span class='hs-layout'>(</span><span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-487"></a> <span class='hs-varid'>check</span> <span class='hs-layout'>(</span><span class='hs-conid'>Error</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>throwError</span> <span class='hs-varid'>e</span>
<a name="line-488"></a>
<a name="line-489"></a><span class='hs-keyword'>infixr</span> <span class='hs-num'>0</span> <span class='hs-varop'>=$</span>
<a name="line-490"></a>
<a name="line-491"></a>
<a name="line-492"></a><span class='hs-comment'>-- | @enum =$ iter = 'joinI' (enum $$ iter)@</span>
<a name="line-493"></a><span class='hs-comment'>--</span>
<a name="line-494"></a><span class='hs-comment'>-- &#x201c;Wraps&#x201d; an iteratee /inner/ in an enumeratee /wrapper/.</span>
<a name="line-495"></a><span class='hs-comment'>-- The resulting iteratee will consume /wrapper/&#x2019;s input type and</span>
<a name="line-496"></a><span class='hs-comment'>-- yield /inner/&#x2019;s output type.</span>
<a name="line-497"></a><span class='hs-comment'>--</span>
<a name="line-498"></a><span class='hs-comment'>-- Note: if the inner iteratee yields leftover input when it finishes,</span>
<a name="line-499"></a><span class='hs-comment'>-- that extra will be discarded.</span>
<a name="line-500"></a><span class='hs-comment'>--</span>
<a name="line-501"></a><span class='hs-comment'>-- As an example, consider an iteratee that converts a stream of UTF8-encoded</span>
<a name="line-502"></a><span class='hs-comment'>-- bytes into a single 'TL.Text':</span>
<a name="line-503"></a><span class='hs-comment'>--</span>
<a name="line-504"></a><span class='hs-comment'>-- > consumeUTF8 :: Monad m => Iteratee ByteString m Text</span>
<a name="line-505"></a><span class='hs-comment'>--</span>
<a name="line-506"></a><span class='hs-comment'>-- It could be written with either 'joinI' or '(=$)':</span>
<a name="line-507"></a><span class='hs-comment'>--</span>
<a name="line-508"></a><span class='hs-comment'>-- > import Data.Enumerator.Text as ET</span>
<a name="line-509"></a><span class='hs-comment'>-- ></span>
<a name="line-510"></a><span class='hs-comment'>-- > consumeUTF8 = joinI (decode utf8 $$ ET.consume)</span>
<a name="line-511"></a><span class='hs-comment'>-- > consumeUTF8 = decode utf8 =$ ET.consume</span>
<a name="line-512"></a><span class='hs-comment'>--</span>
<a name="line-513"></a><span class='hs-comment'>-- Since: 0.4.9</span>
<a name="line-514"></a>
<a name="line-515"></a><a name="=$"></a><span class='hs-layout'>(</span><span class='hs-varop'>=$</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-516"></a><a name="enum"></a><span class='hs-definition'>enum</span> <span class='hs-varop'>=$</span> <span class='hs-varid'>iter</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>joinI</span> <span class='hs-layout'>(</span><span class='hs-varid'>enum</span> <span class='hs-varop'>$$</span> <span class='hs-varid'>iter</span><span class='hs-layout'>)</span>
<a name="line-517"></a>
<a name="line-518"></a>
<a name="line-519"></a><span class='hs-comment'>-- | Flatten an enumerator/enumeratee pair into a single enumerator.</span>
<a name="line-520"></a>
<a name="line-521"></a><a name="joinE"></a><span class='hs-definition'>joinE</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-522"></a> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-523"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-524"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-525"></a><span class='hs-definition'>joinE</span> <span class='hs-varid'>enum</span> <span class='hs-varid'>enee</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-526"></a> <span class='hs-varid'>step</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>runIteratee</span> <span class='hs-layout'>(</span><span class='hs-varid'>enumEOF</span> <span class='hs-varop'>$$</span> <span class='hs-varid'>enum</span> <span class='hs-varop'>$$</span> <span class='hs-varid'>enee</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span>
<a name="line-527"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>step</span> <span class='hs-keyword'>of</span>
<a name="line-528"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-conid'>Error</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span>
<a name="line-529"></a> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-530"></a> <span class='hs-conid'>Continue</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"joinE: divergent iteratee"</span>
<a name="line-531"></a>
<a name="line-532"></a><span class='hs-keyword'>infixr</span> <span class='hs-num'>0</span> <span class='hs-varop'>$=</span>
<a name="line-533"></a>
<a name="line-534"></a>
<a name="line-535"></a><span class='hs-comment'>-- | @enum $= enee = 'joinE' enum enee@</span>
<a name="line-536"></a><span class='hs-comment'>--</span>
<a name="line-537"></a><span class='hs-comment'>-- &#x201c;Wraps&#x201d; an enumerator /inner/ in an enumeratee /wrapper/.</span>
<a name="line-538"></a><span class='hs-comment'>-- The resulting enumerator will generate /wrapper/&#x2019;s output type.</span>
<a name="line-539"></a><span class='hs-comment'>--</span>
<a name="line-540"></a><span class='hs-comment'>-- As an example, consider an enumerator that yields line character counts</span>
<a name="line-541"></a><span class='hs-comment'>-- for a text file (e.g. for source code readability checking):</span>
<a name="line-542"></a><span class='hs-comment'>--</span>
<a name="line-543"></a><span class='hs-comment'>-- > enumFileCounts :: FilePath -> Enumerator Int IO b</span>
<a name="line-544"></a><span class='hs-comment'>--</span>
<a name="line-545"></a><span class='hs-comment'>-- It could be written with either 'joinE' or '($=)':</span>
<a name="line-546"></a><span class='hs-comment'>--</span>
<a name="line-547"></a><span class='hs-comment'>-- > import Data.Text as T</span>
<a name="line-548"></a><span class='hs-comment'>-- > import Data.Enumerator.List as EL</span>
<a name="line-549"></a><span class='hs-comment'>-- > import Data.Enumerator.Text as ET</span>
<a name="line-550"></a><span class='hs-comment'>-- ></span>
<a name="line-551"></a><span class='hs-comment'>-- > enumFileCounts path = joinE (enumFile path) (EL.map T.length)</span>
<a name="line-552"></a><span class='hs-comment'>-- > enumFileCounts path = enumFile path $= EL.map T.length</span>
<a name="line-553"></a><span class='hs-comment'>--</span>
<a name="line-554"></a><span class='hs-comment'>-- Since: 0.4.9</span>
<a name="line-555"></a>
<a name="line-556"></a><a name="$="></a><span class='hs-layout'>(</span><span class='hs-varop'>$=</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-557"></a> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-558"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-559"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-560"></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'>joinE</span>
<a name="line-561"></a>
<a name="line-562"></a>
<a name="line-563"></a><span class='hs-comment'>-- | Feeds outer input elements into the provided iteratee until it yields</span>
<a name="line-564"></a><span class='hs-comment'>-- an inner input, passes that to the inner iteratee, and then loops.</span>
<a name="line-565"></a>
<a name="line-566"></a><a name="sequence"></a><span class='hs-definition'>sequence</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>m</span> <span class='hs-varid'>ai</span>
<a name="line-567"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-568"></a><span class='hs-definition'>sequence</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-569"></a> <span class='hs-varid'>loop</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>checkDone</span> <span class='hs-varid'>check</span>
<a name="line-570"></a> <span class='hs-varid'>check</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>isEOF</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>if</span> <span class='hs-varid'>f</span>
<a name="line-571"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>yield</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-conid'>EOF</span>
<a name="line-572"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>step</span> <span class='hs-varid'>k</span>
<a name="line-573"></a> <span class='hs-varid'>step</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>v</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>k</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>v</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>==</span> <span class='hs-varid'>loop</span>
<a name="line-574"></a>
<a name="line-575"></a>
<a name="line-576"></a><span class='hs-comment'>-- | Sends 'EOF' to its iteratee. Most clients should use 'run' or 'run_'</span>
<a name="line-577"></a><span class='hs-comment'>-- instead.</span>
<a name="line-578"></a>
<a name="line-579"></a><a name="enumEOF"></a><span class='hs-definition'>enumEOF</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-580"></a><span class='hs-definition'>enumEOF</span> <span class='hs-layout'>(</span><span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</span> <span class='hs-varid'>x</span> <span class='hs-conid'>EOF</span>
<a name="line-581"></a><span class='hs-definition'>enumEOF</span> <span class='hs-layout'>(</span><span class='hs-conid'>Error</span> <span class='hs-varid'>err</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>throwError</span> <span class='hs-varid'>err</span>
<a name="line-582"></a><span class='hs-definition'>enumEOF</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>k</span> <span class='hs-conid'>EOF</span> <span class='hs-varop'>>>==</span> <span class='hs-varid'>check</span> <span class='hs-keyword'>where</span>
<a name="line-583"></a> <span class='hs-varid'>check</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-str'>"enumEOF: divergent iteratee"</span>
<a name="line-584"></a> <span class='hs-varid'>check</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>enumEOF</span> <span class='hs-varid'>s</span>
<a name="line-585"></a>
<a name="line-586"></a>
<a name="line-587"></a><span class='hs-comment'>-- | A common pattern in 'Enumeratee' implementations is to check whether</span>
<a name="line-588"></a><span class='hs-comment'>-- the inner 'Iteratee' has finished, and if so, to return its output.</span>
<a name="line-589"></a><span class='hs-comment'>-- 'checkDone' passes its parameter a continuation if the 'Iteratee'</span>
<a name="line-590"></a><span class='hs-comment'>-- can still consume input, or yields otherwise.</span>
<a name="line-591"></a><span class='hs-comment'>--</span>
<a name="line-592"></a><span class='hs-comment'>-- Since: 0.4.3</span>
<a name="line-593"></a>
<a name="line-594"></a><a name="checkDoneEx"></a><span class='hs-definition'>checkDoneEx</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span>
<a name="line-595"></a> <span class='hs-conid'>Stream</span> <span class='hs-varid'>a'</span> <span class='hs-keyglyph'>-></span>
<a name="line-596"></a> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span>
<a name="line-597"></a> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-598"></a><span class='hs-definition'>checkDoneEx</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varid'>k</span>
<a name="line-599"></a><span class='hs-definition'>checkDoneEx</span> <span class='hs-varid'>extra</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>step</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</span> <span class='hs-varid'>step</span> <span class='hs-varid'>extra</span>
<a name="line-600"></a>
<a name="line-601"></a>
<a name="line-602"></a><span class='hs-comment'>-- | @'checkDone' = 'checkDoneEx' ('Chunks' [])@</span>
<a name="line-603"></a><span class='hs-comment'>--</span>
<a name="line-604"></a><span class='hs-comment'>-- Use this for enumeratees which do not have an input buffer.</span>
<a name="line-605"></a>
<a name="line-606"></a><a name="checkDone"></a><span class='hs-definition'>checkDone</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span>
<a name="line-607"></a> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span>
<a name="line-608"></a> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>a'</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-609"></a><span class='hs-definition'>checkDone</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>checkDoneEx</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-610"></a>
<a name="line-611"></a>
<a name="line-612"></a><span class='hs-comment'>-- | Check whether a stream has reached EOF. Most clients should use</span>
<a name="line-613"></a><span class='hs-comment'>-- 'Data.Enumerator.List.head' instead.</span>
<a name="line-614"></a>
<a name="line-615"></a><a name="isEOF"></a><span class='hs-definition'>isEOF</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-conid'>Bool</span>
<a name="line-616"></a><span class='hs-definition'>isEOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>s</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>s</span> <span class='hs-keyword'>of</span>
<a name="line-617"></a> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>yield</span> <span class='hs-conid'>True</span> <span class='hs-varid'>s</span>
<a name="line-618"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>yield</span> <span class='hs-conid'>False</span> <span class='hs-varid'>s</span>
<a name="line-619"></a>
<a name="line-620"></a>
<a name="line-621"></a><span class='hs-comment'>-- | Try to run an IO computation. If it throws an exception, the exception</span>
<a name="line-622"></a><span class='hs-comment'>-- is caught and converted into an {\tt Error}.</span>
<a name="line-623"></a><span class='hs-comment'>--</span>
<a name="line-624"></a><span class='hs-comment'>-- Since: 0.4.9</span>
<a name="line-625"></a>
<a name="line-626"></a><a name="tryIO"></a><span class='hs-definition'>tryIO</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>MonadIO</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-627"></a><span class='hs-definition'>tryIO</span> <span class='hs-varid'>io</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-628"></a> <span class='hs-varid'>tried</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>liftIO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Exc</span><span class='hs-varop'>.</span><span class='hs-varid'>try</span> <span class='hs-varid'>io</span><span class='hs-layout'>)</span>
<a name="line-629"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>tried</span> <span class='hs-keyword'>of</span>
<a name="line-630"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Yield</span> <span class='hs-varid'>b</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-631"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span>
<a name="line-632"></a>
<a name="line-633"></a>
<a name="line-634"></a><span class='hs-comment'>-- | A common pattern in 'Enumerator' implementations is to check whether</span>
<a name="line-635"></a><span class='hs-comment'>-- the inner 'Iteratee' has finished, and if so, to return its output.</span>
<a name="line-636"></a><span class='hs-comment'>-- 'checkContinue0' passes its parameter a continuation if the 'Iteratee'</span>
<a name="line-637"></a><span class='hs-comment'>-- can still consume input; if not, it returns the iteratee's step.</span>
<a name="line-638"></a><span class='hs-comment'>--</span>
<a name="line-639"></a><span class='hs-comment'>-- The type signature here is a bit crazy, but it's actually very easy to</span>
<a name="line-640"></a><span class='hs-comment'>-- use. Take this code:</span>
<a name="line-641"></a><span class='hs-comment'>--</span>
<a name="line-642"></a><span class='hs-comment'>-- > repeat :: Monad m => a -> Enumerator a m b</span>
<a name="line-643"></a><span class='hs-comment'>-- > repeat x = loop where</span>
<a name="line-644"></a><span class='hs-comment'>-- > loop (Continue k) = k (Chunks [x]) >>== loop</span>
<a name="line-645"></a><span class='hs-comment'>-- > loop step = returnI step</span>
<a name="line-646"></a><span class='hs-comment'>--</span>
<a name="line-647"></a><span class='hs-comment'>-- And rewrite it without the boilerplate:</span>
<a name="line-648"></a><span class='hs-comment'>--</span>
<a name="line-649"></a><span class='hs-comment'>-- > repeat :: Monad m => a -> Enumerator a m b</span>
<a name="line-650"></a><span class='hs-comment'>-- > repeat x = checkContinue0 $ \loop k -> k (Chunks [x] >>== loop</span>
<a name="line-651"></a><span class='hs-comment'>--</span>
<a name="line-652"></a><span class='hs-comment'>-- Since: 0.4.9</span>
<a name="line-653"></a>
<a name="line-654"></a><a name="checkContinue0"></a><span class='hs-definition'>checkContinue0</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-655"></a> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-656"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-657"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-658"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-659"></a><span class='hs-definition'>checkContinue0</span> <span class='hs-varid'>inner</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-660"></a> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inner</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>k</span>
<a name="line-661"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>step</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>returnI</span> <span class='hs-varid'>step</span>
<a name="line-662"></a>
<a name="line-663"></a>
<a name="line-664"></a><span class='hs-comment'>-- | Like 'checkContinue0', but allows each loop step to use a state value:</span>
<a name="line-665"></a><span class='hs-comment'>--</span>
<a name="line-666"></a><span class='hs-comment'>-- > iterate :: Monad m => (a -> a) -> a -> Enumerator a m b</span>
<a name="line-667"></a><span class='hs-comment'>-- > iterate f = checkContinue1 $ \loop a k -> k (Chunks [a]) >>== loop (f a)</span>
<a name="line-668"></a><span class='hs-comment'>--</span>
<a name="line-669"></a><span class='hs-comment'>-- Since: 0.4.9</span>
<a name="line-670"></a>
<a name="line-671"></a><a name="checkContinue1"></a><span class='hs-definition'>checkContinue1</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span>
<a name="line-672"></a> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>s1</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-673"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>s1</span>
<a name="line-674"></a> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-675"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-676"></a> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>s1</span>
<a name="line-677"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-678"></a><span class='hs-definition'>checkContinue1</span> <span class='hs-varid'>inner</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-679"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>s</span> <span class='hs-layout'>(</span><span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inner</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>s</span> <span class='hs-varid'>k</span>
<a name="line-680"></a> <span class='hs-varid'>loop</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>step</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>returnI</span> <span class='hs-varid'>step</span>
<a name="line-681"></a>
<a name="line-682"></a>
<a name="line-683"></a>
<a name="line-684"></a><span class='hs-comment'>-- | Lift an 'Iteratee' onto a monad transformer, re-wrapping the</span>
<a name="line-685"></a><span class='hs-comment'>-- 'Iteratee'&#x2019;s inner monadic values.</span>
<a name="line-686"></a><span class='hs-comment'>--</span>
<a name="line-687"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-688"></a>
<a name="line-689"></a><a name="liftTrans"></a><span class='hs-definition'>liftTrans</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>MonadTrans</span> <span class='hs-varid'>t</span><span class='hs-layout'>,</span> <span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span>
<a name="line-690"></a> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span>
<a name="line-691"></a><span class='hs-definition'>liftTrans</span> <span class='hs-varid'>iter</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Iteratee</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-692"></a> <span class='hs-varid'>step</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>lift</span> <span class='hs-layout'>(</span><span class='hs-varid'>runIteratee</span> <span class='hs-varid'>iter</span><span class='hs-layout'>)</span>
<a name="line-693"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>step</span> <span class='hs-keyword'>of</span>
<a name="line-694"></a> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Yield</span> <span class='hs-varid'>x</span> <span class='hs-varid'>cs</span>
<a name="line-695"></a> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Error</span> <span class='hs-varid'>err</span>
<a name="line-696"></a> <span class='hs-conid'>Continue</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftTrans</span> <span class='hs-varop'>.</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span>
<a name="line-697"></a>
<a name="line-698"></a><span class='hs-comment'>{-# DEPRECATED liftI "Use 'Data.Enumerator.continue' instead" #-}</span>
<a name="line-699"></a>
<a name="line-700"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.continue' instead</span>
<a name="line-701"></a>
<a name="line-702"></a><a name="liftI"></a><span class='hs-definition'>liftI</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-conid'>Stream</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Step</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span>
<a name="line-703"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-704"></a><span class='hs-definition'>liftI</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>returnI</span> <span class='hs-varop'>.</span> <span class='hs-varid'>k</span><span class='hs-layout'>)</span>
<a name="line-705"></a>
<a name="line-706"></a>
<a name="line-707"></a><span class='hs-comment'>-- | Peek at the next element in the stream, or 'Nothing' if the stream</span>
<a name="line-708"></a><span class='hs-comment'>-- has ended.</span>
<a name="line-709"></a>
<a name="line-710"></a><a name="peek"></a><span class='hs-definition'>peek</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</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-711"></a><span class='hs-definition'>peek</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-712"></a> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-varid'>loop</span>
<a name="line-713"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>chunk</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</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-varid'>chunk</span>
<a name="line-714"></a> <span class='hs-varid'>loop</span> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</span> <span class='hs-conid'>Nothing</span> <span class='hs-conid'>EOF</span>
<a name="line-715"></a>
<a name="line-716"></a>
<a name="line-717"></a><span class='hs-comment'>-- | Get the last element in the stream, or 'Nothing' if the stream</span>
<a name="line-718"></a><span class='hs-comment'>-- has ended.</span>
<a name="line-719"></a><span class='hs-comment'>--</span>
<a name="line-720"></a><span class='hs-comment'>-- Consumes the entire stream.</span>
<a name="line-721"></a>
<a name="line-722"></a><a name="last"></a><span class='hs-definition'>last</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</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-723"></a><span class='hs-definition'>last</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>loop</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-724"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>ret</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-varop'>.</span> <span class='hs-varid'>loop</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>xs</span> <span class='hs-keyword'>of</span>
<a name="line-725"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>ret</span>
<a name="line-726"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-conid'>Prelude</span><span class='hs-varop'>.</span><span class='hs-varid'>last</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-727"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>ret</span> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</span> <span class='hs-varid'>ret</span> <span class='hs-conid'>EOF</span>
<a name="line-728"></a>
<a name="line-729"></a>
<a name="line-730"></a><span class='hs-comment'>-- | Get how many elements remained in the stream.</span>
<a name="line-731"></a><span class='hs-comment'>--</span>
<a name="line-732"></a><span class='hs-comment'>-- Consumes the entire stream.</span>
<a name="line-733"></a>
<a name="line-734"></a><a name="length"></a><span class='hs-definition'>length</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-conid'>Integer</span>
<a name="line-735"></a><span class='hs-definition'>length</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>loop</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-736"></a> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>genericLength</span>
<a name="line-737"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-layout'>(</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-varid'>len</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-738"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>n</span> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>yield</span> <span class='hs-varid'>n</span> <span class='hs-conid'>EOF</span>
<a name="line-739"></a>
<a name="line-740"></a>
<a name="line-741"></a><span class='hs-comment'>{-# DEPRECATED head "Use 'Data.Enumerator.List.head' instead" #-}</span>
<a name="line-742"></a>
<a name="line-743"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.head' instead</span>
<a name="line-744"></a>
<a name="line-745"></a><a name="head"></a><span class='hs-definition'>head</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</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-746"></a><span class='hs-definition'>head</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>head</span>
<a name="line-747"></a>
<a name="line-748"></a><span class='hs-comment'>{-# DEPRECATED drop "Use 'Data.Enumerator.List.drop' instead" #-}</span>
<a name="line-749"></a>
<a name="line-750"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.drop' instead</span>
<a name="line-751"></a>
<a name="line-752"></a><a name="drop"></a><span class='hs-definition'>drop</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Integer</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-conid'>()</span>
<a name="line-753"></a><span class='hs-definition'>drop</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>drop</span>
<a name="line-754"></a>
<a name="line-755"></a><span class='hs-comment'>{-# DEPRECATED dropWhile "Use 'Data.Enumerator.List.dropWhile' instead" #-}</span>
<a name="line-756"></a>
<a name="line-757"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.dropWhile' instead</span>
<a name="line-758"></a>
<a name="line-759"></a><a name="dropWhile"></a><span class='hs-definition'>dropWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-conid'>()</span>
<a name="line-760"></a><span class='hs-definition'>dropWhile</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>dropWhile</span>
<a name="line-761"></a>
<a name="line-762"></a><span class='hs-comment'>{-# DEPRECATED span "Use 'Data.Enumerator.List.takeWhile' instead" #-}</span>
<a name="line-763"></a>
<a name="line-764"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.takeWhile' instead</span>
<a name="line-765"></a>
<a name="line-766"></a><a name="span"></a><span class='hs-definition'>span</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-767"></a><span class='hs-definition'>span</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>takeWhile</span>
<a name="line-768"></a>
<a name="line-769"></a><span class='hs-comment'>{-# DEPRECATED break "Use 'Data.Enumerator.List.takeWhile' instead" #-}</span>
<a name="line-770"></a>
<a name="line-771"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.takeWhile' instead</span>
<a name="line-772"></a>
<a name="line-773"></a><a name="break"></a><span class='hs-definition'>break</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-774"></a><span class='hs-definition'>break</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>takeWhile</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span>
<a name="line-775"></a>
<a name="line-776"></a><span class='hs-comment'>{-# DEPRECATED consume "Use 'Data.Enumerator.List.consume' instead" #-}</span>
<a name="line-777"></a>
<a name="line-778"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.consume' instead</span>
<a name="line-779"></a>
<a name="line-780"></a><a name="consume"></a><span class='hs-definition'>consume</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-781"></a><span class='hs-definition'>consume</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>consume</span>
<a name="line-782"></a>
<a name="line-783"></a><span class='hs-comment'>{-# DEPRECATED foldl "Use Data.Enumerator.List.fold instead" #-}</span>
<a name="line-784"></a>
<a name="line-785"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.fold' instead</span>
<a name="line-786"></a><span class='hs-comment'>--</span>
<a name="line-787"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-788"></a>
<a name="line-789"></a><a name="foldl"></a><span class='hs-definition'>foldl</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-790"></a><span class='hs-definition'>foldl</span> <span class='hs-varid'>step</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>continue</span> <span class='hs-varop'>.</span> <span class='hs-varid'>loop</span> <span class='hs-keyword'>where</span>
<a name="line-791"></a> <span class='hs-varid'>fold</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Prelude</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span> <span class='hs-varid'>step</span>
<a name="line-792"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>stream</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>stream</span> <span class='hs-keyword'>of</span>
<a name="line-793"></a> <span class='hs-conid'>Chunks</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>loop</span> <span class='hs-varid'>acc</span><span class='hs-layout'>)</span>
<a name="line-794"></a> <span class='hs-conid'>Chunks</span> <span class='hs-varid'>xs</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>continue</span> <span class='hs-layout'>(</span><span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>fold</span> <span class='hs-varid'>acc</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-795"></a> <span class='hs-conid'>EOF</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>yield</span> <span class='hs-varid'>acc</span> <span class='hs-conid'>EOF</span>
<a name="line-796"></a>
<a name="line-797"></a><span class='hs-comment'>{-# DEPRECATED foldl' "Use Data.Enumerator.List.fold instead" #-}</span>
<a name="line-798"></a>
<a name="line-799"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.fold' instead</span>
<a name="line-800"></a><span class='hs-comment'>--</span>
<a name="line-801"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-802"></a>
<a name="line-803"></a><a name="foldl'"></a><span class='hs-definition'>foldl'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-804"></a><span class='hs-definition'>foldl'</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>fold</span>
<a name="line-805"></a>
<a name="line-806"></a><span class='hs-comment'>{-# DEPRECATED foldM "Use Data.Enumerator.List.foldM instead" #-}</span>
<a name="line-807"></a>
<a name="line-808"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.foldM' instead</span>
<a name="line-809"></a><span class='hs-comment'>--</span>
<a name="line-810"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-811"></a>
<a name="line-812"></a><a name="foldM"></a><span class='hs-definition'>foldM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-813"></a><span class='hs-definition'>foldM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>foldM</span>
<a name="line-814"></a>
<a name="line-815"></a><span class='hs-comment'>{-# DEPRECATED iterate "Use Data.Enumerator.List.iterate instead" #-}</span>
<a name="line-816"></a>
<a name="line-817"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.iterate' instead</span>
<a name="line-818"></a><span class='hs-comment'>--</span>
<a name="line-819"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-820"></a>
<a name="line-821"></a><a name="iterate"></a><span class='hs-definition'>iterate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-822"></a><span class='hs-definition'>iterate</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>iterate</span>
<a name="line-823"></a>
<a name="line-824"></a><span class='hs-comment'>{-# DEPRECATED iterateM "Use Data.Enumerator.List.iterateM instead" #-}</span>
<a name="line-825"></a>
<a name="line-826"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.iterateM' instead</span>
<a name="line-827"></a><span class='hs-comment'>--</span>
<a name="line-828"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-829"></a>
<a name="line-830"></a><a name="iterateM"></a><span class='hs-definition'>iterateM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-831"></a><span class='hs-definition'>iterateM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>iterateM</span>
<a name="line-832"></a>
<a name="line-833"></a><span class='hs-comment'>{-# DEPRECATED repeat "Use Data.Enumerator.List.repeat instead" #-}</span>
<a name="line-834"></a>
<a name="line-835"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.repeat' instead</span>
<a name="line-836"></a><span class='hs-comment'>--</span>
<a name="line-837"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-838"></a>
<a name="line-839"></a><a name="repeat"></a><span class='hs-definition'>repeat</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-840"></a><span class='hs-definition'>repeat</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>repeat</span>
<a name="line-841"></a>
<a name="line-842"></a><span class='hs-comment'>{-# DEPRECATED repeatM "Use Data.Enumerator.List.repeatM instead" #-}</span>
<a name="line-843"></a>
<a name="line-844"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.repeatM' instead</span>
<a name="line-845"></a><span class='hs-comment'>--</span>
<a name="line-846"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-847"></a>
<a name="line-848"></a><a name="repeatM"></a><span class='hs-definition'>repeatM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>m</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-849"></a><span class='hs-definition'>repeatM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>repeatM</span>
<a name="line-850"></a>
<a name="line-851"></a><span class='hs-comment'>{-# DEPRECATED replicate "Use Data.Enumerator.List.replicate instead" #-}</span>
<a name="line-852"></a>
<a name="line-853"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.replicate' instead</span>
<a name="line-854"></a><span class='hs-comment'>--</span>
<a name="line-855"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-856"></a>
<a name="line-857"></a><a name="replicate"></a><span class='hs-definition'>replicate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Integer</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-858"></a><span class='hs-definition'>replicate</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>replicate</span>
<a name="line-859"></a>
<a name="line-860"></a><span class='hs-comment'>{-# DEPRECATED replicateM "Use Data.Enumerator.List.replicateM instead" #-}</span>
<a name="line-861"></a>
<a name="line-862"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.replicateM' instead</span>
<a name="line-863"></a><span class='hs-comment'>--</span>
<a name="line-864"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-865"></a>
<a name="line-866"></a><a name="replicateM"></a><span class='hs-definition'>replicateM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Integer</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-867"></a><span class='hs-definition'>replicateM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>replicateM</span>
<a name="line-868"></a>
<a name="line-869"></a><span class='hs-comment'>{-# DEPRECATED generateM "Use Data.Enumerator.List.generateM instead" #-}</span>
<a name="line-870"></a>
<a name="line-871"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.generateM' instead</span>
<a name="line-872"></a><span class='hs-comment'>--</span>
<a name="line-873"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-874"></a>
<a name="line-875"></a><a name="generateM"></a><span class='hs-definition'>generateM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumerator</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-876"></a><span class='hs-definition'>generateM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>generateM</span>
<a name="line-877"></a>
<a name="line-878"></a><span class='hs-comment'>{-# DEPRECATED map "Use Data.Enumerator.List.map instead" #-}</span>
<a name="line-879"></a>
<a name="line-880"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.map' instead</span>
<a name="line-881"></a>
<a name="line-882"></a><a name="map"></a><span class='hs-definition'>map</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>ao</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>ai</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-883"></a><span class='hs-definition'>map</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span>
<a name="line-884"></a>
<a name="line-885"></a><span class='hs-comment'>{-# DEPRECATED mapM "Use Data.Enumerator.List.mapM instead" #-}</span>
<a name="line-886"></a>
<a name="line-887"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.mapM' instead</span>
<a name="line-888"></a><span class='hs-comment'>--</span>
<a name="line-889"></a><span class='hs-comment'>-- Since: 0.4.3</span>
<a name="line-890"></a>
<a name="line-891"></a><a name="mapM"></a><span class='hs-definition'>mapM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>ao</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-varid'>ai</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-892"></a><span class='hs-definition'>mapM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>mapM</span>
<a name="line-893"></a>
<a name="line-894"></a><span class='hs-comment'>{-# DEPRECATED concatMap "Use Data.Enumerator.List.concatMap instead" #-}</span>
<a name="line-895"></a>
<a name="line-896"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.concatMap' instead</span>
<a name="line-897"></a><span class='hs-comment'>--</span>
<a name="line-898"></a><span class='hs-comment'>-- Since: 0.4.3</span>
<a name="line-899"></a>
<a name="line-900"></a><a name="concatMap"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>ao</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>ai</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-901"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>concatMap</span>
<a name="line-902"></a>
<a name="line-903"></a><span class='hs-comment'>{-# DEPRECATED concatMapM "Use Data.Enumerator.List.concatMapM instead" #-}</span>
<a name="line-904"></a>
<a name="line-905"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.concatMapM' instead</span>
<a name="line-906"></a><span class='hs-comment'>--</span>
<a name="line-907"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-908"></a>
<a name="line-909"></a><a name="concatMapM"></a><span class='hs-definition'>concatMapM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>ao</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>ai</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>ao</span> <span class='hs-varid'>ai</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-910"></a><span class='hs-definition'>concatMapM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>concatMapM</span>
<a name="line-911"></a>
<a name="line-912"></a><span class='hs-comment'>{-# DEPRECATED filter "Use Data.Enumerator.List.filter instead" #-}</span>
<a name="line-913"></a>
<a name="line-914"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.filter' instead</span>
<a name="line-915"></a><span class='hs-comment'>--</span>
<a name="line-916"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-917"></a>
<a name="line-918"></a><a name="filter"></a><span class='hs-definition'>filter</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-919"></a><span class='hs-definition'>filter</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>filter</span>
<a name="line-920"></a>
<a name="line-921"></a><span class='hs-comment'>{-# DEPRECATED filterM "Use Data.Enumerator.List.filterM instead" #-}</span>
<a name="line-922"></a>
<a name="line-923"></a><span class='hs-comment'>-- | Deprecated in 0.4.8: use 'Data.Enumerator.List.filterM' instead</span>
<a name="line-924"></a><span class='hs-comment'>--</span>
<a name="line-925"></a><span class='hs-comment'>-- Since: 0.4.5</span>
<a name="line-926"></a>
<a name="line-927"></a><a name="filterM"></a><span class='hs-definition'>filterM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Enumeratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-928"></a><span class='hs-definition'>filterM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>filterM</span>
<a name="line-929"></a>
<a name="line-930"></a><span class='hs-comment'>{-# DEPRECATED liftFoldL "Use Data.Enumerator.List.fold instead" #-}</span>
<a name="line-931"></a>
<a name="line-932"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.fold' instead</span>
<a name="line-933"></a><span class='hs-comment'>--</span>
<a name="line-934"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-935"></a>
<a name="line-936"></a><a name="liftFoldL"></a><span class='hs-definition'>liftFoldL</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span>
<a name="line-937"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-938"></a><span class='hs-definition'>liftFoldL</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Enumerator</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span>
<a name="line-939"></a>
<a name="line-940"></a><span class='hs-comment'>{-# DEPRECATED liftFoldL' "Use Data.Enumerator.List.fold instead" #-}</span>
<a name="line-941"></a>
<a name="line-942"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.fold' instead</span>
<a name="line-943"></a><span class='hs-comment'>--</span>
<a name="line-944"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-945"></a>
<a name="line-946"></a><a name="liftFoldL'"></a><span class='hs-definition'>liftFoldL'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span>
<a name="line-947"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-948"></a><span class='hs-definition'>liftFoldL'</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>fold</span>
<a name="line-949"></a>
<a name="line-950"></a><span class='hs-comment'>{-# DEPRECATED liftFoldM "Use Data.Enumerator.List.foldM instead" #-}</span>
<a name="line-951"></a>
<a name="line-952"></a><span class='hs-comment'>-- | Deprecated in 0.4.5: use 'Data.Enumerator.List.foldM' instead</span>
<a name="line-953"></a><span class='hs-comment'>--</span>
<a name="line-954"></a><span class='hs-comment'>-- Since: 0.1.1</span>
<a name="line-955"></a>
<a name="line-956"></a><a name="liftFoldM"></a><span class='hs-definition'>liftFoldM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Monad</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>b</span>
<a name="line-957"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Iteratee</span> <span class='hs-varid'>a</span> <span class='hs-varid'>m</span> <span class='hs-varid'>b</span>
<a name="line-958"></a><span class='hs-definition'>liftFoldM</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>EL</span><span class='hs-varop'>.</span><span class='hs-varid'>foldM</span>
</pre></body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
0b5d03d6b0fe6eec9f6a8cc33941032f
>
files
>
53
