<?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>src/Data/List/Utils.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>{- arch-tag: List utilities main file
<a name="line-2"></a>Copyright (C) 2004-2006 John Goerzen <jgoerzen@complete.org>
<a name="line-3"></a>
<a name="line-4"></a>This program is free software; you can redistribute it and/or modify
<a name="line-5"></a>it under the terms of the GNU General Public License as published by
<a name="line-6"></a>the Free Software Foundation; either version 2 of the License, or
<a name="line-7"></a>(at your option) any later version.
<a name="line-8"></a>
<a name="line-9"></a>This program is distributed in the hope that it will be useful,
<a name="line-10"></a>but WITHOUT ANY WARRANTY; without even the implied warranty of
<a name="line-11"></a>MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
<a name="line-12"></a>GNU General Public License for more details.
<a name="line-13"></a>
<a name="line-14"></a>You should have received a copy of the GNU General Public License
<a name="line-15"></a>along with this program; if not, write to the Free Software
<a name="line-16"></a>Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
<a name="line-17"></a>-}</span>
<a name="line-18"></a>
<a name="line-19"></a><span class='hs-comment'>{- |
<a name="line-20"></a> Module : Data.List.Utils
<a name="line-21"></a> Copyright : Copyright (C) 2004-2006 John Goerzen
<a name="line-22"></a> License : GNU GPL, version 2 or above
<a name="line-23"></a>
<a name="line-24"></a> Maintainer : John Goerzen <jgoerzen@complete.org>
<a name="line-25"></a> Stability : provisional
<a name="line-26"></a> Portability: portable
<a name="line-27"></a>
<a name="line-28"></a>This module provides various helpful utilities for dealing with lists.
<a name="line-29"></a>
<a name="line-30"></a>Written by John Goerzen, jgoerzen\@complete.org
<a name="line-31"></a>-}</span>
<a name="line-32"></a>
<a name="line-33"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span><span class='hs-varop'>.</span><span class='hs-conid'>Utils</span><span class='hs-layout'>(</span><span class='hs-comment'>-- * Merging</span>
<a name="line-34"></a> <span class='hs-varid'>merge</span><span class='hs-layout'>,</span> <span class='hs-varid'>mergeBy</span><span class='hs-layout'>,</span>
<a name="line-35"></a> <span class='hs-comment'>-- * Tests</span>
<a name="line-36"></a> <span class='hs-varid'>startswith</span><span class='hs-layout'>,</span> <span class='hs-varid'>endswith</span><span class='hs-layout'>,</span> <span class='hs-varid'>contains</span><span class='hs-layout'>,</span> <span class='hs-varid'>hasAny</span><span class='hs-layout'>,</span>
<a name="line-37"></a> <span class='hs-comment'>-- * Association List Utilities</span>
<a name="line-38"></a> <span class='hs-comment'>{- | These functions are designed to augment the
<a name="line-39"></a> association list functions in "Data.List" and
<a name="line-40"></a> provide an interface similar to "Data.FiniteMap" or
<a name="line-41"></a> "Data.Map"
<a name="line-42"></a> for association lists. -}</span>
<a name="line-43"></a> <span class='hs-varid'>addToAL</span><span class='hs-layout'>,</span> <span class='hs-varid'>delFromAL</span><span class='hs-layout'>,</span> <span class='hs-varid'>flipAL</span><span class='hs-layout'>,</span> <span class='hs-varid'>keysAL</span><span class='hs-layout'>,</span> <span class='hs-varid'>valuesAL</span><span class='hs-layout'>,</span>
<a name="line-44"></a> <span class='hs-varid'>hasKeyAL</span><span class='hs-layout'>,</span>
<a name="line-45"></a> <span class='hs-comment'>-- ** Association List Conversions</span>
<a name="line-46"></a> <span class='hs-varid'>strFromAL</span><span class='hs-layout'>,</span>
<a name="line-47"></a> <span class='hs-varid'>strToAL</span><span class='hs-layout'>,</span>
<a name="line-48"></a> <span class='hs-comment'>-- * Conversions</span>
<a name="line-49"></a> <span class='hs-varid'>split</span><span class='hs-layout'>,</span> <span class='hs-varid'>join</span><span class='hs-layout'>,</span> <span class='hs-varid'>replace</span><span class='hs-layout'>,</span> <span class='hs-varid'>genericJoin</span><span class='hs-layout'>,</span> <span class='hs-varid'>takeWhileList</span><span class='hs-layout'>,</span>
<a name="line-50"></a> <span class='hs-varid'>dropWhileList</span><span class='hs-layout'>,</span> <span class='hs-varid'>spanList</span><span class='hs-layout'>,</span> <span class='hs-varid'>breakList</span><span class='hs-layout'>,</span>
<a name="line-51"></a> <span class='hs-comment'>-- ** Advanced Conversions</span>
<a name="line-52"></a> <span class='hs-conid'>WholeFunc</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>wholeMap</span><span class='hs-layout'>,</span> <span class='hs-varid'>fixedWidth</span><span class='hs-layout'>,</span>
<a name="line-53"></a> <span class='hs-comment'>-- * Fixed-Width and State Monad Utilities</span>
<a name="line-54"></a> <span class='hs-varid'>grab</span><span class='hs-layout'>,</span>
<a name="line-55"></a> <span class='hs-comment'>-- * Miscellaneous</span>
<a name="line-56"></a> <span class='hs-varid'>countElem</span><span class='hs-layout'>,</span> <span class='hs-varid'>elemRIndex</span><span class='hs-layout'>,</span> <span class='hs-varid'>alwaysElemRIndex</span><span class='hs-layout'>,</span> <span class='hs-varid'>seqList</span><span class='hs-layout'>,</span>
<a name="line-57"></a> <span class='hs-varid'>subIndex</span><span class='hs-layout'>,</span> <span class='hs-varid'>uniq</span>
<a name="line-58"></a> <span class='hs-comment'>-- -- * Sub-List Selection</span>
<a name="line-59"></a> <span class='hs-comment'>-- sub,</span>
<a name="line-60"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-61"></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'>intersperse</span><span class='hs-layout'>,</span> <span class='hs-varid'>concat</span><span class='hs-layout'>,</span> <span class='hs-varid'>isPrefixOf</span><span class='hs-layout'>,</span> <span class='hs-varid'>isSuffixOf</span><span class='hs-layout'>,</span> <span class='hs-varid'>elemIndices</span><span class='hs-layout'>,</span>
<a name="line-62"></a> <span class='hs-varid'>elemIndex</span><span class='hs-layout'>,</span> <span class='hs-varid'>elemIndices</span><span class='hs-layout'>,</span> <span class='hs-varid'>tails</span><span class='hs-layout'>,</span> <span class='hs-varid'>find</span><span class='hs-layout'>,</span> <span class='hs-varid'>findIndex</span><span class='hs-layout'>,</span> <span class='hs-varid'>isInfixOf</span><span class='hs-layout'>,</span> <span class='hs-varid'>nub</span><span class='hs-layout'>)</span>
<a name="line-63"></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'>State</span><span class='hs-layout'>(</span><span class='hs-conid'>State</span><span class='hs-layout'>,</span> <span class='hs-varid'>get</span><span class='hs-layout'>,</span> <span class='hs-varid'>put</span><span class='hs-layout'>)</span>
<a name="line-64"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Maybe</span><span class='hs-layout'>(</span><span class='hs-varid'>isJust</span><span class='hs-layout'>)</span>
<a name="line-65"></a>
<a name="line-66"></a>
<a name="line-67"></a><a name="merge"></a><span class='hs-comment'>{- | Merge two sorted lists into a single, sorted whole.
<a name="line-68"></a>
<a name="line-69"></a>Example:
<a name="line-70"></a>
<a name="line-71"></a>> merge [1,3,5] [1,2,4,6] -> [1,1,2,3,4,5,6]
<a name="line-72"></a>
<a name="line-73"></a>QuickCheck test property:
<a name="line-74"></a>
<a name="line-75"></a>prop_merge xs ys =
<a name="line-76"></a> merge (sort xs) (sort ys) == sort (xs ++ ys)
<a name="line-77"></a> where types = xs :: [Int]
<a name="line-78"></a>-}</span>
<a name="line-79"></a><span class='hs-definition'>merge</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ord</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-80"></a><span class='hs-definition'>merge</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mergeBy</span> <span class='hs-layout'>(</span><span class='hs-varid'>compare</span><span class='hs-layout'>)</span>
<a name="line-81"></a>
<a name="line-82"></a><a name="mergeBy"></a><span class='hs-comment'>{- | Merge two sorted lists using into a single, sorted whole,
<a name="line-83"></a>allowing the programmer to specify the comparison function.
<a name="line-84"></a>
<a name="line-85"></a>QuickCheck test property:
<a name="line-86"></a>
<a name="line-87"></a>prop_mergeBy xs ys =
<a name="line-88"></a> mergeBy cmp (sortBy cmp xs) (sortBy cmp ys) == sortBy cmp (xs ++ ys)
<a name="line-89"></a> where types = xs :: [ (Int, Int) ]
<a name="line-90"></a> cmp (x1,_) (x2,_) = compare x1 x2
<a name="line-91"></a>-}</span>
<a name="line-92"></a><span class='hs-definition'>mergeBy</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-keyglyph'>-></span> <span class='hs-conid'>Ordering</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-93"></a><span class='hs-definition'>mergeBy</span> <span class='hs-varid'>cmp</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>ys</span>
<a name="line-94"></a><span class='hs-definition'>mergeBy</span> <span class='hs-varid'>cmp</span> <span class='hs-varid'>xs</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>xs</span>
<a name="line-95"></a><span class='hs-definition'>mergeBy</span> <span class='hs-varid'>cmp</span> <span class='hs-layout'>(</span><span class='hs-varid'>allx</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>ally</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>y</span><span class='hs-conop'>:</span><span class='hs-varid'>ys</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-96"></a> <span class='hs-comment'>-- Ordering derives Eq, Ord, so the comparison below is valid.</span>
<a name="line-97"></a> <span class='hs-comment'>-- Explanation left as an exercise for the reader.</span>
<a name="line-98"></a> <span class='hs-comment'>-- Someone please put this code out of its misery.</span>
<a name="line-99"></a> <span class='hs-keyglyph'>|</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span> <span class='hs-varop'>`cmp`</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-varop'><=</span> <span class='hs-conid'>EQ</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span> <span class='hs-conop'>:</span> <span class='hs-varid'>mergeBy</span> <span class='hs-varid'>cmp</span> <span class='hs-varid'>xs</span> <span class='hs-varid'>ally</span>
<a name="line-100"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>y</span> <span class='hs-conop'>:</span> <span class='hs-varid'>mergeBy</span> <span class='hs-varid'>cmp</span> <span class='hs-varid'>allx</span> <span class='hs-varid'>ys</span>
<a name="line-101"></a>
<a name="line-102"></a><span class='hs-comment'>{- | Returns true if the given list starts with the specified elements;
<a name="line-103"></a>false otherwise. (This is an alias for "Data.List.isPrefixOf".)
<a name="line-104"></a>
<a name="line-105"></a>Example:
<a name="line-106"></a>
<a name="line-107"></a>> startswith "He" "Hello" -> True
<a name="line-108"></a>
<a name="line-109"></a>-}</span>
<a name="line-110"></a>
<a name="line-111"></a><a name="startswith"></a><span class='hs-definition'>startswith</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span>
<a name="line-112"></a><span class='hs-definition'>startswith</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>isPrefixOf</span>
<a name="line-113"></a>
<a name="line-114"></a><a name="endswith"></a><span class='hs-comment'>{- | Returns true if the given list ends with the specified elements;
<a name="line-115"></a>false otherwise. (This is an alias for "Data.List.isSuffixOf".)
<a name="line-116"></a>
<a name="line-117"></a>Example:
<a name="line-118"></a>
<a name="line-119"></a>> endswith "lo" "Hello" -> True
<a name="line-120"></a>
<a name="line-121"></a>-}</span>
<a name="line-122"></a><span class='hs-definition'>endswith</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span>
<a name="line-123"></a><span class='hs-definition'>endswith</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>isSuffixOf</span>
<a name="line-124"></a>
<a name="line-125"></a><a name="hasAny"></a><span class='hs-comment'>{- | Returns true if the given list contains any of the elements in the search
<a name="line-126"></a>list. -}</span>
<a name="line-127"></a><span class='hs-definition'>hasAny</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</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-comment'>-- ^ List of elements to look for</span>
<a name="line-128"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ List to search</span>
<a name="line-129"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <span class='hs-comment'>-- ^ Result</span>
<a name="line-130"></a><span class='hs-definition'>hasAny</span> <span class='hs-conid'>[]</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span> <span class='hs-comment'>-- An empty search list: always false</span>
<a name="line-131"></a><span class='hs-definition'>hasAny</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>False</span> <span class='hs-comment'>-- An empty list to scan: always false</span>
<a name="line-132"></a><span class='hs-definition'>hasAny</span> <span class='hs-varid'>search</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>x</span> <span class='hs-varop'>`elem`</span> <span class='hs-varid'>search</span> <span class='hs-keyword'>then</span> <span class='hs-conid'>True</span> <span class='hs-keyword'>else</span> <span class='hs-varid'>hasAny</span> <span class='hs-varid'>search</span> <span class='hs-varid'>xs</span>
<a name="line-133"></a>
<a name="line-134"></a><a name="takeWhileList"></a><span class='hs-comment'>{- | Similar to Data.List.takeWhile, takes elements while the func is true.
<a name="line-135"></a>The function is given the remainder of the list to examine. -}</span>
<a name="line-136"></a><span class='hs-definition'>takeWhileList</span> <span class='hs-keyglyph'>::</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-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-137"></a><span class='hs-definition'>takeWhileList</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-138"></a><span class='hs-definition'>takeWhileList</span> <span class='hs-varid'>func</span> <span class='hs-varid'>list</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span>
<a name="line-139"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>func</span> <span class='hs-varid'>list</span>
<a name="line-140"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>x</span> <span class='hs-conop'>:</span> <span class='hs-varid'>takeWhileList</span> <span class='hs-varid'>func</span> <span class='hs-varid'>xs</span>
<a name="line-141"></a> <span class='hs-keyword'>else</span> <span class='hs-conid'>[]</span>
<a name="line-142"></a>
<a name="line-143"></a><a name="dropWhileList"></a><span class='hs-comment'>{- | Similar to Data.List.dropWhile, drops elements while the func is true.
<a name="line-144"></a>The function is given the remainder of the list to examine. -}</span>
<a name="line-145"></a><span class='hs-definition'>dropWhileList</span> <span class='hs-keyglyph'>::</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-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-146"></a><span class='hs-definition'>dropWhileList</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-147"></a><span class='hs-definition'>dropWhileList</span> <span class='hs-varid'>func</span> <span class='hs-varid'>list</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span>
<a name="line-148"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>func</span> <span class='hs-varid'>list</span>
<a name="line-149"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>dropWhileList</span> <span class='hs-varid'>func</span> <span class='hs-varid'>xs</span>
<a name="line-150"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>list</span>
<a name="line-151"></a>
<a name="line-152"></a><a name="spanList"></a><span class='hs-comment'>{- | Similar to Data.List.span, but performs the test on the entire remaining
<a name="line-153"></a>list instead of just one element.
<a name="line-154"></a>
<a name="line-155"></a>@spanList p xs@ is the same as @(takeWhileList p xs, dropWhileList p xs)@
<a name="line-156"></a>-}</span>
<a name="line-157"></a><span class='hs-definition'>spanList</span> <span class='hs-keyglyph'>::</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-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</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-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-158"></a>
<a name="line-159"></a><span class='hs-definition'>spanList</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>[]</span><span class='hs-layout'>,</span><span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-160"></a><span class='hs-definition'>spanList</span> <span class='hs-varid'>func</span> <span class='hs-varid'>list</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span>
<a name="line-161"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>func</span> <span class='hs-varid'>list</span>
<a name="line-162"></a> <span class='hs-keyword'>then</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>ys</span><span class='hs-layout'>,</span><span class='hs-varid'>zs</span><span class='hs-layout'>)</span>
<a name="line-163"></a> <span class='hs-keyword'>else</span> <span class='hs-layout'>(</span><span class='hs-conid'>[]</span><span class='hs-layout'>,</span><span class='hs-varid'>list</span><span class='hs-layout'>)</span>
<a name="line-164"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>ys</span><span class='hs-layout'>,</span><span class='hs-varid'>zs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>spanList</span> <span class='hs-varid'>func</span> <span class='hs-varid'>xs</span>
<a name="line-165"></a>
<a name="line-166"></a><a name="breakList"></a><span class='hs-comment'>{- | Similar to Data.List.break, but performs the test on the entire remaining
<a name="line-167"></a>list instead of just one element.
<a name="line-168"></a>-}</span>
<a name="line-169"></a><span class='hs-definition'>breakList</span> <span class='hs-keyglyph'>::</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-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</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-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-170"></a><span class='hs-definition'>breakList</span> <span class='hs-varid'>func</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>spanList</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>func</span><span class='hs-layout'>)</span>
<a name="line-171"></a>
<a name="line-172"></a><a name="split"></a><span class='hs-comment'>{- | Given a delimiter and a list (or string), split into components.
<a name="line-173"></a>
<a name="line-174"></a>Example:
<a name="line-175"></a>
<a name="line-176"></a>> split "," "foo,bar,,baz," -> ["foo", "bar", "", "baz", ""]
<a name="line-177"></a>
<a name="line-178"></a>> split "ba" ",foo,bar,,baz," -> [",foo,","r,,","z,"]
<a name="line-179"></a>-}</span>
<a name="line-180"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>]</span>
<a name="line-181"></a><span class='hs-definition'>split</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-182"></a><span class='hs-definition'>split</span> <span class='hs-varid'>delim</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</span>
<a name="line-183"></a> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>firstline</span><span class='hs-layout'>,</span> <span class='hs-varid'>remainder</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>breakList</span> <span class='hs-layout'>(</span><span class='hs-varid'>startswith</span> <span class='hs-varid'>delim</span><span class='hs-layout'>)</span> <span class='hs-varid'>str</span>
<a name="line-184"></a> <span class='hs-keyword'>in</span>
<a name="line-185"></a> <span class='hs-varid'>firstline</span> <span class='hs-conop'>:</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>remainder</span> <span class='hs-keyword'>of</span>
<a name="line-186"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>[]</span>
<a name="line-187"></a> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>if</span> <span class='hs-varid'>x</span> <span class='hs-varop'>==</span> <span class='hs-varid'>delim</span>
<a name="line-188"></a> <span class='hs-keyword'>then</span> <span class='hs-conid'>[]</span> <span class='hs-conop'>:</span> <span class='hs-conid'>[]</span>
<a name="line-189"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>split</span> <span class='hs-varid'>delim</span>
<a name="line-190"></a> <span class='hs-layout'>(</span><span class='hs-varid'>drop</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>delim</span><span class='hs-layout'>)</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span>
<a name="line-191"></a>
<a name="line-192"></a>
<a name="line-193"></a><span class='hs-comment'>{- | Given a list and a replacement list, replaces each occurance of the search
<a name="line-194"></a>list with the replacement list in the operation list.
<a name="line-195"></a>
<a name="line-196"></a>Example:
<a name="line-197"></a>
<a name="line-198"></a>>replace "," "." "127,0,0,1" -> "127.0.0.1"
<a name="line-199"></a>
<a name="line-200"></a>This could logically be thought of as:
<a name="line-201"></a>
<a name="line-202"></a>>replace old new l = join new . split old $ l
<a name="line-203"></a>-}</span>
<a name="line-204"></a>
<a name="line-205"></a><a name="replace"></a><span class='hs-definition'>replace</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-206"></a><span class='hs-definition'>replace</span> <span class='hs-varid'>old</span> <span class='hs-varid'>new</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>join</span> <span class='hs-varid'>new</span> <span class='hs-varop'>.</span> <span class='hs-varid'>split</span> <span class='hs-varid'>old</span> <span class='hs-varop'>$</span> <span class='hs-varid'>l</span>
<a name="line-207"></a>
<a name="line-208"></a><a name="join"></a><span class='hs-comment'>{- | Given a delimiter and a list of items (or strings), join the items
<a name="line-209"></a>by using the delimiter.
<a name="line-210"></a>
<a name="line-211"></a>Example:
<a name="line-212"></a>
<a name="line-213"></a>> join "|" ["foo", "bar", "baz"] -> "foo|bar|baz"
<a name="line-214"></a>-}</span>
<a name="line-215"></a><span class='hs-definition'>join</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-216"></a><span class='hs-definition'>join</span> <span class='hs-varid'>delim</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-layout'>(</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>delim</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-217"></a>
<a name="line-218"></a><a name="genericJoin"></a><span class='hs-comment'>{- | Like 'join', but works with a list of anything showable, converting
<a name="line-219"></a>it to a String.
<a name="line-220"></a>
<a name="line-221"></a>Examples:
<a name="line-222"></a>
<a name="line-223"></a>> genericJoin ", " [1, 2, 3, 4] -> "1, 2, 3, 4"
<a name="line-224"></a>> genericJoin "|" ["foo", "bar", "baz"] -> "\"foo\"|\"bar\"|\"baz\""
<a name="line-225"></a>
<a name="line-226"></a>-}</span>
<a name="line-227"></a><span class='hs-definition'>genericJoin</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Show</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>String</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'>String</span>
<a name="line-228"></a><span class='hs-definition'>genericJoin</span> <span class='hs-varid'>delim</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>join</span> <span class='hs-varid'>delim</span> <span class='hs-layout'>(</span><span class='hs-varid'>map</span> <span class='hs-varid'>show</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span>
<a name="line-229"></a>
<a name="line-230"></a><span class='hs-comment'>{-# DEPRECATED contains "Use Data.List.isInfixOf, will be removed in MissingH 1.1.0" #-}</span>
<a name="line-231"></a><span class='hs-comment'>{- | Returns true if the given parameter is a sublist of the given list;
<a name="line-232"></a>false otherwise.
<a name="line-233"></a>
<a name="line-234"></a>Example:
<a name="line-235"></a>
<a name="line-236"></a>> contains "Haskell" "I really like Haskell." -> True
<a name="line-237"></a>> contains "Haskell" "OCaml is great." -> False
<a name="line-238"></a>
<a name="line-239"></a>This function was submitted to GHC and was applied as
<a name="line-240"></a>'Data.List.isInfixOf'. This function therefore is deprecated and will
<a name="line-241"></a>be removed in future versions.
<a name="line-242"></a>-}</span>
<a name="line-243"></a>
<a name="line-244"></a><a name="contains"></a><span class='hs-definition'>contains</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span>
<a name="line-245"></a><span class='hs-definition'>contains</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>isInfixOf</span>
<a name="line-246"></a>
<a name="line-247"></a><span class='hs-comment'>-- above function submitted to GHC as Data.List.isInfixOf on 8/31/2006</span>
<a name="line-248"></a>
<a name="line-249"></a><a name="addToAL"></a><span class='hs-comment'>{- | Adds the specified (key, value) pair to the given list, removing any
<a name="line-250"></a>existing pair with the same key already present. -}</span>
<a name="line-251"></a><span class='hs-definition'>addToAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>key</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>elt</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>key</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>elt</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>elt</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-252"></a><span class='hs-definition'>addToAL</span> <span class='hs-varid'>l</span> <span class='hs-varid'>key</span> <span class='hs-varid'>value</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>value</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>delFromAL</span> <span class='hs-varid'>l</span> <span class='hs-varid'>key</span>
<a name="line-253"></a>
<a name="line-254"></a><a name="delFromAL"></a><span class='hs-comment'>{- | Removes all (key, value) pairs from the given list where the key
<a name="line-255"></a>matches the given one. -}</span>
<a name="line-256"></a><span class='hs-definition'>delFromAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>key</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>key</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-257"></a><span class='hs-definition'>delFromAL</span> <span class='hs-varid'>l</span> <span class='hs-varid'>key</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>fst</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varop'>/=</span> <span class='hs-varid'>key</span><span class='hs-layout'>)</span> <span class='hs-varid'>l</span>
<a name="line-258"></a>
<a name="line-259"></a><a name="keysAL"></a><span class='hs-comment'>{- | Returns the keys that comprise the (key, value) pairs of the given AL.
<a name="line-260"></a>
<a name="line-261"></a>Same as:
<a name="line-262"></a>
<a name="line-263"></a>>map fst
<a name="line-264"></a>-}</span>
<a name="line-265"></a><span class='hs-definition'>keysAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>key</span><span class='hs-keyglyph'>]</span>
<a name="line-266"></a><span class='hs-definition'>keysAL</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>map</span> <span class='hs-varid'>fst</span>
<a name="line-267"></a>
<a name="line-268"></a><a name="valuesAL"></a><span class='hs-comment'>{- | Returns the values the comprise the (key, value) pairs of the given
<a name="line-269"></a>AL.
<a name="line-270"></a>
<a name="line-271"></a>Same as:
<a name="line-272"></a>
<a name="line-273"></a>>map snd
<a name="line-274"></a>-}</span>
<a name="line-275"></a><span class='hs-definition'>valuesAL</span> <span class='hs-keyglyph'>::</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'>value</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>value</span><span class='hs-keyglyph'>]</span>
<a name="line-276"></a><span class='hs-definition'>valuesAL</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>map</span> <span class='hs-varid'>snd</span>
<a name="line-277"></a>
<a name="line-278"></a><a name="hasKeyAL"></a><span class='hs-comment'>{- | Indicates whether or not the given key is in the AL. -}</span>
<a name="line-279"></a><span class='hs-definition'>hasKeyAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</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-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span>
<a name="line-280"></a><span class='hs-definition'>hasKeyAL</span> <span class='hs-varid'>key</span> <span class='hs-varid'>list</span> <span class='hs-keyglyph'>=</span>
<a name="line-281"></a> <span class='hs-varid'>elem</span> <span class='hs-varid'>key</span> <span class='hs-layout'>(</span><span class='hs-varid'>keysAL</span> <span class='hs-varid'>list</span><span class='hs-layout'>)</span>
<a name="line-282"></a>
<a name="line-283"></a><a name="flipAL"></a><span class='hs-comment'>{- | Flips an association list. Converts (key1, val), (key2, val) pairs
<a name="line-284"></a>to (val, [key1, key2]). -}</span>
<a name="line-285"></a><span class='hs-definition'>flipAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span> <span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>val</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>val</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>val</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>key</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-286"></a><span class='hs-definition'>flipAL</span> <span class='hs-varid'>oldl</span> <span class='hs-keyglyph'>=</span>
<a name="line-287"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>worker</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span> <span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>val</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>val</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>val</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>key</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>val</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>key</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-288"></a> <span class='hs-varid'>worker</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>accum</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>accum</span>
<a name="line-289"></a> <span class='hs-varid'>worker</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>k</span><span class='hs-layout'>,</span> <span class='hs-varid'>v</span><span class='hs-layout'>)</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-varid'>accum</span> <span class='hs-keyglyph'>=</span>
<a name="line-290"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>lookup</span> <span class='hs-varid'>v</span> <span class='hs-varid'>accum</span> <span class='hs-keyword'>of</span>
<a name="line-291"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>worker</span> <span class='hs-varid'>xs</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>v</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>k</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>accum</span><span class='hs-layout'>)</span>
<a name="line-292"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>worker</span> <span class='hs-varid'>xs</span> <span class='hs-layout'>(</span><span class='hs-varid'>addToAL</span> <span class='hs-varid'>accum</span> <span class='hs-varid'>v</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span><span class='hs-conop'>:</span><span class='hs-varid'>y</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-293"></a> <span class='hs-keyword'>in</span>
<a name="line-294"></a> <span class='hs-varid'>worker</span> <span class='hs-varid'>oldl</span> <span class='hs-conid'>[]</span>
<a name="line-295"></a>
<a name="line-296"></a><span class='hs-comment'>{- | Converts an association list to a string. The string will have
<a name="line-297"></a>one pair per line, with the key and value both represented as a Haskell string.
<a name="line-298"></a>
<a name="line-299"></a>This function is designed to work with [(String, String)] association lists,
<a name="line-300"></a>but may work with other types as well. -}</span>
<a name="line-301"></a>
<a name="line-302"></a><a name="strFromAL"></a><span class='hs-definition'>strFromAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Show</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></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'>b</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span>
<a name="line-303"></a><span class='hs-definition'>strFromAL</span> <span class='hs-varid'>inp</span> <span class='hs-keyglyph'>=</span>
<a name="line-304"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>worker</span> <span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>val</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>show</span> <span class='hs-varid'>key</span> <span class='hs-varop'>++</span> <span class='hs-str'>","</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>val</span>
<a name="line-305"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>unlines</span> <span class='hs-varop'>.</span> <span class='hs-varid'>map</span> <span class='hs-varid'>worker</span> <span class='hs-varop'>$</span> <span class='hs-varid'>inp</span>
<a name="line-306"></a>
<a name="line-307"></a><a name="strToAL"></a><span class='hs-comment'>{- | The inverse of 'strFromAL', this function reads a string and outputs the
<a name="line-308"></a>appropriate association list.
<a name="line-309"></a>
<a name="line-310"></a>Like 'strFromAL', this is designed to work with [(String, String)] association
<a name="line-311"></a>lists but may also work with other objects with simple representations.
<a name="line-312"></a>-}</span>
<a name="line-313"></a><span class='hs-definition'>strToAL</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Read</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>Read</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></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'>b</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-314"></a><span class='hs-definition'>strToAL</span> <span class='hs-varid'>inp</span> <span class='hs-keyglyph'>=</span>
<a name="line-315"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>worker</span> <span class='hs-varid'>line</span> <span class='hs-keyglyph'>=</span>
<a name="line-316"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>reads</span> <span class='hs-varid'>line</span> <span class='hs-keyword'>of</span>
<a name="line-317"></a> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>remainder</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>remainder</span> <span class='hs-keyword'>of</span>
<a name="line-318"></a> <span class='hs-chr'>','</span><span class='hs-conop'>:</span><span class='hs-varid'>valstr</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>key</span><span class='hs-layout'>,</span> <span class='hs-varid'>read</span> <span class='hs-varid'>valstr</span><span class='hs-layout'>)</span>
<a name="line-319"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"Data.List.Utils.strToAL: Parse error on value"</span>
<a name="line-320"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"Data.List.Utils.strToAL: Parse error on key"</span>
<a name="line-321"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>map</span> <span class='hs-varid'>worker</span> <span class='hs-layout'>(</span><span class='hs-varid'>lines</span> <span class='hs-varid'>inp</span><span class='hs-layout'>)</span>
<a name="line-322"></a>
<a name="line-323"></a>
<a name="line-324"></a><span class='hs-comment'>{- FIXME TODO: sub -}</span>
<a name="line-325"></a>
<a name="line-326"></a><a name="countElem"></a><span class='hs-comment'>{- | Returns a count of the number of times the given element occured in the
<a name="line-327"></a>given list. -}</span>
<a name="line-328"></a><span class='hs-definition'>countElem</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</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-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span>
<a name="line-329"></a><span class='hs-definition'>countElem</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>length</span> <span class='hs-varop'>.</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>==</span><span class='hs-layout'>)</span>
<a name="line-330"></a>
<a name="line-331"></a><a name="elemRIndex"></a><span class='hs-comment'>{- | Returns the rightmost index of the given element in the
<a name="line-332"></a>given list. -}</span>
<a name="line-333"></a><span class='hs-definition'>elemRIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</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-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-334"></a><span class='hs-definition'>elemRIndex</span> <span class='hs-varid'>item</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span>
<a name="line-335"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>reverse</span> <span class='hs-varop'>$</span> <span class='hs-varid'>elemIndices</span> <span class='hs-varid'>item</span> <span class='hs-varid'>l</span> <span class='hs-keyword'>of</span>
<a name="line-336"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span>
<a name="line-337"></a> <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-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-varid'>x</span>
<a name="line-338"></a><a name="alwaysElemRIndex"></a><span class='hs-comment'>{- | Like elemRIndex, but returns -1 if there is nothing
<a name="line-339"></a>found. -}</span>
<a name="line-340"></a><span class='hs-definition'>alwaysElemRIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</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-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span>
<a name="line-341"></a><span class='hs-definition'>alwaysElemRIndex</span> <span class='hs-varid'>item</span> <span class='hs-varid'>list</span> <span class='hs-keyglyph'>=</span>
<a name="line-342"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>elemRIndex</span> <span class='hs-varid'>item</span> <span class='hs-varid'>list</span> <span class='hs-keyword'>of</span>
<a name="line-343"></a> <span class='hs-conid'>Nothing</span> <span class='hs-keyglyph'>-></span> <span class='hs-comment'>-</span><span class='hs-num'>1</span>
<a name="line-344"></a> <span class='hs-conid'>Just</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>x</span>
<a name="line-345"></a>
<a name="line-346"></a><a name="seqList"></a><span class='hs-comment'>{- | Forces the evaluation of the entire list. -}</span>
<a name="line-347"></a><span class='hs-definition'>seqList</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-348"></a><span class='hs-definition'>seqList</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span>
<a name="line-349"></a><span class='hs-definition'>seqList</span> <span class='hs-varid'>list</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>seq</span> <span class='hs-layout'>(</span><span class='hs-varid'>seqList</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-varid'>list</span>
<a name="line-350"></a>
<a name="line-351"></a><span class='hs-comment'>--------------------------------------------------</span>
<a name="line-352"></a><span class='hs-comment'>-- Advanced Conversions</span>
<a name="line-353"></a><span class='hs-comment'>--------------------------------------------------</span>
<a name="line-354"></a>
<a name="line-355"></a><a name="WholeFunc"></a><span class='hs-comment'>{- | The type used for functions for 'wholeMap'. See 'wholeMap' for details.
<a name="line-356"></a>-}</span>
<a name="line-357"></a><a name="WholeFunc"></a><span class='hs-keyword'>newtype</span> <span class='hs-conid'>WholeFunc</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>WholeFunc</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-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>WholeFunc</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>b</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-358"></a>
<a name="line-359"></a><a name="wholeMap"></a><span class='hs-comment'>{- | This is an enhanced version of the concatMap or map functions in
<a name="line-360"></a>Data.List.
<a name="line-361"></a>
<a name="line-362"></a>Unlike those functions, this one:
<a name="line-363"></a>
<a name="line-364"></a> * Can consume a varying number of elements from the input list during
<a name="line-365"></a> each iteration
<a name="line-366"></a>
<a name="line-367"></a> * Can arbitrarily decide when to stop processing data
<a name="line-368"></a>
<a name="line-369"></a> * Can return a varying number of elements to insert into the output list
<a name="line-370"></a>
<a name="line-371"></a> * Can actually switch processing functions mid-stream
<a name="line-372"></a>
<a name="line-373"></a> * Is not even restricted to processing the input list intact
<a name="line-374"></a>
<a name="line-375"></a>The function used by wholeMap, of type 'WholeFunc', is repeatedly called
<a name="line-376"></a>with the input list. The function returns three things: the function
<a name="line-377"></a>to call for the next iteration (if any), what remains of the input list,
<a name="line-378"></a>and the list of output elements generated during this iteration. The return
<a name="line-379"></a>value of 'wholeMap' is the concatenation of the output element lists from
<a name="line-380"></a>all iterations.
<a name="line-381"></a>
<a name="line-382"></a>Processing stops when the remaining input list is empty. An example
<a name="line-383"></a>of a 'WholeFunc' is 'fixedWidth'. -}</span>
<a name="line-384"></a><span class='hs-definition'>wholeMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>WholeFunc</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>b</span><span class='hs-keyglyph'>]</span>
<a name="line-385"></a><span class='hs-definition'>wholeMap</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <span class='hs-comment'>-- Empty input, empty output.</span>
<a name="line-386"></a><span class='hs-definition'>wholeMap</span> <span class='hs-layout'>(</span><span class='hs-conid'>WholeFunc</span> <span class='hs-varid'>func</span><span class='hs-layout'>)</span> <span class='hs-varid'>inplist</span> <span class='hs-keyglyph'>=</span>
<a name="line-387"></a> <span class='hs-keyword'>let</span> <span class='hs-layout'>(</span><span class='hs-varid'>nextfunc</span><span class='hs-layout'>,</span> <span class='hs-varid'>nextlist</span><span class='hs-layout'>,</span> <span class='hs-varid'>output</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>func</span> <span class='hs-varid'>inplist</span>
<a name="line-388"></a> <span class='hs-keyword'>in</span>
<a name="line-389"></a> <span class='hs-varid'>output</span> <span class='hs-varop'>++</span> <span class='hs-varid'>wholeMap</span> <span class='hs-varid'>nextfunc</span> <span class='hs-varid'>nextlist</span>
<a name="line-390"></a>
<a name="line-391"></a><a name="fixedWidth"></a><span class='hs-comment'>{- | A parser designed to process fixed-width input fields. Use it with
<a name="line-392"></a>'wholeMap'.
<a name="line-393"></a>
<a name="line-394"></a>The Int list passed to this function is the list of the field widths desired
<a name="line-395"></a>from the input. The result is a list of those widths, if possible. If any
<a name="line-396"></a>of the input remains after processing this list, it is added on as the final
<a name="line-397"></a>element in the result list. If the input is less than the sum of the requested
<a name="line-398"></a>widths, then the result list will be short the appropriate number of elements,
<a name="line-399"></a>and its final element may be shorter than requested.
<a name="line-400"></a>
<a name="line-401"></a>Examples:
<a name="line-402"></a>
<a name="line-403"></a>>wholeMap (fixedWidth [1, 2, 3]) "1234567890"
<a name="line-404"></a>> --> ["1","23","456","7890"]
<a name="line-405"></a>>wholeMap (fixedWidth (repeat 2)) "123456789"
<a name="line-406"></a>> --> ["12","34","56","78","9"]
<a name="line-407"></a>>wholeMap (fixedWidth []) "123456789"
<a name="line-408"></a>> --> ["123456789"]
<a name="line-409"></a>>wholeMap (fixedWidth [5, 3, 6, 1]) "Hello, This is a test."
<a name="line-410"></a>> --> ["Hello",", T","his is"," ","a test."]
<a name="line-411"></a>-}</span>
<a name="line-412"></a><span class='hs-definition'>fixedWidth</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Int</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>WholeFunc</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-413"></a><span class='hs-definition'>fixedWidth</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span>
<a name="line-414"></a> <span class='hs-conid'>WholeFunc</span> <span class='hs-layout'>(</span><span class='hs-varid'>fixedWidthFunc</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span>
<a name="line-415"></a> <span class='hs-keyword'>where</span> <span class='hs-comment'>-- Empty input: Empty output, stop</span>
<a name="line-416"></a> <span class='hs-varid'>fixedWidthFunc</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>fixedWidth</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>[]</span><span class='hs-layout'>,</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-417"></a> <span class='hs-comment'>-- Empty length: Stop here.</span>
<a name="line-418"></a> <span class='hs-varid'>fixedWidthFunc</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>fixedWidth</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>[]</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>x</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-419"></a> <span class='hs-comment'>-- Stuff to process: Do it.</span>
<a name="line-420"></a> <span class='hs-varid'>fixedWidthFunc</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-conop'>:</span><span class='hs-varid'>lenxs</span><span class='hs-layout'>)</span> <span class='hs-varid'>input</span> <span class='hs-keyglyph'>=</span>
<a name="line-421"></a> <span class='hs-layout'>(</span><span class='hs-varid'>fixedWidth</span> <span class='hs-varid'>lenxs</span><span class='hs-layout'>,</span> <span class='hs-varid'>next</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>this</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-422"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>this</span><span class='hs-layout'>,</span> <span class='hs-varid'>next</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt</span> <span class='hs-varid'>len</span> <span class='hs-varid'>input</span>
<a name="line-423"></a>
<a name="line-424"></a><span class='hs-comment'>{- | Helps you pick out fixed-width components from a list.
<a name="line-425"></a>
<a name="line-426"></a>Example:
<a name="line-427"></a>
<a name="line-428"></a>>conv :: String -> (String,String)
<a name="line-429"></a>>conv = runState $
<a name="line-430"></a>> do f3 <- grab 3
<a name="line-431"></a>> n2 <- grab 2
<a name="line-432"></a>> return $ f3 ++ "," ++ n2
<a name="line-433"></a>>
<a name="line-434"></a>>main = print $ conv "TestIng"
<a name="line-435"></a>
<a name="line-436"></a>Prints:
<a name="line-437"></a>
<a name="line-438"></a>>("Tes,tI","ng")
<a name="line-439"></a>-}</span>
<a name="line-440"></a>
<a name="line-441"></a><a name="grab"></a><span class='hs-definition'>grab</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>State</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-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-442"></a><span class='hs-definition'>grab</span> <span class='hs-varid'>count</span> <span class='hs-keyglyph'>=</span>
<a name="line-443"></a> <span class='hs-keyword'>do</span> <span class='hs-varid'>g</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>get</span>
<a name="line-444"></a> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>g'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>splitAt</span> <span class='hs-varid'>count</span> <span class='hs-varid'>g</span>
<a name="line-445"></a> <span class='hs-varid'>put</span> <span class='hs-varid'>g'</span>
<a name="line-446"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-447"></a>
<a name="line-448"></a><a name="subIndex"></a><span class='hs-comment'>{- | Similar to Data.List.elemIndex. Instead of looking for one element in a
<a name="line-449"></a>list, this function looks for the first occurance of a sublist in the list,
<a name="line-450"></a>and returns the index of the first element of that occurance. If there is no
<a name="line-451"></a>such list, returns Nothing.
<a name="line-452"></a>
<a name="line-453"></a>If the list to look for is the empty list, will return Just 0 regardless
<a name="line-454"></a>of the content of the list to search.
<a name="line-455"></a>
<a name="line-456"></a>Examples:
<a name="line-457"></a>
<a name="line-458"></a>>subIndex "foo" "asdfoobar" -> Just 3
<a name="line-459"></a>>subIndex "foo" [] -> Nothing
<a name="line-460"></a>>subIndex "" [] -> Just 0
<a name="line-461"></a>>subIndex "" "asdf" -> Just 0
<a name="line-462"></a>>subIndex "test" "asdftestbartest" -> Just 4
<a name="line-463"></a>>subIndex [(1::Int), 2] [0, 5, 3, 2, 1, 2, 4] -> Just 4
<a name="line-464"></a> -}</span>
<a name="line-465"></a><span class='hs-definition'>subIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-466"></a><span class='hs-definition'>subIndex</span> <span class='hs-varid'>substr</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>findIndex</span> <span class='hs-layout'>(</span><span class='hs-varid'>isPrefixOf</span> <span class='hs-varid'>substr</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>tails</span> <span class='hs-varid'>str</span><span class='hs-layout'>)</span>
<a name="line-467"></a>
<a name="line-468"></a><a name="uniq"></a><span class='hs-comment'>{- | Given a list, returns a new list with all duplicate elements removed.
<a name="line-469"></a>For example:
<a name="line-470"></a>
<a name="line-471"></a>>uniq "Mississippi" -> "Misp"
<a name="line-472"></a>
<a name="line-473"></a>You should not rely on this function necessarily preserving order, though
<a name="line-474"></a>the current implementation happens to.
<a name="line-475"></a>
<a name="line-476"></a>This function is not compatible with infinite lists.
<a name="line-477"></a>
<a name="line-478"></a>This is presently an alias for Data.List.nub
<a name="line-479"></a> -}</span>
<a name="line-480"></a><span class='hs-definition'>uniq</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span>
<a name="line-481"></a><span class='hs-definition'>uniq</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>nub</span>
<a name="line-482"></a>
<a name="line-483"></a><span class='hs-comment'>----- same as</span>
<a name="line-484"></a><span class='hs-comment'>--uniq (x:xs) = x : [y | y <- uniq xs, y /= x]</span>
<a name="line-485"></a>
<a name="line-486"></a>
<a name="line-487"></a>
</pre></body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
ec5844e219498f2057da8f8f3070d4a1
>
files
>
273
