<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>Data/Text.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE BangPatterns, CPP, Rank2Types #-}</span> <a name="line-2"></a><span class='hs-comment'>{-# OPTIONS_GHC -fno-warn-orphans #-}</span> <a name="line-3"></a> <a name="line-4"></a><span class='hs-comment'>-- |</span> <a name="line-5"></a><span class='hs-comment'>-- Module : Data.Text</span> <a name="line-6"></a><span class='hs-comment'>-- Copyright : (c) 2008, 2009 Tom Harper,</span> <a name="line-7"></a><span class='hs-comment'>-- (c) 2009, 2010 Bryan O'Sullivan,</span> <a name="line-8"></a><span class='hs-comment'>-- (c) 2009 Duncan Coutts</span> <a name="line-9"></a><span class='hs-comment'>--</span> <a name="line-10"></a><span class='hs-comment'>-- License : BSD-style</span> <a name="line-11"></a><span class='hs-comment'>-- Maintainer : bos@serpentine.com, rtomharper@googlemail.com,</span> <a name="line-12"></a><span class='hs-comment'>-- duncan@haskell.org</span> <a name="line-13"></a><span class='hs-comment'>-- Stability : experimental</span> <a name="line-14"></a><span class='hs-comment'>-- Portability : GHC</span> <a name="line-15"></a><span class='hs-comment'>--</span> <a name="line-16"></a><span class='hs-comment'>-- A time and space-efficient implementation of Unicode text using</span> <a name="line-17"></a><span class='hs-comment'>-- packed Word16 arrays. Suitable for performance critical use, both</span> <a name="line-18"></a><span class='hs-comment'>-- in terms of large data quantities and high speed.</span> <a name="line-19"></a><span class='hs-comment'>--</span> <a name="line-20"></a><span class='hs-comment'>-- This module is intended to be imported @qualified@, to avoid name</span> <a name="line-21"></a><span class='hs-comment'>-- clashes with "Prelude" functions, e.g.</span> <a name="line-22"></a><span class='hs-comment'>--</span> <a name="line-23"></a><span class='hs-comment'>-- > import qualified Data.Text as T</span> <a name="line-24"></a> <a name="line-25"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span> <a name="line-26"></a> <span class='hs-layout'>(</span> <a name="line-27"></a> <span class='hs-comment'>-- * Strict vs lazy types</span> <a name="line-28"></a> <span class='hs-comment'>-- $strict</span> <a name="line-29"></a> <a name="line-30"></a> <span class='hs-comment'>-- * Fusion</span> <a name="line-31"></a> <span class='hs-comment'>-- $fusion</span> <a name="line-32"></a> <a name="line-33"></a> <span class='hs-comment'>-- * Types</span> <a name="line-34"></a> <span class='hs-conid'>Text</span> <a name="line-35"></a> <a name="line-36"></a> <span class='hs-comment'>-- * Creation and elimination</span> <a name="line-37"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>pack</span> <a name="line-38"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unpack</span> <a name="line-39"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>singleton</span> <a name="line-40"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>empty</span> <a name="line-41"></a> <a name="line-42"></a> <span class='hs-comment'>-- * Basic interface</span> <a name="line-43"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>cons</span> <a name="line-44"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>snoc</span> <a name="line-45"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>append</span> <a name="line-46"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>uncons</span> <a name="line-47"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>head</span> <a name="line-48"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>last</span> <a name="line-49"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>tail</span> <a name="line-50"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>init</span> <a name="line-51"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>null</span> <a name="line-52"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>length</span> <a name="line-53"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>compareLength</span> <a name="line-54"></a> <a name="line-55"></a> <span class='hs-comment'>-- * Transformations</span> <a name="line-56"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>map</span> <a name="line-57"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>intercalate</span> <a name="line-58"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>intersperse</span> <a name="line-59"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>transpose</span> <a name="line-60"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>reverse</span> <a name="line-61"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>replace</span> <a name="line-62"></a> <a name="line-63"></a> <span class='hs-comment'>-- ** Case conversion</span> <a name="line-64"></a> <span class='hs-comment'>-- $case</span> <a name="line-65"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>toCaseFold</span> <a name="line-66"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>toLower</span> <a name="line-67"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>toUpper</span> <a name="line-68"></a> <a name="line-69"></a> <span class='hs-comment'>-- ** Justification</span> <a name="line-70"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>justifyLeft</span> <a name="line-71"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>justifyRight</span> <a name="line-72"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>center</span> <a name="line-73"></a> <a name="line-74"></a> <span class='hs-comment'>-- * Folds</span> <a name="line-75"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldl</span> <a name="line-76"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldl'</span> <a name="line-77"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldl1</span> <a name="line-78"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldl1'</span> <a name="line-79"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldr</span> <a name="line-80"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>foldr1</span> <a name="line-81"></a> <a name="line-82"></a> <span class='hs-comment'>-- ** Special folds</span> <a name="line-83"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>concat</span> <a name="line-84"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>concatMap</span> <a name="line-85"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>any</span> <a name="line-86"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>all</span> <a name="line-87"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>maximum</span> <a name="line-88"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>minimum</span> <a name="line-89"></a> <a name="line-90"></a> <span class='hs-comment'>-- * Construction</span> <a name="line-91"></a> <a name="line-92"></a> <span class='hs-comment'>-- ** Scans</span> <a name="line-93"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>scanl</span> <a name="line-94"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>scanl1</span> <a name="line-95"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>scanr</span> <a name="line-96"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>scanr1</span> <a name="line-97"></a> <a name="line-98"></a> <span class='hs-comment'>-- ** Accumulating maps</span> <a name="line-99"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>mapAccumL</span> <a name="line-100"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>mapAccumR</span> <a name="line-101"></a> <a name="line-102"></a> <span class='hs-comment'>-- ** Generation and unfolding</span> <a name="line-103"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>replicate</span> <a name="line-104"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unfoldr</span> <a name="line-105"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unfoldrN</span> <a name="line-106"></a> <a name="line-107"></a> <span class='hs-comment'>-- * Substrings</span> <a name="line-108"></a> <a name="line-109"></a> <span class='hs-comment'>-- ** Breaking strings</span> <a name="line-110"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>take</span> <a name="line-111"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>drop</span> <a name="line-112"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>takeWhile</span> <a name="line-113"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>dropWhile</span> <a name="line-114"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>dropWhileEnd</span> <a name="line-115"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>dropAround</span> <a name="line-116"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>strip</span> <a name="line-117"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stripStart</span> <a name="line-118"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stripEnd</span> <a name="line-119"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>splitAt</span> <a name="line-120"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>spanBy</span> <a name="line-121"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>break</span> <a name="line-122"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>breakEnd</span> <a name="line-123"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>breakBy</span> <a name="line-124"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>group</span> <a name="line-125"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>groupBy</span> <a name="line-126"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>inits</span> <a name="line-127"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>tails</span> <a name="line-128"></a> <a name="line-129"></a> <span class='hs-comment'>-- ** Breaking into many substrings</span> <a name="line-130"></a> <span class='hs-comment'>-- $split</span> <a name="line-131"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>split</span> <a name="line-132"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>splitBy</span> <a name="line-133"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>chunksOf</span> <a name="line-134"></a> <a name="line-135"></a> <span class='hs-comment'>-- ** Breaking into lines and words</span> <a name="line-136"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>lines</span> <a name="line-137"></a> <span class='hs-comment'>--, lines'</span> <a name="line-138"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>words</span> <a name="line-139"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unlines</span> <a name="line-140"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unwords</span> <a name="line-141"></a> <a name="line-142"></a> <span class='hs-comment'>-- * Predicates</span> <a name="line-143"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>isPrefixOf</span> <a name="line-144"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>isSuffixOf</span> <a name="line-145"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>isInfixOf</span> <a name="line-146"></a> <a name="line-147"></a> <span class='hs-comment'>-- ** View patterns</span> <a name="line-148"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stripPrefix</span> <a name="line-149"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stripSuffix</span> <a name="line-150"></a> <a name="line-151"></a> <span class='hs-comment'>-- * Searching</span> <a name="line-152"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>filter</span> <a name="line-153"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>find</span> <a name="line-154"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>findBy</span> <a name="line-155"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>partitionBy</span> <a name="line-156"></a> <a name="line-157"></a> <span class='hs-comment'>-- , findSubstring</span> <a name="line-158"></a> <a name="line-159"></a> <span class='hs-comment'>-- * Indexing</span> <a name="line-160"></a> <span class='hs-comment'>-- $index</span> <a name="line-161"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>index</span> <a name="line-162"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>findIndex</span> <a name="line-163"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>count</span> <a name="line-164"></a> <a name="line-165"></a> <span class='hs-comment'>-- * Zipping and unzipping</span> <a name="line-166"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>zip</span> <a name="line-167"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>zipWith</span> <a name="line-168"></a> <a name="line-169"></a> <span class='hs-comment'>-- -* Ordered text</span> <a name="line-170"></a> <span class='hs-comment'>-- , sort</span> <a name="line-171"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-172"></a> <a name="line-173"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Prelude</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>,</span> <span class='hs-conid'>Bool</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>Functor</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>Int</span><span class='hs-layout'>,</span> <span class='hs-conid'>Maybe</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>String</span><span class='hs-layout'>,</span> <a name="line-174"></a> <span class='hs-conid'>Eq</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>Ord</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>Ordering</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>++</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <a name="line-175"></a> <span class='hs-conid'>Read</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <a name="line-176"></a> <span class='hs-layout'>(</span><span class='hs-varop'>&&</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>||</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>+</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-comment'>-</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>.</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>$</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>$!</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>>></span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>*</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <a name="line-177"></a> <span class='hs-varid'>div</span><span class='hs-layout'>,</span> <span class='hs-varid'>error</span><span class='hs-layout'>,</span> <span class='hs-varid'>not</span><span class='hs-layout'>,</span> <span class='hs-varid'>return</span><span class='hs-layout'>,</span> <span class='hs-varid'>otherwise</span><span class='hs-layout'>)</span> <a name="line-178"></a><span class='hs-cpp'>#if defined(HAVE_DEEPSEQ)</span> <a name="line-179"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>DeepSeq</span> <span class='hs-layout'>(</span><span class='hs-conid'>NFData</span><span class='hs-layout'>)</span> <a name="line-180"></a><span class='hs-cpp'>#endif</span> <a name="line-181"></a><span class='hs-cpp'>#if defined(ASSERTS)</span> <a name="line-182"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <span class='hs-layout'>(</span><span class='hs-varid'>assert</span><span class='hs-layout'>)</span> <a name="line-183"></a><span class='hs-cpp'>#endif</span> <a name="line-184"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Char</span> <span class='hs-layout'>(</span><span class='hs-varid'>isSpace</span><span class='hs-layout'>)</span> <a name="line-185"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Data</span> <span class='hs-layout'>(</span><span class='hs-conid'>Data</span><span class='hs-layout'>(</span><span class='hs-varid'>gfoldl</span><span class='hs-layout'>,</span> <span class='hs-varid'>toConstr</span><span class='hs-layout'>,</span> <span class='hs-varid'>gunfold</span><span class='hs-layout'>,</span> <span class='hs-varid'>dataTypeOf</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-186"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 612</span> <a name="line-187"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Data</span> <span class='hs-layout'>(</span><span class='hs-varid'>mkNoRepType</span><span class='hs-layout'>)</span> <a name="line-188"></a><span class='hs-cpp'>#else</span> <a name="line-189"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Data</span> <span class='hs-layout'>(</span><span class='hs-varid'>mkNorepType</span><span class='hs-layout'>)</span> <a name="line-190"></a><span class='hs-cpp'>#endif</span> <a name="line-191"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span><span class='hs-varid'>foldM</span><span class='hs-layout'>)</span> <a name="line-192"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Array</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>A</span> <a name="line-193"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>L</span> <a name="line-194"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span> <span class='hs-layout'>(</span><span class='hs-conid'>Monoid</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-195"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>String</span> <span class='hs-layout'>(</span><span class='hs-conid'>IsString</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-196"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Fusion</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>S</span> <a name="line-197"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Fusion</span><span class='hs-varop'>.</span><span class='hs-conid'>Common</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>S</span> <a name="line-198"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Fusion</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span><span class='hs-layout'>,</span> <span class='hs-varid'>reverseStream</span><span class='hs-layout'>,</span> <span class='hs-varid'>unstream</span><span class='hs-layout'>)</span> <a name="line-199"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Internal</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</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'>empty</span><span class='hs-layout'>,</span> <span class='hs-varid'>text</span><span class='hs-layout'>,</span> <span class='hs-varid'>textP</span><span class='hs-layout'>)</span> <a name="line-200"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Prelude</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>P</span> <a name="line-201"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Unsafe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Iter</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'>iter</span><span class='hs-layout'>,</span> <span class='hs-varid'>iter_</span><span class='hs-layout'>,</span> <span class='hs-varid'>lengthWord16</span><span class='hs-layout'>,</span> <span class='hs-varid'>reverseIter</span><span class='hs-layout'>,</span> <a name="line-202"></a> <span class='hs-varid'>unsafeHead</span><span class='hs-layout'>,</span> <span class='hs-varid'>unsafeTail</span><span class='hs-layout'>)</span> <a name="line-203"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>UnsafeChar</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeChr</span><span class='hs-layout'>)</span> <a name="line-204"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Util</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>U</span> <a name="line-205"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Encoding</span><span class='hs-varop'>.</span><span class='hs-conid'>Utf16</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>U16</span> <a name="line-206"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Search</span> <span class='hs-layout'>(</span><span class='hs-varid'>indices</span><span class='hs-layout'>)</span> <a name="line-207"></a><span class='hs-cpp'>#if defined(__HADDOCK__)</span> <a name="line-208"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-layout'>(</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-209"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>Lazy</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>L</span> <a name="line-210"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Int</span> <span class='hs-layout'>(</span><span class='hs-conid'>Int64</span><span class='hs-layout'>)</span> <a name="line-211"></a><span class='hs-cpp'>#endif</span> <a name="line-212"></a> <a name="line-213"></a><span class='hs-comment'>-- $strict</span> <a name="line-214"></a><span class='hs-comment'>--</span> <a name="line-215"></a><span class='hs-comment'>-- This package provides both strict and lazy 'Text' types. The</span> <a name="line-216"></a><span class='hs-comment'>-- strict type is provided by the 'Data.Text' package, while the lazy</span> <a name="line-217"></a><span class='hs-comment'>-- type is provided by the 'Data.Text.Lazy' package. Internally, the</span> <a name="line-218"></a><span class='hs-comment'>-- lazy @Text@ type consists of a list of strict chunks.</span> <a name="line-219"></a><span class='hs-comment'>--</span> <a name="line-220"></a><span class='hs-comment'>-- The strict 'Text' type requires that an entire string fit into</span> <a name="line-221"></a><span class='hs-comment'>-- memory at once. The lazy @Text@ type is capable of streaming</span> <a name="line-222"></a><span class='hs-comment'>-- strings that are larger than memory using a small memory footprint.</span> <a name="line-223"></a><span class='hs-comment'>-- In many cases, the overhead of chunked streaming makes the lazy</span> <a name="line-224"></a><span class='hs-comment'>-- @Text@ type slower than its strict counterpart, but this is not</span> <a name="line-225"></a><span class='hs-comment'>-- always the case. Sometimes, the time complexity of a function in</span> <a name="line-226"></a><span class='hs-comment'>-- one module may be different from the other, due to their differing</span> <a name="line-227"></a><span class='hs-comment'>-- internal structures.</span> <a name="line-228"></a><span class='hs-comment'>--</span> <a name="line-229"></a><span class='hs-comment'>-- Each module provides an almost identical API, with the main</span> <a name="line-230"></a><span class='hs-comment'>-- difference being that the strict module uses 'Int' values for</span> <a name="line-231"></a><span class='hs-comment'>-- lengths and counts, while the lazy module uses 'Int64' lengths.</span> <a name="line-232"></a> <a name="line-233"></a><span class='hs-comment'>-- $fusion</span> <a name="line-234"></a><span class='hs-comment'>--</span> <a name="line-235"></a><span class='hs-comment'>-- Most of the functions in this module are subject to /fusion/,</span> <a name="line-236"></a><span class='hs-comment'>-- meaning that a pipeline of such functions will usually allocate at</span> <a name="line-237"></a><span class='hs-comment'>-- most one 'Text' value.</span> <a name="line-238"></a><span class='hs-comment'>--</span> <a name="line-239"></a><span class='hs-comment'>-- As an example, consider the following pipeline:</span> <a name="line-240"></a><span class='hs-comment'>--</span> <a name="line-241"></a><span class='hs-comment'>-- > import Data.Text as T</span> <a name="line-242"></a><span class='hs-comment'>-- > import Data.Text.Encoding as E</span> <a name="line-243"></a><span class='hs-comment'>-- ></span> <a name="line-244"></a><span class='hs-comment'>-- > countChars :: ByteString -> Int</span> <a name="line-245"></a><span class='hs-comment'>-- > countChars = T.length . T.toUpper . E.decodeUtf8</span> <a name="line-246"></a><span class='hs-comment'>--</span> <a name="line-247"></a><span class='hs-comment'>-- From the type signatures involved, this looks like it should</span> <a name="line-248"></a><span class='hs-comment'>-- allocate one 'ByteString' value, and two 'Text' values. However,</span> <a name="line-249"></a><span class='hs-comment'>-- when a module is compiled with optimisation enabled under GHC, the</span> <a name="line-250"></a><span class='hs-comment'>-- two intermediate 'Text' values will be optimised away, and the</span> <a name="line-251"></a><span class='hs-comment'>-- function will be compiled down to a single loop over the source</span> <a name="line-252"></a><span class='hs-comment'>-- 'ByteString'.</span> <a name="line-253"></a><span class='hs-comment'>--</span> <a name="line-254"></a><span class='hs-comment'>-- Functions that can be fused by the compiler are marked with the</span> <a name="line-255"></a><span class='hs-comment'>-- phrase \"Subject to fusion\".</span> <a name="line-256"></a> <a name="line-257"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Eq</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-258"></a> <span class='hs-varid'>t1</span> <span class='hs-varop'>==</span> <span class='hs-varid'>t2</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>stream</span> <span class='hs-varid'>t1</span> <span class='hs-varop'>==</span> <span class='hs-varid'>stream</span> <span class='hs-varid'>t2</span> <a name="line-259"></a> <span class='hs-comment'>{-# INLINE (==) #-}</span> <a name="line-260"></a> <a name="line-261"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Ord</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-262"></a> <span class='hs-varid'>compare</span> <span class='hs-varid'>t1</span> <span class='hs-varid'>t2</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>compare</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t2</span><span class='hs-layout'>)</span> <a name="line-263"></a> <span class='hs-comment'>{-# INLINE compare #-}</span> <a name="line-264"></a> <a name="line-265"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Show</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-266"></a> <span class='hs-varid'>showsPrec</span> <span class='hs-varid'>p</span> <span class='hs-varid'>ps</span> <span class='hs-varid'>r</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>showsPrec</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>unpack</span> <span class='hs-varid'>ps</span><span class='hs-layout'>)</span> <span class='hs-varid'>r</span> <a name="line-267"></a> <a name="line-268"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Read</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-269"></a> <span class='hs-varid'>readsPrec</span> <span class='hs-varid'>p</span> <span class='hs-varid'>str</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-varid'>pack</span> <span class='hs-varid'>x</span><span class='hs-layout'>,</span><span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-layout'>,</span><span class='hs-varid'>y</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>readsPrec</span> <span class='hs-varid'>p</span> <span class='hs-varid'>str</span><span class='hs-keyglyph'>]</span> <a name="line-270"></a> <a name="line-271"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monoid</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-272"></a> <span class='hs-varid'>mempty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-273"></a> <span class='hs-varid'>mappend</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>append</span> <a name="line-274"></a> <span class='hs-varid'>mconcat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <a name="line-275"></a> <a name="line-276"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>IsString</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-277"></a> <span class='hs-varid'>fromString</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>pack</span> <a name="line-278"></a> <a name="line-279"></a><span class='hs-cpp'>#if defined(HAVE_DEEPSEQ)</span> <a name="line-280"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>NFData</span> <span class='hs-conid'>Text</span> <a name="line-281"></a><span class='hs-cpp'>#endif</span> <a name="line-282"></a> <a name="line-283"></a><span class='hs-comment'>-- This instance preserves data abstraction at the cost of inefficiency.</span> <a name="line-284"></a><span class='hs-comment'>-- We omit reflection services for the sake of data abstraction.</span> <a name="line-285"></a><span class='hs-comment'>-- </span> <a name="line-286"></a><span class='hs-comment'>-- This instance was created by copying the behavior of Data.Set and</span> <a name="line-287"></a><span class='hs-comment'>-- Data.Map. If you feel a mistake has been made, please feel free to</span> <a name="line-288"></a><span class='hs-comment'>-- submit improvements.</span> <a name="line-289"></a><span class='hs-comment'>--</span> <a name="line-290"></a><span class='hs-comment'>-- Original discussion is archived here:</span> <a name="line-291"></a> <a name="line-292"></a><span class='hs-comment'>-- "could we get a Data instance for Data.Text.Text?"</span> <a name="line-293"></a><span class='hs-comment'>-- <a href="http://groups.google.com/group/haskell-cafe/browse_thread/thread/b5bbb1b28a7e525d/0639d46852575b93">http://groups.google.com/group/haskell-cafe/browse_thread/thread/b5bbb1b28a7e525d/0639d46852575b93</a></span> <a name="line-294"></a> <a name="line-295"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Data</span> <span class='hs-conid'>Text</span> <span class='hs-keyword'>where</span> <a name="line-296"></a> <span class='hs-varid'>gfoldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>txt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>z</span> <span class='hs-varid'>pack</span> <span class='hs-varop'>`f`</span> <span class='hs-layout'>(</span><span class='hs-varid'>unpack</span> <span class='hs-varid'>txt</span><span class='hs-layout'>)</span> <a name="line-297"></a> <span class='hs-varid'>toConstr</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-str'>"Data.Text.Text.toConstr"</span> <a name="line-298"></a> <span class='hs-varid'>gunfold</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-str'>"Data.Text.Text.gunfold"</span> <a name="line-299"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ >= 612</span> <a name="line-300"></a> <span class='hs-varid'>dataTypeOf</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mkNoRepType</span> <span class='hs-str'>"Data.Text.Text"</span> <a name="line-301"></a><span class='hs-cpp'>#else</span> <a name="line-302"></a> <span class='hs-varid'>dataTypeOf</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mkNorepType</span> <span class='hs-str'>"Data.Text.Text"</span> <a name="line-303"></a><span class='hs-cpp'>#endif</span> <a name="line-304"></a> <a name="line-305"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-306"></a><span class='hs-comment'>-- * Conversion to/from 'Text'</span> <a name="line-307"></a> <a name="line-308"></a><a name="pack"></a><span class='hs-comment'>-- | /O(n)/ Convert a 'String' into a 'Text'. Subject to fusion.</span> <a name="line-309"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-310"></a><span class='hs-definition'>pack</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>streamList</span> <a name="line-311"></a><span class='hs-comment'>{-# INLINE [1] pack #-}</span> <a name="line-312"></a> <a name="line-313"></a><a name="unpack"></a><span class='hs-comment'>-- | /O(n)/ Convert a Text into a String. Subject to fusion.</span> <a name="line-314"></a><span class='hs-definition'>unpack</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>String</span> <a name="line-315"></a><span class='hs-definition'>unpack</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unstreamList</span> <span class='hs-varop'>.</span> <span class='hs-varid'>stream</span> <a name="line-316"></a><span class='hs-comment'>{-# INLINE [1] unpack #-}</span> <a name="line-317"></a> <a name="line-318"></a><a name="singleton"></a><span class='hs-comment'>-- | /O(1)/ Convert a character into a Text.</span> <a name="line-319"></a><span class='hs-comment'>-- Subject to fusion.</span> <a name="line-320"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-321"></a><span class='hs-definition'>singleton</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>singleton</span> <a name="line-322"></a><span class='hs-comment'>{-# INLINE [1] singleton #-}</span> <a name="line-323"></a> <a name="line-324"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-325"></a><span class='hs-comment'>-- * Basic functions</span> <a name="line-326"></a> <a name="line-327"></a><a name="cons"></a><span class='hs-comment'>-- | /O(n)/ Adds a character to the front of a 'Text'. This function</span> <a name="line-328"></a><span class='hs-comment'>-- is more costly than its 'List' counterpart because it requires</span> <a name="line-329"></a><span class='hs-comment'>-- copying a new array. Subject to fusion.</span> <a name="line-330"></a><span class='hs-definition'>cons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-331"></a><span class='hs-definition'>cons</span> <span class='hs-varid'>c</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>cons</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-332"></a><span class='hs-comment'>{-# INLINE cons #-}</span> <a name="line-333"></a> <a name="line-334"></a><a name="snoc"></a><span class='hs-comment'>-- | /O(n)/ Adds a character to the end of a 'Text'. This copies the</span> <a name="line-335"></a><span class='hs-comment'>-- entire array in the process, unless fused. Subject to fusion.</span> <a name="line-336"></a><span class='hs-definition'>snoc</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-337"></a><span class='hs-definition'>snoc</span> <span class='hs-varid'>t</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>snoc</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-338"></a><span class='hs-comment'>{-# INLINE snoc #-}</span> <a name="line-339"></a> <a name="line-340"></a><a name="append"></a><span class='hs-comment'>-- | /O(n)/ Appends one 'Text' to the other by copying both of them</span> <a name="line-341"></a><span class='hs-comment'>-- into a new 'Text'. Subject to fusion.</span> <a name="line-342"></a><span class='hs-definition'>append</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-343"></a><span class='hs-definition'>append</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr1</span> <span class='hs-varid'>off1</span> <span class='hs-varid'>len1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr2</span> <span class='hs-varid'>off2</span> <span class='hs-varid'>len2</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-layout'>(</span><span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>run</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>len</span> <a name="line-344"></a> <span class='hs-keyword'>where</span> <a name="line-345"></a> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>len1</span><span class='hs-varop'>+</span><span class='hs-varid'>len2</span> <a name="line-346"></a> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-347"></a> <span class='hs-varid'>arr</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeNew</span> <span class='hs-varid'>len</span> <a name="line-348"></a> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>copyI</span> <span class='hs-varid'>arr</span> <span class='hs-num'>0</span> <span class='hs-varid'>arr1</span> <span class='hs-varid'>off1</span> <span class='hs-varid'>len1</span> <a name="line-349"></a> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>copyI</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>len1</span> <span class='hs-varid'>arr2</span> <span class='hs-varid'>off2</span> <span class='hs-varid'>len</span> <a name="line-350"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>arr</span> <a name="line-351"></a><span class='hs-comment'>{-# INLINE append #-}</span> <a name="line-352"></a> <a name="line-353"></a><span class='hs-comment'>{-# RULES <a name="line-354"></a>"TEXT append -> fused" [~1] forall t1 t2. <a name="line-355"></a> append t1 t2 = unstream (S.append (stream t1) (stream t2)) <a name="line-356"></a>"TEXT append -> unfused" [1] forall t1 t2. <a name="line-357"></a> unstream (S.append (stream t1) (stream t2)) = append t1 t2 <a name="line-358"></a> #-}</span> <a name="line-359"></a> <a name="line-360"></a><a name="head"></a><span class='hs-comment'>-- | /O(1)/ Returns the first character of a 'Text', which must be</span> <a name="line-361"></a><span class='hs-comment'>-- non-empty. Subject to fusion.</span> <a name="line-362"></a><span class='hs-definition'>head</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-363"></a><span class='hs-definition'>head</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>head</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-364"></a><span class='hs-comment'>{-# INLINE head #-}</span> <a name="line-365"></a> <a name="line-366"></a><a name="uncons"></a><span class='hs-comment'>-- | /O(1)/ Returns the first character and rest of a 'Text', or</span> <a name="line-367"></a><span class='hs-comment'>-- 'Nothing' if empty. Subject to fusion.</span> <a name="line-368"></a><span class='hs-definition'>uncons</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-369"></a><span class='hs-definition'>uncons</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-370"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-371"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-layout'>,</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-372"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-num'>0</span> <a name="line-373"></a><span class='hs-comment'>{-# INLINE [1] uncons #-}</span> <a name="line-374"></a> <a name="line-375"></a><a name="second"></a><span class='hs-comment'>-- | Lifted from Control.Arrow and specialized.</span> <a name="line-376"></a><span class='hs-definition'>second</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'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span><span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span><span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-377"></a><span class='hs-definition'>second</span> <span class='hs-varid'>f</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-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>f</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <a name="line-378"></a> <a name="line-379"></a><span class='hs-comment'>{-# RULES <a name="line-380"></a>"TEXT uncons -> fused" [~1] forall t. <a name="line-381"></a> uncons t = fmap (second unstream) (S.uncons (stream t)) <a name="line-382"></a>"TEXT uncons -> unfused" [1] forall t. <a name="line-383"></a> fmap (second unstream) (S.uncons (stream t)) = uncons t <a name="line-384"></a> #-}</span> <a name="line-385"></a> <a name="line-386"></a><a name="last"></a><span class='hs-comment'>-- | /O(1)/ Returns the last character of a 'Text', which must be</span> <a name="line-387"></a><span class='hs-comment'>-- non-empty. Subject to fusion.</span> <a name="line-388"></a><span class='hs-definition'>last</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-389"></a><span class='hs-definition'>last</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-390"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"last"</span> <a name="line-391"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><</span> <span class='hs-num'>0xDC00</span> <span class='hs-varop'>||</span> <span class='hs-varid'>n</span> <span class='hs-varop'>></span> <span class='hs-num'>0xDFFF</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafeChr</span> <span class='hs-varid'>n</span> <a name="line-392"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>U16</span><span class='hs-varop'>.</span><span class='hs-varid'>chr2</span> <span class='hs-varid'>n0</span> <span class='hs-varid'>n</span> <a name="line-393"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeIndex</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-394"></a> <span class='hs-varid'>n0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeIndex</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>2</span><span class='hs-layout'>)</span> <a name="line-395"></a><span class='hs-comment'>{-# INLINE [1] last #-}</span> <a name="line-396"></a> <a name="line-397"></a><span class='hs-comment'>{-# RULES <a name="line-398"></a>"TEXT last -> fused" [~1] forall t. <a name="line-399"></a> last t = S.last (stream t) <a name="line-400"></a>"TEXT last -> unfused" [1] forall t. <a name="line-401"></a> S.last (stream t) = last t <a name="line-402"></a> #-}</span> <a name="line-403"></a> <a name="line-404"></a><a name="tail"></a><span class='hs-comment'>-- | /O(1)/ Returns all characters after the head of a 'Text', which</span> <a name="line-405"></a><span class='hs-comment'>-- must be non-empty. Subject to fusion.</span> <a name="line-406"></a><span class='hs-definition'>tail</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-407"></a><span class='hs-definition'>tail</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-408"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"tail"</span> <a name="line-409"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-410"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter_</span> <span class='hs-varid'>t</span> <span class='hs-num'>0</span> <a name="line-411"></a><span class='hs-comment'>{-# INLINE [1] tail #-}</span> <a name="line-412"></a> <a name="line-413"></a><span class='hs-comment'>{-# RULES <a name="line-414"></a>"TEXT tail -> fused" [~1] forall t. <a name="line-415"></a> tail t = unstream (S.tail (stream t)) <a name="line-416"></a>"TEXT tail -> unfused" [1] forall t. <a name="line-417"></a> unstream (S.tail (stream t)) = tail t <a name="line-418"></a> #-}</span> <a name="line-419"></a> <a name="line-420"></a><a name="init"></a><span class='hs-comment'>-- | /O(1)/ Returns all but the last character of a 'Text', which must</span> <a name="line-421"></a><span class='hs-comment'>-- be non-empty. Subject to fusion.</span> <a name="line-422"></a><span class='hs-definition'>init</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-423"></a><span class='hs-definition'>init</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"init"</span> <a name="line-424"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-num'>0xDC00</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>n</span> <span class='hs-varop'><=</span> <span class='hs-num'>0xDFFF</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>2</span><span class='hs-layout'>)</span> <a name="line-425"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-426"></a> <span class='hs-keyword'>where</span> <a name="line-427"></a> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeIndex</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-428"></a><span class='hs-comment'>{-# INLINE [1] init #-}</span> <a name="line-429"></a> <a name="line-430"></a><span class='hs-comment'>{-# RULES <a name="line-431"></a>"TEXT init -> fused" [~1] forall t. <a name="line-432"></a> init t = unstream (S.init (stream t)) <a name="line-433"></a>"TEXT init -> unfused" [1] forall t. <a name="line-434"></a> unstream (S.init (stream t)) = init t <a name="line-435"></a> #-}</span> <a name="line-436"></a> <a name="line-437"></a><a name="null"></a><span class='hs-comment'>-- | /O(1)/ Tests whether a 'Text' is empty or not. Subject to</span> <a name="line-438"></a><span class='hs-comment'>-- fusion.</span> <a name="line-439"></a><span class='hs-definition'>null</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-440"></a><span class='hs-definition'>null</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-sel'>_arr</span> <span class='hs-sel'>_off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-441"></a><span class='hs-cpp'>#if defined(ASSERTS)</span> <a name="line-442"></a> <span class='hs-varid'>assert</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span> <span class='hs-varop'>>=</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <a name="line-443"></a><span class='hs-cpp'>#endif</span> <a name="line-444"></a> <span class='hs-varid'>len</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <a name="line-445"></a><span class='hs-comment'>{-# INLINE [1] null #-}</span> <a name="line-446"></a> <a name="line-447"></a><span class='hs-comment'>{-# RULES <a name="line-448"></a>"TEXT null -> fused" [~1] forall t. <a name="line-449"></a> null t = S.null (stream t) <a name="line-450"></a>"TEXT null -> unfused" [1] forall t. <a name="line-451"></a> S.null (stream t) = null t <a name="line-452"></a> #-}</span> <a name="line-453"></a> <a name="line-454"></a><a name="isSingleton"></a><span class='hs-comment'>-- | /O(1)/ Tests whether a 'Text' contains exactly one character.</span> <a name="line-455"></a><span class='hs-comment'>-- Subject to fusion.</span> <a name="line-456"></a><span class='hs-definition'>isSingleton</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-457"></a><span class='hs-definition'>isSingleton</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>isSingleton</span> <span class='hs-varop'>.</span> <span class='hs-varid'>stream</span> <a name="line-458"></a><span class='hs-comment'>{-# INLINE isSingleton #-}</span> <a name="line-459"></a> <a name="line-460"></a><a name="length"></a><span class='hs-comment'>-- | /O(n)/ Returns the number of characters in a 'Text'.</span> <a name="line-461"></a><span class='hs-comment'>-- Subject to fusion.</span> <a name="line-462"></a><span class='hs-definition'>length</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <a name="line-463"></a><span class='hs-definition'>length</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-464"></a><span class='hs-comment'>{-# INLINE length #-}</span> <a name="line-465"></a> <a name="line-466"></a><a name="compareLength"></a><span class='hs-comment'>-- | /O(n)/ Compare the count of characters in a 'Text' to a number.</span> <a name="line-467"></a><span class='hs-comment'>-- Subject to fusion.</span> <a name="line-468"></a><span class='hs-comment'>--</span> <a name="line-469"></a><span class='hs-comment'>-- This function gives the same answer as comparing against the result</span> <a name="line-470"></a><span class='hs-comment'>-- of 'length', but can short circuit if the count of characters is</span> <a name="line-471"></a><span class='hs-comment'>-- greater than the number, and hence be more efficient.</span> <a name="line-472"></a><span class='hs-definition'>compareLength</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Ordering</span> <a name="line-473"></a><span class='hs-definition'>compareLength</span> <span class='hs-varid'>t</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>compareLengthI</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-varid'>n</span> <a name="line-474"></a><span class='hs-comment'>{-# INLINE [1] compareLength #-}</span> <a name="line-475"></a> <a name="line-476"></a><span class='hs-comment'>{-# RULES <a name="line-477"></a>"TEXT compareN/length -> compareLength" [~1] forall t n. <a name="line-478"></a> compare (length t) n = compareLength t n <a name="line-479"></a> #-}</span> <a name="line-480"></a> <a name="line-481"></a><span class='hs-comment'>{-# RULES <a name="line-482"></a>"TEXT ==N/length -> compareLength/==EQ" [~1] forall t n. <a name="line-483"></a> (==) (length t) n = compareLength t n == EQ <a name="line-484"></a> #-}</span> <a name="line-485"></a> <a name="line-486"></a><span class='hs-comment'>{-# RULES <a name="line-487"></a>"TEXT /=N/length -> compareLength//=EQ" [~1] forall t n. <a name="line-488"></a> (/=) (length t) n = compareLength t n /= EQ <a name="line-489"></a> #-}</span> <a name="line-490"></a> <a name="line-491"></a><span class='hs-comment'>{-# RULES <a name="line-492"></a>"TEXT <N/length -> compareLength/==LT" [~1] forall t n. <a name="line-493"></a> (<) (length t) n = compareLength t n == LT <a name="line-494"></a> #-}</span> <a name="line-495"></a> <a name="line-496"></a><span class='hs-comment'>{-# RULES <a name="line-497"></a>"TEXT <=N/length -> compareLength//=GT" [~1] forall t n. <a name="line-498"></a> (<=) (length t) n = compareLength t n /= GT <a name="line-499"></a> #-}</span> <a name="line-500"></a> <a name="line-501"></a><span class='hs-comment'>{-# RULES <a name="line-502"></a>"TEXT >N/length -> compareLength/==GT" [~1] forall t n. <a name="line-503"></a> (>) (length t) n = compareLength t n == GT <a name="line-504"></a> #-}</span> <a name="line-505"></a> <a name="line-506"></a><span class='hs-comment'>{-# RULES <a name="line-507"></a>"TEXT >=N/length -> compareLength//=LT" [~1] forall t n. <a name="line-508"></a> (>=) (length t) n = compareLength t n /= LT <a name="line-509"></a> #-}</span> <a name="line-510"></a> <a name="line-511"></a><a name="map"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-512"></a><span class='hs-comment'>-- * Transformations</span> <a name="line-513"></a><span class='hs-comment'>-- | /O(n)/ 'map' @f@ @t@ is the 'Text' obtained by applying @f@ to</span> <a name="line-514"></a><span class='hs-comment'>-- each element of @t@. Subject to fusion.</span> <a name="line-515"></a><span class='hs-definition'>map</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-516"></a><span class='hs-definition'>map</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-517"></a><span class='hs-comment'>{-# INLINE [1] map #-}</span> <a name="line-518"></a> <a name="line-519"></a><a name="intercalate"></a><span class='hs-comment'>-- | /O(n)/ The 'intercalate' function takes a 'Text' and a list of</span> <a name="line-520"></a><span class='hs-comment'>-- 'Text's and concatenates the list after interspersing the first</span> <a name="line-521"></a><span class='hs-comment'>-- argument between each element of the list.</span> <a name="line-522"></a><span class='hs-definition'>intercalate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-523"></a><span class='hs-definition'>intercalate</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-layout'>(</span><span class='hs-conid'>U</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-524"></a><span class='hs-comment'>{-# INLINE intercalate #-}</span> <a name="line-525"></a> <a name="line-526"></a><a name="intersperse"></a><span class='hs-comment'>-- | /O(n)/ The 'intersperse' function takes a character and places it</span> <a name="line-527"></a><span class='hs-comment'>-- between the characters of a 'Text'. Subject to fusion.</span> <a name="line-528"></a><span class='hs-definition'>intersperse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-529"></a><span class='hs-definition'>intersperse</span> <span class='hs-varid'>c</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>intersperse</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-530"></a><span class='hs-comment'>{-# INLINE intersperse #-}</span> <a name="line-531"></a> <a name="line-532"></a><a name="reverse"></a><span class='hs-comment'>-- | /O(n)/ Reverse the characters of a string. Subject to fusion.</span> <a name="line-533"></a><span class='hs-definition'>reverse</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-534"></a><span class='hs-definition'>reverse</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>reverse</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-535"></a><span class='hs-comment'>{-# INLINE reverse #-}</span> <a name="line-536"></a> <a name="line-537"></a><a name="replace"></a><span class='hs-comment'>-- | /O(m+n)/ Replace every occurrence of one substring with another.</span> <a name="line-538"></a><span class='hs-comment'>--</span> <a name="line-539"></a><span class='hs-comment'>-- In (unlikely) bad cases, this function's time complexity degrades</span> <a name="line-540"></a><span class='hs-comment'>-- towards /O(n*m)/.</span> <a name="line-541"></a><span class='hs-definition'>replace</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Text to search for</span> <a name="line-542"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Replacement text</span> <a name="line-543"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ Input text</span> <a name="line-544"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-545"></a><span class='hs-definition'>replace</span> <span class='hs-varid'>s</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>intercalate</span> <span class='hs-varid'>d</span> <span class='hs-varop'>.</span> <span class='hs-varid'>split</span> <span class='hs-varid'>s</span> <a name="line-546"></a><span class='hs-comment'>{-# INLINE replace #-}</span> <a name="line-547"></a> <a name="line-548"></a><span class='hs-comment'>-- ----------------------------------------------------------------------------</span> <a name="line-549"></a><span class='hs-comment'>-- ** Case conversions (folds)</span> <a name="line-550"></a> <a name="line-551"></a><span class='hs-comment'>-- $case</span> <a name="line-552"></a><span class='hs-comment'>--</span> <a name="line-553"></a><span class='hs-comment'>-- When case converting 'Text' values, do not use combinators like</span> <a name="line-554"></a><span class='hs-comment'>-- @map toUpper@ to case convert each character of a string</span> <a name="line-555"></a><span class='hs-comment'>-- individually, as this gives incorrect results according to the</span> <a name="line-556"></a><span class='hs-comment'>-- rules of some writing systems. The whole-string case conversion</span> <a name="line-557"></a><span class='hs-comment'>-- functions from this module, such as @toUpper@, obey the correct</span> <a name="line-558"></a><span class='hs-comment'>-- case conversion rules. As a result, these functions may map one</span> <a name="line-559"></a><span class='hs-comment'>-- input character to two or three output characters. For examples,</span> <a name="line-560"></a><span class='hs-comment'>-- see the documentation of each function.</span> <a name="line-561"></a><span class='hs-comment'>--</span> <a name="line-562"></a><span class='hs-comment'>-- /Note/: In some languages, case conversion is a locale- and</span> <a name="line-563"></a><span class='hs-comment'>-- context-dependent operation. The case conversion functions in this</span> <a name="line-564"></a><span class='hs-comment'>-- module are /not/ locale sensitive. Programs that require locale</span> <a name="line-565"></a><span class='hs-comment'>-- sensitivity should use appropriate versions of the case mapping</span> <a name="line-566"></a><span class='hs-comment'>-- functions from the @text-icu@ package.</span> <a name="line-567"></a> <a name="line-568"></a><a name="toCaseFold"></a><span class='hs-comment'>-- | /O(n)/ Convert a string to folded case. This function is mainly</span> <a name="line-569"></a><span class='hs-comment'>-- useful for performing caseless (also known as case insensitive)</span> <a name="line-570"></a><span class='hs-comment'>-- string comparisons.</span> <a name="line-571"></a><span class='hs-comment'>--</span> <a name="line-572"></a><span class='hs-comment'>-- A string @x@ is a caseless match for a string @y@ if and only if:</span> <a name="line-573"></a><span class='hs-comment'>--</span> <a name="line-574"></a><span class='hs-comment'>-- @toCaseFold x == toCaseFold y@</span> <a name="line-575"></a><span class='hs-comment'>--</span> <a name="line-576"></a><span class='hs-comment'>-- The result string may be longer than the input string, and may</span> <a name="line-577"></a><span class='hs-comment'>-- differ from applying 'toLower' to the input string. For instance,</span> <a name="line-578"></a><span class='hs-comment'>-- the Armenian small ligature \"&#xfb13;\" (men now, U+FB13) is case</span> <a name="line-579"></a><span class='hs-comment'>-- folded to the sequence \"&#x574;\" (men, U+0574) followed by</span> <a name="line-580"></a><span class='hs-comment'>-- \"&#x576;\" (now, U+0576), while the Greek \"&#xb5;\" (micro sign,</span> <a name="line-581"></a><span class='hs-comment'>-- U+00B5) is case folded to \"&#x3bc;\" (small letter mu, U+03BC)</span> <a name="line-582"></a><span class='hs-comment'>-- instead of itself.</span> <a name="line-583"></a><span class='hs-definition'>toCaseFold</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-584"></a><span class='hs-definition'>toCaseFold</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>toCaseFold</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-585"></a><span class='hs-comment'>{-# INLINE [0] toCaseFold #-}</span> <a name="line-586"></a> <a name="line-587"></a><a name="toLower"></a><span class='hs-comment'>-- | /O(n)/ Convert a string to lower case, using simple case</span> <a name="line-588"></a><span class='hs-comment'>-- conversion. The result string may be longer than the input string.</span> <a name="line-589"></a><span class='hs-comment'>-- For instance, \"&#x130;\" (Latin capital letter I with dot above,</span> <a name="line-590"></a><span class='hs-comment'>-- U+0130) maps to the sequence \"i\" (Latin small letter i, U+0069) followed</span> <a name="line-591"></a><span class='hs-comment'>-- by \" &#x307;\" (combining dot above, U+0307).</span> <a name="line-592"></a><span class='hs-definition'>toLower</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-593"></a><span class='hs-definition'>toLower</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>toLower</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-594"></a><span class='hs-comment'>{-# INLINE toLower #-}</span> <a name="line-595"></a> <a name="line-596"></a><a name="toUpper"></a><span class='hs-comment'>-- | /O(n)/ Convert a string to upper case, using simple case</span> <a name="line-597"></a><span class='hs-comment'>-- conversion. The result string may be longer than the input string.</span> <a name="line-598"></a><span class='hs-comment'>-- For instance, the German \"&#xdf;\" (eszett, U+00DF) maps to the</span> <a name="line-599"></a><span class='hs-comment'>-- two-letter sequence \"SS\".</span> <a name="line-600"></a><span class='hs-definition'>toUpper</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-601"></a><span class='hs-definition'>toUpper</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>toUpper</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-602"></a><span class='hs-comment'>{-# INLINE toUpper #-}</span> <a name="line-603"></a> <a name="line-604"></a><a name="justifyLeft"></a><span class='hs-comment'>-- | /O(n)/ Left-justify a string to the given length, using the</span> <a name="line-605"></a><span class='hs-comment'>-- specified fill character on the right. Subject to fusion. Examples:</span> <a name="line-606"></a><span class='hs-comment'>--</span> <a name="line-607"></a><span class='hs-comment'>-- > justifyLeft 7 'x' "foo" == "fooxxxx"</span> <a name="line-608"></a><span class='hs-comment'>-- > justifyLeft 3 'x' "foobar" == "foobar"</span> <a name="line-609"></a><span class='hs-definition'>justifyLeft</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-610"></a><span class='hs-definition'>justifyLeft</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c</span> <span class='hs-varid'>t</span> <a name="line-611"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-612"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <span class='hs-varop'>`append`</span> <span class='hs-varid'>replicateChar</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span><span class='hs-comment'>-</span><span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <a name="line-613"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>length</span> <span class='hs-varid'>t</span> <a name="line-614"></a><span class='hs-comment'>{-# INLINE [1] justifyLeft #-}</span> <a name="line-615"></a> <a name="line-616"></a><span class='hs-comment'>{-# RULES <a name="line-617"></a>"TEXT justifyLeft -> fused" [~1] forall k c t. <a name="line-618"></a> justifyLeft k c t = unstream (S.justifyLeftI k c (stream t)) <a name="line-619"></a>"TEXT justifyLeft -> unfused" [1] forall k c t. <a name="line-620"></a> unstream (S.justifyLeftI k c (stream t)) = justifyLeft k c t <a name="line-621"></a> #-}</span> <a name="line-622"></a> <a name="line-623"></a><a name="justifyRight"></a><span class='hs-comment'>-- | /O(n)/ Right-justify a string to the given length, using the</span> <a name="line-624"></a><span class='hs-comment'>-- specified fill character on the left. Examples:</span> <a name="line-625"></a><span class='hs-comment'>--</span> <a name="line-626"></a><span class='hs-comment'>-- > justifyRight 7 'x' "bar" == "xxxxbar"</span> <a name="line-627"></a><span class='hs-comment'>-- > justifyRight 3 'x' "foobar" == "foobar"</span> <a name="line-628"></a><span class='hs-definition'>justifyRight</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-629"></a><span class='hs-definition'>justifyRight</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c</span> <span class='hs-varid'>t</span> <a name="line-630"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-631"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>replicateChar</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span><span class='hs-comment'>-</span><span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-varid'>c</span> <span class='hs-varop'>`append`</span> <span class='hs-varid'>t</span> <a name="line-632"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>length</span> <span class='hs-varid'>t</span> <a name="line-633"></a><span class='hs-comment'>{-# INLINE justifyRight #-}</span> <a name="line-634"></a> <a name="line-635"></a><a name="center"></a><span class='hs-comment'>-- | /O(n)/ Center a string to the given length, using the</span> <a name="line-636"></a><span class='hs-comment'>-- specified fill character on either side. Examples:</span> <a name="line-637"></a><span class='hs-comment'>--</span> <a name="line-638"></a><span class='hs-comment'>-- > center 8 'x' "HS" = "xxxHSxxx"</span> <a name="line-639"></a><span class='hs-definition'>center</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-640"></a><span class='hs-definition'>center</span> <span class='hs-varid'>k</span> <span class='hs-varid'>c</span> <span class='hs-varid'>t</span> <a name="line-641"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>len</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-642"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>replicateChar</span> <span class='hs-varid'>l</span> <span class='hs-varid'>c</span> <span class='hs-varop'>`append`</span> <span class='hs-varid'>t</span> <span class='hs-varop'>`append`</span> <span class='hs-varid'>replicateChar</span> <span class='hs-varid'>r</span> <span class='hs-varid'>c</span> <a name="line-643"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>length</span> <span class='hs-varid'>t</span> <a name="line-644"></a> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>k</span> <span class='hs-comment'>-</span> <span class='hs-varid'>len</span> <a name="line-645"></a> <span class='hs-varid'>r</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>d</span> <span class='hs-varop'>`div`</span> <span class='hs-num'>2</span> <a name="line-646"></a> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>d</span> <span class='hs-comment'>-</span> <span class='hs-varid'>r</span> <a name="line-647"></a><span class='hs-comment'>{-# INLINE center #-}</span> <a name="line-648"></a> <a name="line-649"></a><a name="transpose"></a><span class='hs-comment'>-- | /O(n)/ The 'transpose' function transposes the rows and columns</span> <a name="line-650"></a><span class='hs-comment'>-- of its 'Text' argument. Note that this function uses 'pack',</span> <a name="line-651"></a><span class='hs-comment'>-- 'unpack', and the list version of transpose, and is thus not very</span> <a name="line-652"></a><span class='hs-comment'>-- efficient.</span> <a name="line-653"></a><span class='hs-definition'>transpose</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-654"></a><span class='hs-definition'>transpose</span> <span class='hs-varid'>ts</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>pack</span> <span class='hs-layout'>(</span><span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>transpose</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>unpack</span> <span class='hs-varid'>ts</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-655"></a> <a name="line-656"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-657"></a><span class='hs-comment'>-- * Reducing 'Text's (folds)</span> <a name="line-658"></a> <a name="line-659"></a><a name="foldl"></a><span class='hs-comment'>-- | /O(n)/ 'foldl', applied to a binary operator, a starting value</span> <a name="line-660"></a><span class='hs-comment'>-- (typically the left-identity of the operator), and a 'Text',</span> <a name="line-661"></a><span class='hs-comment'>-- reduces the 'Text' using the binary operator, from left to right.</span> <a name="line-662"></a><span class='hs-comment'>-- Subject to fusion.</span> <a name="line-663"></a><span class='hs-definition'>foldl</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-664"></a><span class='hs-definition'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-665"></a><span class='hs-comment'>{-# INLINE foldl #-}</span> <a name="line-666"></a> <a name="line-667"></a><a name="foldl'"></a><span class='hs-comment'>-- | /O(n)/ A strict version of 'foldl'. Subject to fusion.</span> <a name="line-668"></a><span class='hs-definition'>foldl'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-669"></a><span class='hs-definition'>foldl'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-670"></a><span class='hs-comment'>{-# INLINE foldl' #-}</span> <a name="line-671"></a> <a name="line-672"></a><a name="foldl1"></a><span class='hs-comment'>-- | /O(n)/ A variant of 'foldl' that has no starting value argument,</span> <a name="line-673"></a><span class='hs-comment'>-- and thus must be applied to a non-empty 'Text'. Subject to fusion.</span> <a name="line-674"></a><span class='hs-definition'>foldl1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-675"></a><span class='hs-definition'>foldl1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl1</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-676"></a><span class='hs-comment'>{-# INLINE foldl1 #-}</span> <a name="line-677"></a> <a name="line-678"></a><a name="foldl1'"></a><span class='hs-comment'>-- | /O(n)/ A strict version of 'foldl1'. Subject to fusion.</span> <a name="line-679"></a><span class='hs-definition'>foldl1'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-680"></a><span class='hs-definition'>foldl1'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldl1'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-681"></a><span class='hs-comment'>{-# INLINE foldl1' #-}</span> <a name="line-682"></a> <a name="line-683"></a><a name="foldr"></a><span class='hs-comment'>-- | /O(n)/ 'foldr', applied to a binary operator, a starting value</span> <a name="line-684"></a><span class='hs-comment'>-- (typically the right-identity of the operator), and a 'Text',</span> <a name="line-685"></a><span class='hs-comment'>-- reduces the 'Text' using the binary operator, from right to left.</span> <a name="line-686"></a><span class='hs-comment'>-- Subject to fusion.</span> <a name="line-687"></a><span class='hs-definition'>foldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-688"></a><span class='hs-definition'>foldr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-689"></a><span class='hs-comment'>{-# INLINE foldr #-}</span> <a name="line-690"></a> <a name="line-691"></a><a name="foldr1"></a><span class='hs-comment'>-- | /O(n)/ A variant of 'foldr' that has no starting value argument,</span> <a name="line-692"></a><span class='hs-comment'>-- and thust must be applied to a non-empty 'Text'. Subject to</span> <a name="line-693"></a><span class='hs-comment'>-- fusion.</span> <a name="line-694"></a><span class='hs-definition'>foldr1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-695"></a><span class='hs-definition'>foldr1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>foldr1</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-696"></a><span class='hs-comment'>{-# INLINE foldr1 #-}</span> <a name="line-697"></a> <a name="line-698"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-699"></a><span class='hs-comment'>-- ** Special folds</span> <a name="line-700"></a> <a name="line-701"></a><a name="concat"></a><span class='hs-comment'>-- | /O(n)/ Concatenate a list of 'Text's.</span> <a name="line-702"></a><span class='hs-definition'>concat</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-703"></a><span class='hs-definition'>concat</span> <span class='hs-varid'>ts</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>ts'</span> <span class='hs-keyword'>of</span> <a name="line-704"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>empty</span> <a name="line-705"></a> <span class='hs-keyglyph'>[</span><span class='hs-varid'>t</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>t</span> <a name="line-706"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-layout'>(</span><span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>run</span> <span class='hs-varid'>go</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>len</span> <a name="line-707"></a> <span class='hs-keyword'>where</span> <a name="line-708"></a> <span class='hs-varid'>ts'</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>null</span><span class='hs-layout'>)</span> <span class='hs-varid'>ts</span> <a name="line-709"></a> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>sum</span> <span class='hs-varop'>$</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>lengthWord16</span> <span class='hs-varid'>ts'</span> <a name="line-710"></a> <span class='hs-varid'>go</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-711"></a> <span class='hs-varid'>arr</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeNew</span> <span class='hs-varid'>len</span> <a name="line-712"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>step</span> <span class='hs-varid'>i</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>a</span> <span class='hs-varid'>o</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-713"></a> <span class='hs-keyword'>let</span> <span class='hs-varop'>!</span><span class='hs-varid'>j</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span> <span class='hs-varop'>+</span> <span class='hs-varid'>l</span> <span class='hs-keyword'>in</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>copyI</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>i</span> <span class='hs-varid'>a</span> <span class='hs-varid'>o</span> <span class='hs-varid'>j</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-varid'>j</span> <a name="line-714"></a> <span class='hs-varid'>foldM</span> <span class='hs-varid'>step</span> <span class='hs-num'>0</span> <span class='hs-varid'>ts'</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-varid'>arr</span> <a name="line-715"></a> <a name="line-716"></a><a name="concatMap"></a><span class='hs-comment'>-- | /O(n)/ Map a function over a 'Text' that results in a 'Text', and</span> <a name="line-717"></a><span class='hs-comment'>-- concatenate the results.</span> <a name="line-718"></a><span class='hs-definition'>concatMap</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-719"></a><span class='hs-definition'>concatMap</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-varid'>foldr</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conop'>:</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-conid'>[]</span> <a name="line-720"></a><span class='hs-comment'>{-# INLINE concatMap #-}</span> <a name="line-721"></a> <a name="line-722"></a><a name="any"></a><span class='hs-comment'>-- | /O(n)/ 'any' @p@ @t@ determines whether any character in the</span> <a name="line-723"></a><span class='hs-comment'>-- 'Text' @t@ satisifes the predicate @p@. Subject to fusion.</span> <a name="line-724"></a><span class='hs-definition'>any</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-725"></a><span class='hs-definition'>any</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>any</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-726"></a><span class='hs-comment'>{-# INLINE any #-}</span> <a name="line-727"></a> <a name="line-728"></a><a name="all"></a><span class='hs-comment'>-- | /O(n)/ 'all' @p@ @t@ determines whether all characters in the</span> <a name="line-729"></a><span class='hs-comment'>-- 'Text' @t@ satisify the predicate @p@. Subject to fusion.</span> <a name="line-730"></a><span class='hs-definition'>all</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-731"></a><span class='hs-definition'>all</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>all</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-732"></a><span class='hs-comment'>{-# INLINE all #-}</span> <a name="line-733"></a> <a name="line-734"></a><a name="maximum"></a><span class='hs-comment'>-- | /O(n)/ 'maximum' returns the maximum value from a 'Text', which</span> <a name="line-735"></a><span class='hs-comment'>-- must be non-empty. Subject to fusion.</span> <a name="line-736"></a><span class='hs-definition'>maximum</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-737"></a><span class='hs-definition'>maximum</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>maximum</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-738"></a><span class='hs-comment'>{-# INLINE maximum #-}</span> <a name="line-739"></a> <a name="line-740"></a><a name="minimum"></a><span class='hs-comment'>-- | /O(n)/ 'minimum' returns the minimum value from a 'Text', which</span> <a name="line-741"></a><span class='hs-comment'>-- must be non-empty. Subject to fusion.</span> <a name="line-742"></a><span class='hs-definition'>minimum</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-743"></a><span class='hs-definition'>minimum</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>minimum</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-744"></a><span class='hs-comment'>{-# INLINE minimum #-}</span> <a name="line-745"></a> <a name="line-746"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-747"></a><span class='hs-comment'>-- * Building 'Text's</span> <a name="line-748"></a> <a name="line-749"></a><a name="scanl"></a><span class='hs-comment'>-- | /O(n)/ 'scanl' is similar to 'foldl', but returns a list of</span> <a name="line-750"></a><span class='hs-comment'>-- successive reduced values from the left. Subject to fusion.</span> <a name="line-751"></a><span class='hs-comment'>--</span> <a name="line-752"></a><span class='hs-comment'>-- > scanl f z [x1, x2, ...] == [z, z `f` x1, (z `f` x1) `f` x2, ...]</span> <a name="line-753"></a><span class='hs-comment'>--</span> <a name="line-754"></a><span class='hs-comment'>-- Note that</span> <a name="line-755"></a><span class='hs-comment'>--</span> <a name="line-756"></a><span class='hs-comment'>-- > last (scanl f z xs) == foldl f z xs.</span> <a name="line-757"></a><span class='hs-definition'>scanl</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-758"></a><span class='hs-definition'>scanl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>scanl</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-759"></a><span class='hs-comment'>{-# INLINE scanl #-}</span> <a name="line-760"></a> <a name="line-761"></a><a name="scanl1"></a><span class='hs-comment'>-- | /O(n)/ 'scanl1' is a variant of 'scanl' that has no starting</span> <a name="line-762"></a><span class='hs-comment'>-- value argument. Subject to fusion.</span> <a name="line-763"></a><span class='hs-comment'>--</span> <a name="line-764"></a><span class='hs-comment'>-- > scanl1 f [x1, x2, ...] == [x1, x1 `f` x2, ...]</span> <a name="line-765"></a><span class='hs-definition'>scanl1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-766"></a><span class='hs-definition'>scanl1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-767"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>scanl</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-768"></a><span class='hs-comment'>{-# INLINE scanl1 #-}</span> <a name="line-769"></a> <a name="line-770"></a><a name="scanr"></a><span class='hs-comment'>-- | /O(n)/ 'scanr' is the right-to-left dual of 'scanl'.</span> <a name="line-771"></a><span class='hs-comment'>--</span> <a name="line-772"></a><span class='hs-comment'>-- > scanr f v == reverse . scanl (flip f) v . reverse</span> <a name="line-773"></a><span class='hs-definition'>scanr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-774"></a><span class='hs-definition'>scanr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>reverse</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>reverseScanr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z</span> <span class='hs-varop'>.</span> <span class='hs-varid'>reverseStream</span> <a name="line-775"></a><span class='hs-comment'>{-# INLINE scanr #-}</span> <a name="line-776"></a> <a name="line-777"></a><a name="scanr1"></a><span class='hs-comment'>-- | /O(n)/ 'scanr1' is a variant of 'scanr' that has no starting</span> <a name="line-778"></a><span class='hs-comment'>-- value argument. Subject to fusion.</span> <a name="line-779"></a><span class='hs-definition'>scanr1</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-780"></a><span class='hs-definition'>scanr1</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-781"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>scanr</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>last</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>init</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-782"></a><span class='hs-comment'>{-# INLINE scanr1 #-}</span> <a name="line-783"></a> <a name="line-784"></a><a name="mapAccumL"></a><span class='hs-comment'>-- | /O(n)/ Like a combination of 'map' and 'foldl''. Applies a</span> <a name="line-785"></a><span class='hs-comment'>-- function to each element of a 'Text', passing an accumulating</span> <a name="line-786"></a><span class='hs-comment'>-- parameter from left to right, and returns a final 'Text'.</span> <a name="line-787"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span><span class='hs-conid'>Char</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</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-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-788"></a><span class='hs-definition'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z0</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z0</span> <span class='hs-varop'>.</span> <span class='hs-varid'>stream</span> <a name="line-789"></a><span class='hs-comment'>{-# INLINE mapAccumL #-}</span> <a name="line-790"></a> <a name="line-791"></a><a name="mapAccumR"></a><span class='hs-comment'>-- | The 'mapAccumR' function behaves like a combination of 'map' and</span> <a name="line-792"></a><span class='hs-comment'>-- a strict 'foldr'; it applies a function to each element of a</span> <a name="line-793"></a><span class='hs-comment'>-- 'Text', passing an accumulating parameter from right to left, and</span> <a name="line-794"></a><span class='hs-comment'>-- returning a final value of this accumulator together with the new</span> <a name="line-795"></a><span class='hs-comment'>-- 'Text'.</span> <a name="line-796"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span><span class='hs-conid'>Char</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</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-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-797"></a><span class='hs-definition'>mapAccumR</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>second</span> <span class='hs-varid'>reverse</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>mapAccumL</span> <span class='hs-varid'>f</span> <span class='hs-varid'>z0</span> <span class='hs-varop'>.</span> <span class='hs-varid'>reverseStream</span> <a name="line-798"></a><span class='hs-comment'>{-# INLINE mapAccumR #-}</span> <a name="line-799"></a> <a name="line-800"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-801"></a><span class='hs-comment'>-- ** Generating and unfolding 'Text's</span> <a name="line-802"></a> <a name="line-803"></a><a name="replicate"></a><span class='hs-comment'>-- | /O(n*m)/ 'replicate' @n@ @t@ is a 'Text' consisting of the input</span> <a name="line-804"></a><span class='hs-comment'>-- @t@ repeated @n@ times.</span> <a name="line-805"></a><span class='hs-definition'>replicate</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-806"></a><span class='hs-definition'>replicate</span> <span class='hs-varid'>n</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>a</span> <span class='hs-varid'>o</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <a name="line-807"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-varop'>||</span> <span class='hs-varid'>l</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-808"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>==</span> <span class='hs-num'>1</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-809"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>isSingleton</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>replicateChar</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-810"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-layout'>(</span><span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>run</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-num'>0</span> <span class='hs-varid'>len</span> <a name="line-811"></a> <span class='hs-keyword'>where</span> <a name="line-812"></a> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>l</span> <span class='hs-varop'>*</span> <span class='hs-varid'>n</span> <a name="line-813"></a> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-814"></a> <span class='hs-varid'>arr</span> <span class='hs-keyglyph'><-</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>unsafeNew</span> <span class='hs-varid'>len</span> <a name="line-815"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>d</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>arr</span> <a name="line-816"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>d</span> <span class='hs-varop'>+</span> <span class='hs-varid'>l</span> <a name="line-817"></a> <span class='hs-keyword'>in</span> <span class='hs-conid'>A</span><span class='hs-varop'>.</span><span class='hs-varid'>copyI</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>d</span> <span class='hs-varid'>a</span> <span class='hs-varid'>o</span> <span class='hs-varid'>m</span> <span class='hs-varop'>>></span> <span class='hs-varid'>loop</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-818"></a> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <a name="line-819"></a><span class='hs-comment'>{-# INLINE [1] replicate #-}</span> <a name="line-820"></a> <a name="line-821"></a><span class='hs-comment'>{-# RULES <a name="line-822"></a>"TEXT replicate/singleton -> replicateChar" [~1] forall n c. <a name="line-823"></a> replicate n (singleton c) = replicateChar n c <a name="line-824"></a> #-}</span> <a name="line-825"></a> <a name="line-826"></a><a name="replicateChar"></a><span class='hs-comment'>-- | /O(n)/ 'replicateChar' @n@ @c@ is a 'Text' of length @n@ with @c@ the</span> <a name="line-827"></a><span class='hs-comment'>-- value of every element. Subject to fusion.</span> <a name="line-828"></a><span class='hs-definition'>replicateChar</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-829"></a><span class='hs-definition'>replicateChar</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>replicateCharI</span> <span class='hs-varid'>n</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <a name="line-830"></a><span class='hs-comment'>{-# INLINE replicateChar #-}</span> <a name="line-831"></a> <a name="line-832"></a><a name="unfoldr"></a><span class='hs-comment'>-- | /O(n)/, where @n@ is the length of the result. The 'unfoldr'</span> <a name="line-833"></a><span class='hs-comment'>-- function is analogous to the List 'L.unfoldr'. 'unfoldr' builds a</span> <a name="line-834"></a><span class='hs-comment'>-- 'Text' from a seed value. The function takes the element and</span> <a name="line-835"></a><span class='hs-comment'>-- returns 'Nothing' if it is done producing the 'Text', otherwise</span> <a name="line-836"></a><span class='hs-comment'>-- 'Just' @(a,b)@. In this case, @a@ is the next 'Char' in the</span> <a name="line-837"></a><span class='hs-comment'>-- string, and @b@ is the seed value for further production. Subject</span> <a name="line-838"></a><span class='hs-comment'>-- to fusion.</span> <a name="line-839"></a><span class='hs-definition'>unfoldr</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>,</span><span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-840"></a><span class='hs-definition'>unfoldr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unfoldr</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-841"></a><span class='hs-comment'>{-# INLINE unfoldr #-}</span> <a name="line-842"></a> <a name="line-843"></a><a name="unfoldrN"></a><span class='hs-comment'>-- | /O(n)/ Like 'unfoldr', 'unfoldrN' builds a 'Text' from a seed</span> <a name="line-844"></a><span class='hs-comment'>-- value. However, the length of the result should be limited by the</span> <a name="line-845"></a><span class='hs-comment'>-- first argument to 'unfoldrN'. This function is more efficient than</span> <a name="line-846"></a><span class='hs-comment'>-- 'unfoldr' when the maximum length of the result is known and</span> <a name="line-847"></a><span class='hs-comment'>-- correct, otherwise its performance is similar to 'unfoldr'. Subject</span> <a name="line-848"></a><span class='hs-comment'>-- to fusion.</span> <a name="line-849"></a><span class='hs-definition'>unfoldrN</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>,</span><span class='hs-varid'>a</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-850"></a><span class='hs-definition'>unfoldrN</span> <span class='hs-varid'>n</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unfoldrN</span> <span class='hs-varid'>n</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-851"></a><span class='hs-comment'>{-# INLINE unfoldrN #-}</span> <a name="line-852"></a> <a name="line-853"></a><span class='hs-comment'>-- -----------------------------------------------------------------------------</span> <a name="line-854"></a><span class='hs-comment'>-- * Substrings</span> <a name="line-855"></a> <a name="line-856"></a><a name="take"></a><span class='hs-comment'>-- | /O(n)/ 'take' @n@, applied to a 'Text', returns the prefix of the</span> <a name="line-857"></a><span class='hs-comment'>-- 'Text' of length @n@, or the 'Text' itself if @n@ is greater than</span> <a name="line-858"></a><span class='hs-comment'>-- the length of the Text. Subject to fusion.</span> <a name="line-859"></a><span class='hs-definition'>take</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-860"></a><span class='hs-definition'>take</span> <span class='hs-varid'>n</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-861"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-862"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-863"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-layout'>(</span><span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <a name="line-864"></a> <span class='hs-keyword'>where</span> <a name="line-865"></a> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-varop'>!</span><span class='hs-varid'>cnt</span> <a name="line-866"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>||</span> <span class='hs-varid'>cnt</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span> <a name="line-867"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>cnt</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-868"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter_</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-869"></a><span class='hs-comment'>{-# INLINE [1] take #-}</span> <a name="line-870"></a> <a name="line-871"></a><span class='hs-comment'>{-# RULES <a name="line-872"></a>"TEXT take -> fused" [~1] forall n t. <a name="line-873"></a> take n t = unstream (S.take n (stream t)) <a name="line-874"></a>"TEXT take -> unfused" [1] forall n t. <a name="line-875"></a> unstream (S.take n (stream t)) = take n t <a name="line-876"></a> #-}</span> <a name="line-877"></a> <a name="line-878"></a><a name="drop"></a><span class='hs-comment'>-- | /O(n)/ 'drop' @n@, applied to a 'Text', returns the suffix of the</span> <a name="line-879"></a><span class='hs-comment'>-- 'Text' after the first @n@ characters, or the empty 'Text' if @n@</span> <a name="line-880"></a><span class='hs-comment'>-- is greater than the length of the 'Text'. Subject to fusion.</span> <a name="line-881"></a><span class='hs-definition'>drop</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-882"></a><span class='hs-definition'>drop</span> <span class='hs-varid'>n</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-883"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-884"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-885"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <a name="line-886"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-varop'>!</span><span class='hs-varid'>cnt</span> <a name="line-887"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>||</span> <span class='hs-varid'>cnt</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-888"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>cnt</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-889"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter_</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-890"></a><span class='hs-comment'>{-# INLINE [1] drop #-}</span> <a name="line-891"></a> <a name="line-892"></a><span class='hs-comment'>{-# RULES <a name="line-893"></a>"TEXT drop -> fused" [~1] forall n t. <a name="line-894"></a> drop n t = unstream (S.drop n (stream t)) <a name="line-895"></a>"TEXT drop -> unfused" [1] forall n t. <a name="line-896"></a> unstream (S.drop n (stream t)) = drop n t <a name="line-897"></a> #-}</span> <a name="line-898"></a> <a name="line-899"></a><a name="takeWhile"></a><span class='hs-comment'>-- | /O(n)/ 'takeWhile', applied to a predicate @p@ and a 'Text',</span> <a name="line-900"></a><span class='hs-comment'>-- returns the longest prefix (possibly empty) of elements that</span> <a name="line-901"></a><span class='hs-comment'>-- satisfy @p@. Subject to fusion.</span> <a name="line-902"></a><span class='hs-definition'>takeWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-903"></a><span class='hs-definition'>takeWhile</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <a name="line-904"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <a name="line-905"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-906"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>i</span> <a name="line-907"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-908"></a><span class='hs-comment'>{-# INLINE [1] takeWhile #-}</span> <a name="line-909"></a> <a name="line-910"></a><span class='hs-comment'>{-# RULES <a name="line-911"></a>"TEXT takeWhile -> fused" [~1] forall p t. <a name="line-912"></a> takeWhile p t = unstream (S.takeWhile p (stream t)) <a name="line-913"></a>"TEXT takeWhile -> unfused" [1] forall p t. <a name="line-914"></a> unstream (S.takeWhile p (stream t)) = takeWhile p t <a name="line-915"></a> #-}</span> <a name="line-916"></a> <a name="line-917"></a><a name="dropWhile"></a><span class='hs-comment'>-- | /O(n)/ 'dropWhile' @p@ @t@ returns the suffix remaining after</span> <a name="line-918"></a><span class='hs-comment'>-- 'takeWhile' @p@ @t@. Subject to fusion.</span> <a name="line-919"></a><span class='hs-definition'>dropWhile</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-920"></a><span class='hs-definition'>dropWhile</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <a name="line-921"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-varop'>!</span><span class='hs-varid'>l</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-922"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-923"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>i</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span> <a name="line-924"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-925"></a><span class='hs-comment'>{-# INLINE [1] dropWhile #-}</span> <a name="line-926"></a> <a name="line-927"></a><span class='hs-comment'>{-# RULES <a name="line-928"></a>"TEXT dropWhile -> fused" [~1] forall p t. <a name="line-929"></a> dropWhile p t = unstream (S.dropWhile p (stream t)) <a name="line-930"></a>"TEXT dropWhile -> unfused" [1] forall p t. <a name="line-931"></a> unstream (S.dropWhile p (stream t)) = dropWhile p t <a name="line-932"></a> #-}</span> <a name="line-933"></a> <a name="line-934"></a><a name="dropWhileEnd"></a><span class='hs-comment'>-- | /O(n)/ 'dropWhileEnd' @p@ @t@ returns the prefix remaining after</span> <a name="line-935"></a><span class='hs-comment'>-- dropping characters that fail the predicate @p@ from the end of</span> <a name="line-936"></a><span class='hs-comment'>-- @t@. Subject to fusion.</span> <a name="line-937"></a><span class='hs-comment'>-- Examples:</span> <a name="line-938"></a><span class='hs-comment'>--</span> <a name="line-939"></a><span class='hs-comment'>-- > dropWhileEnd (=='.') "foo..." == "foo"</span> <a name="line-940"></a><span class='hs-definition'>dropWhileEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-941"></a><span class='hs-definition'>dropWhileEnd</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varid'>len</span> <a name="line-942"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-varop'>!</span><span class='hs-varid'>l</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>empty</span> <a name="line-943"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-944"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>l</span> <a name="line-945"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span><span class='hs-layout'>,</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>reverseIter</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-946"></a><span class='hs-comment'>{-# INLINE [1] dropWhileEnd #-}</span> <a name="line-947"></a> <a name="line-948"></a><span class='hs-comment'>{-# RULES <a name="line-949"></a>"TEXT dropWhileEnd -> fused" [~1] forall p t. <a name="line-950"></a> dropWhileEnd p t = S.reverse (S.dropWhile p (S.reverseStream t)) <a name="line-951"></a>"TEXT dropWhileEnd -> unfused" [1] forall p t. <a name="line-952"></a> S.reverse (S.dropWhile p (S.reverseStream t)) = dropWhileEnd p t <a name="line-953"></a> #-}</span> <a name="line-954"></a> <a name="line-955"></a><a name="dropAround"></a><span class='hs-comment'>-- | /O(n)/ 'dropAround' @p@ @t@ returns the substring remaining after</span> <a name="line-956"></a><span class='hs-comment'>-- dropping characters that fail the predicate @p@ from both the</span> <a name="line-957"></a><span class='hs-comment'>-- beginning and end of @t@. Subject to fusion.</span> <a name="line-958"></a><span class='hs-definition'>dropAround</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-959"></a><span class='hs-definition'>dropAround</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropWhile</span> <span class='hs-varid'>p</span> <span class='hs-varop'>.</span> <span class='hs-varid'>dropWhileEnd</span> <span class='hs-varid'>p</span> <a name="line-960"></a><span class='hs-comment'>{-# INLINE [1] dropAround #-}</span> <a name="line-961"></a> <a name="line-962"></a><a name="stripStart"></a><span class='hs-comment'>-- | /O(n)/ Remove leading white space from a string. Equivalent to:</span> <a name="line-963"></a><span class='hs-comment'>--</span> <a name="line-964"></a><span class='hs-comment'>-- > dropWhile isSpace</span> <a name="line-965"></a><span class='hs-definition'>stripStart</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-966"></a><span class='hs-definition'>stripStart</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropWhile</span> <span class='hs-varid'>isSpace</span> <a name="line-967"></a><span class='hs-comment'>{-# INLINE [1] stripStart #-}</span> <a name="line-968"></a> <a name="line-969"></a><a name="stripEnd"></a><span class='hs-comment'>-- | /O(n)/ Remove trailing white space from a string. Equivalent to:</span> <a name="line-970"></a><span class='hs-comment'>--</span> <a name="line-971"></a><span class='hs-comment'>-- > dropWhileEnd isSpace</span> <a name="line-972"></a><span class='hs-definition'>stripEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-973"></a><span class='hs-definition'>stripEnd</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropWhileEnd</span> <span class='hs-varid'>isSpace</span> <a name="line-974"></a><span class='hs-comment'>{-# INLINE [1] stripEnd #-}</span> <a name="line-975"></a> <a name="line-976"></a><a name="strip"></a><span class='hs-comment'>-- | /O(n)/ Remove leading and trailing white space from a string.</span> <a name="line-977"></a><span class='hs-comment'>-- Equivalent to:</span> <a name="line-978"></a><span class='hs-comment'>--</span> <a name="line-979"></a><span class='hs-comment'>-- > dropAround isSpace</span> <a name="line-980"></a><span class='hs-definition'>strip</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-981"></a><span class='hs-definition'>strip</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>dropAround</span> <span class='hs-varid'>isSpace</span> <a name="line-982"></a><span class='hs-comment'>{-# INLINE [1] strip #-}</span> <a name="line-983"></a> <a name="line-984"></a><a name="splitAt"></a><span class='hs-comment'>-- | /O(n)/ 'splitAt' @n t@ returns a pair whose first element is a</span> <a name="line-985"></a><span class='hs-comment'>-- prefix of @t@ of length @n@, and whose second is the remainder of</span> <a name="line-986"></a><span class='hs-comment'>-- the string. It is equivalent to @('take' n t, 'drop' n t)@.</span> <a name="line-987"></a><span class='hs-definition'>splitAt</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-988"></a><span class='hs-definition'>splitAt</span> <span class='hs-varid'>n</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-989"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>empty</span><span class='hs-layout'>,</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-990"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span><span class='hs-layout'>,</span> <span class='hs-varid'>empty</span><span class='hs-layout'>)</span> <a name="line-991"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>k</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>k</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-992"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <a name="line-993"></a> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-varop'>!</span><span class='hs-varid'>cnt</span> <a name="line-994"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>||</span> <span class='hs-varid'>cnt</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span> <a name="line-995"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>cnt</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-996"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter_</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-997"></a><span class='hs-comment'>{-# INLINE splitAt #-}</span> <a name="line-998"></a> <a name="line-999"></a><a name="spanBy"></a><span class='hs-comment'>-- | /O(n)/ 'spanBy', applied to a predicate @p@ and text @t@, returns</span> <a name="line-1000"></a><span class='hs-comment'>-- a pair whose first element is the longest prefix (possibly empty)</span> <a name="line-1001"></a><span class='hs-comment'>-- of @t@ of elements that satisfy @p@, and whose second is the</span> <a name="line-1002"></a><span class='hs-comment'>-- remainder of the list.</span> <a name="line-1003"></a><span class='hs-definition'>spanBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-1004"></a><span class='hs-definition'>spanBy</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>k</span><span class='hs-layout'>,</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>k</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>k</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1005"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <a name="line-1006"></a> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>||</span> <span class='hs-varid'>not</span> <span class='hs-layout'>(</span><span class='hs-varid'>p</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span> <a name="line-1007"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-1008"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-1009"></a><span class='hs-comment'>{-# INLINE spanBy #-}</span> <a name="line-1010"></a> <a name="line-1011"></a><a name="breakBy"></a><span class='hs-comment'>-- | /O(n)/ 'breakBy' is like 'spanBy', but the prefix returned is</span> <a name="line-1012"></a><span class='hs-comment'>-- over elements that fail the predicate @p@.</span> <a name="line-1013"></a><span class='hs-definition'>breakBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-1014"></a><span class='hs-definition'>breakBy</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>spanBy</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-1015"></a><span class='hs-comment'>{-# INLINE breakBy #-}</span> <a name="line-1016"></a> <a name="line-1017"></a><a name="groupBy"></a><span class='hs-comment'>-- | /O(n)/ Group characters in a string according to a predicate.</span> <a name="line-1018"></a><span class='hs-definition'>groupBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1019"></a><span class='hs-definition'>groupBy</span> <span class='hs-varid'>p</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <a name="line-1020"></a> <span class='hs-keyword'>where</span> <a name="line-1021"></a> <span class='hs-varid'>loop</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-1022"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1023"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>n</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>n</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1024"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-num'>0</span> <a name="line-1025"></a> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>d</span> <span class='hs-varop'>+</span> <span class='hs-varid'>findAIndexOrEnd</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-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1026"></a> <a name="line-1027"></a><a name="findAIndexOrEnd"></a><span class='hs-comment'>-- | Returns the /array/ index (in units of 'Word16') at which a</span> <a name="line-1028"></a><span class='hs-comment'>-- character may be found. This is /not/ the same as the logical</span> <a name="line-1029"></a><span class='hs-comment'>-- index returned by e.g. 'findIndex'.</span> <a name="line-1030"></a><span class='hs-definition'>findAIndexOrEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <a name="line-1031"></a><span class='hs-definition'>findAIndexOrEnd</span> <span class='hs-varid'>q</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-sel'>_arr</span> <span class='hs-sel'>_off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-num'>0</span> <a name="line-1032"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>go</span> <span class='hs-varop'>!</span><span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-varop'>||</span> <span class='hs-varid'>q</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>i</span> <a name="line-1033"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-1034"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span> <a name="line-1035"></a> <a name="line-1036"></a><a name="group"></a><span class='hs-comment'>-- | /O(n)/ Group characters in a string by equality.</span> <a name="line-1037"></a><span class='hs-definition'>group</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1038"></a><span class='hs-definition'>group</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>groupBy</span> <span class='hs-layout'>(</span><span class='hs-varop'>==</span><span class='hs-layout'>)</span> <a name="line-1039"></a> <a name="line-1040"></a><a name="inits"></a><span class='hs-comment'>-- | /O(n)/ Return all initial segments of the given 'Text', shortest</span> <a name="line-1041"></a><span class='hs-comment'>-- first.</span> <a name="line-1042"></a><span class='hs-definition'>inits</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1043"></a><span class='hs-definition'>inits</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <a name="line-1044"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>i</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>t</span><span class='hs-keyglyph'>]</span> <a name="line-1045"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>i</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span> <span class='hs-varop'>+</span> <span class='hs-varid'>iter_</span> <span class='hs-varid'>t</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span> <a name="line-1046"></a> <a name="line-1047"></a><a name="tails"></a><span class='hs-comment'>-- | /O(n)/ Return all final segments of the given 'Text', longest</span> <a name="line-1048"></a><span class='hs-comment'>-- first.</span> <a name="line-1049"></a><span class='hs-definition'>tails</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1050"></a><span class='hs-definition'>tails</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>empty</span><span class='hs-keyglyph'>]</span> <a name="line-1051"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <span class='hs-conop'>:</span> <span class='hs-varid'>tails</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-1052"></a> <a name="line-1053"></a><span class='hs-comment'>-- $split</span> <a name="line-1054"></a><span class='hs-comment'>--</span> <a name="line-1055"></a><span class='hs-comment'>-- Splitting functions in this library do not perform character-wise</span> <a name="line-1056"></a><span class='hs-comment'>-- copies to create substrings; they just construct new 'Text's that</span> <a name="line-1057"></a><span class='hs-comment'>-- are slices of the original.</span> <a name="line-1058"></a> <a name="line-1059"></a><a name="split"></a><span class='hs-comment'>-- | /O(m+n)/ Break a 'Text' into pieces separated by the first</span> <a name="line-1060"></a><span class='hs-comment'>-- 'Text' argument, consuming the delimiter. An empty delimiter is</span> <a name="line-1061"></a><span class='hs-comment'>-- invalid, and will cause an error to be raised.</span> <a name="line-1062"></a><span class='hs-comment'>--</span> <a name="line-1063"></a><span class='hs-comment'>-- Examples:</span> <a name="line-1064"></a><span class='hs-comment'>--</span> <a name="line-1065"></a><span class='hs-comment'>-- > split "\r\n" "a\r\nb\r\nd\r\ne" == ["a","b","d","e"]</span> <a name="line-1066"></a><span class='hs-comment'>-- > split "aaa" "aaaXaaaXaaaXaaa" == ["","X","X","X",""]</span> <a name="line-1067"></a><span class='hs-comment'>-- > split "x" "x" == ["",""]</span> <a name="line-1068"></a><span class='hs-comment'>-- </span> <a name="line-1069"></a><span class='hs-comment'>-- and</span> <a name="line-1070"></a><span class='hs-comment'>--</span> <a name="line-1071"></a><span class='hs-comment'>-- > intercalate s . split s == id</span> <a name="line-1072"></a><span class='hs-comment'>-- > split (singleton c) == splitBy (==c)</span> <a name="line-1073"></a><span class='hs-comment'>--</span> <a name="line-1074"></a><span class='hs-comment'>-- In (unlikely) bad cases, this function's time complexity degrades</span> <a name="line-1075"></a><span class='hs-comment'>-- towards /O(n*m)/.</span> <a name="line-1076"></a><span class='hs-definition'>split</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1077"></a><span class='hs-definition'>split</span> <span class='hs-varid'>pat</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>src</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-1078"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>l</span> <span class='hs-varop'><=</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"split"</span> <a name="line-1079"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>isSingleton</span> <span class='hs-varid'>pat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitBy</span> <span class='hs-layout'>(</span><span class='hs-varop'>==</span> <span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>pat</span><span class='hs-layout'>)</span> <span class='hs-varid'>src</span> <a name="line-1080"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <span class='hs-num'>0</span> <span class='hs-layout'>(</span><span class='hs-varid'>indices</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span><span class='hs-layout'>)</span> <a name="line-1081"></a> <span class='hs-keyword'>where</span> <a name="line-1082"></a> <span class='hs-varid'>go</span> <span class='hs-varop'>!</span><span class='hs-varid'>s</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'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-comment'>-</span><span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>go</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-varop'>+</span><span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span> <a name="line-1083"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>s</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span><span class='hs-varop'>+</span><span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>s</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-1084"></a><span class='hs-comment'>{-# INLINE [1] split #-}</span> <a name="line-1085"></a> <a name="line-1086"></a><span class='hs-comment'>{-# RULES <a name="line-1087"></a>"TEXT split/singleton -> splitBy/==" [~1] forall c t. <a name="line-1088"></a> split (singleton c) t = splitBy (==c) t <a name="line-1089"></a> #-}</span> <a name="line-1090"></a> <a name="line-1091"></a><a name="splitBy"></a><span class='hs-comment'>-- | /O(n)/ Splits a 'Text' into components delimited by separators,</span> <a name="line-1092"></a><span class='hs-comment'>-- where the predicate returns True for a separator element. The</span> <a name="line-1093"></a><span class='hs-comment'>-- resulting components do not contain the separators. Two adjacent</span> <a name="line-1094"></a><span class='hs-comment'>-- separators result in an empty component in the output. eg.</span> <a name="line-1095"></a><span class='hs-comment'>--</span> <a name="line-1096"></a><span class='hs-comment'>-- > splitBy (=='a') "aabbaca" == ["","","bb","c",""]</span> <a name="line-1097"></a><span class='hs-comment'>-- > splitBy (=='a') "" == [""]</span> <a name="line-1098"></a><span class='hs-definition'>splitBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1099"></a><span class='hs-definition'>splitBy</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-sel'>_off</span> <span class='hs-sel'>_arr</span> <span class='hs-num'>0</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>t</span><span class='hs-keyglyph'>]</span> <a name="line-1100"></a><span class='hs-definition'>splitBy</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>t</span> <a name="line-1101"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>s'</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>l</span><span class='hs-keyglyph'>]</span> <a name="line-1102"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>l</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>s'</span><span class='hs-layout'>)</span> <a name="line-1103"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>l</span><span class='hs-layout'>,</span> <span class='hs-varid'>s'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>breakBy</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span> <a name="line-1104"></a><span class='hs-comment'>{-# INLINE splitBy #-}</span> <a name="line-1105"></a> <a name="line-1106"></a><a name="chunksOf"></a><span class='hs-comment'>-- | /O(n)/ Splits a 'Text' into components of length @k@. The last</span> <a name="line-1107"></a><span class='hs-comment'>-- element may be shorter than the other chunks, depending on the</span> <a name="line-1108"></a><span class='hs-comment'>-- length of the input. Examples:</span> <a name="line-1109"></a><span class='hs-comment'>--</span> <a name="line-1110"></a><span class='hs-comment'>-- > chunksOf 3 "foobarbaz" == ["foo","bar","baz"]</span> <a name="line-1111"></a><span class='hs-comment'>-- > chunksOf 4 "haskell.org" == ["hask","ell.","org"]</span> <a name="line-1112"></a><span class='hs-definition'>chunksOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1113"></a><span class='hs-definition'>chunksOf</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>go</span> <a name="line-1114"></a> <span class='hs-keyword'>where</span> <a name="line-1115"></a> <span class='hs-varid'>go</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>splitAt</span> <span class='hs-varid'>k</span> <span class='hs-varid'>t</span> <span class='hs-keyword'>of</span> <a name="line-1116"></a> <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-varid'>null</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>[]</span> <a name="line-1117"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <span class='hs-conop'>:</span> <span class='hs-varid'>go</span> <span class='hs-varid'>b</span> <a name="line-1118"></a><span class='hs-comment'>{-# INLINE chunksOf #-}</span> <a name="line-1119"></a> <a name="line-1120"></a><span class='hs-comment'>-- ----------------------------------------------------------------------------</span> <a name="line-1121"></a><span class='hs-comment'>-- * Searching</span> <a name="line-1122"></a> <a name="line-1123"></a><span class='hs-comment'>-------------------------------------------------------------------------------</span> <a name="line-1124"></a><span class='hs-comment'>-- ** Searching with a predicate</span> <a name="line-1125"></a> <a name="line-1126"></a><a name="findBy"></a><span class='hs-comment'>-- | /O(n)/ The 'findBy' function takes a predicate and a 'Text', and</span> <a name="line-1127"></a><span class='hs-comment'>-- returns the first element in matching the predicate, or 'Nothing'</span> <a name="line-1128"></a><span class='hs-comment'>-- if there is no such element.</span> <a name="line-1129"></a><span class='hs-definition'>findBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Char</span> <a name="line-1130"></a><span class='hs-definition'>findBy</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>findBy</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-1131"></a><span class='hs-comment'>{-# INLINE findBy #-}</span> <a name="line-1132"></a> <a name="line-1133"></a><a name="partitionBy"></a><span class='hs-comment'>-- | /O(n)/ The 'partitionBy' function takes a predicate and a 'Text',</span> <a name="line-1134"></a><span class='hs-comment'>-- and returns the pair of 'Text's with elements which do and do not</span> <a name="line-1135"></a><span class='hs-comment'>-- satisfy the predicate, respectively; i.e.</span> <a name="line-1136"></a><span class='hs-comment'>--</span> <a name="line-1137"></a><span class='hs-comment'>-- > partitionBy p t == (filter p t, filter (not . p) t)</span> <a name="line-1138"></a><span class='hs-definition'>partitionBy</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-1139"></a><span class='hs-definition'>partitionBy</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>filter</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span><span class='hs-layout'>,</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-1140"></a><span class='hs-comment'>{-# INLINE partitionBy #-}</span> <a name="line-1141"></a> <a name="line-1142"></a><a name="filter"></a><span class='hs-comment'>-- | /O(n)/ 'filter', applied to a predicate and a 'Text',</span> <a name="line-1143"></a><span class='hs-comment'>-- returns a 'Text' containing those characters that satisfy the</span> <a name="line-1144"></a><span class='hs-comment'>-- predicate.</span> <a name="line-1145"></a><span class='hs-definition'>filter</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-1146"></a><span class='hs-definition'>filter</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>filter</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1147"></a><span class='hs-comment'>{-# INLINE filter #-}</span> <a name="line-1148"></a> <a name="line-1149"></a><a name="break"></a><span class='hs-comment'>-- | /O(n+m)/ Find the first instance of @needle@ (which must be</span> <a name="line-1150"></a><span class='hs-comment'>-- non-'null') in @haystack@. The first element of the returned tuple</span> <a name="line-1151"></a><span class='hs-comment'>-- is the prefix of @haystack@ before @needle@ is matched. The second</span> <a name="line-1152"></a><span class='hs-comment'>-- is the remainder of @haystack@, starting with the match.</span> <a name="line-1153"></a><span class='hs-comment'>--</span> <a name="line-1154"></a><span class='hs-comment'>-- Examples:</span> <a name="line-1155"></a><span class='hs-comment'>--</span> <a name="line-1156"></a><span class='hs-comment'>-- > break "::" "a::b::c" ==> ("a", "::b::c")</span> <a name="line-1157"></a><span class='hs-comment'>-- > break "/" "foobar" ==> ("foobar", "")</span> <a name="line-1158"></a><span class='hs-comment'>--</span> <a name="line-1159"></a><span class='hs-comment'>-- Laws:</span> <a name="line-1160"></a><span class='hs-comment'>--</span> <a name="line-1161"></a><span class='hs-comment'>-- > append prefix match == haystack</span> <a name="line-1162"></a><span class='hs-comment'>-- > where (prefix, match) = break needle haystack</span> <a name="line-1163"></a><span class='hs-comment'>--</span> <a name="line-1164"></a><span class='hs-comment'>-- If you need to break a string by a substring repeatedly (e.g. you</span> <a name="line-1165"></a><span class='hs-comment'>-- want to break on every instance of a substring), use 'find'</span> <a name="line-1166"></a><span class='hs-comment'>-- instead, as it has lower startup overhead.</span> <a name="line-1167"></a><span class='hs-comment'>--</span> <a name="line-1168"></a><span class='hs-comment'>-- In (unlikely) bad cases, this function's time complexity degrades</span> <a name="line-1169"></a><span class='hs-comment'>-- towards /O(n*m)/.</span> <a name="line-1170"></a><span class='hs-definition'>break</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-1171"></a><span class='hs-definition'>break</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-1172"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>pat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"break"</span> <a name="line-1173"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>indices</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span> <span class='hs-keyword'>of</span> <a name="line-1174"></a> <span class='hs-conid'>[]</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>src</span><span class='hs-layout'>,</span> <span class='hs-varid'>empty</span><span class='hs-layout'>)</span> <a name="line-1175"></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-layout'>(</span><span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>x</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1176"></a><span class='hs-comment'>{-# INLINE break #-}</span> <a name="line-1177"></a> <a name="line-1178"></a><a name="breakEnd"></a><span class='hs-comment'>-- | /O(n+m)/ Similar to 'break', but searches from the end of the string.</span> <a name="line-1179"></a><span class='hs-comment'>--</span> <a name="line-1180"></a><span class='hs-comment'>-- The first element of the returned tuple is the prefix of @haystack@</span> <a name="line-1181"></a><span class='hs-comment'>-- up to and including the last match of @needle@. The second is the</span> <a name="line-1182"></a><span class='hs-comment'>-- remainder of @haystack@, following the match.</span> <a name="line-1183"></a><span class='hs-comment'>--</span> <a name="line-1184"></a><span class='hs-comment'>-- > breakEnd "::" "a::b::c" ==> ("a::b::", "c")</span> <a name="line-1185"></a><span class='hs-definition'>breakEnd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span> <a name="line-1186"></a><span class='hs-definition'>breakEnd</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</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-varid'>break</span> <span class='hs-layout'>(</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>pat</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>src</span><span class='hs-layout'>)</span> <a name="line-1187"></a> <span class='hs-keyword'>in</span> <span class='hs-layout'>(</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>b</span><span class='hs-layout'>,</span> <span class='hs-varid'>reverse</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-1188"></a><span class='hs-comment'>{-# INLINE breakEnd #-}</span> <a name="line-1189"></a> <a name="line-1190"></a><a name="find"></a><span class='hs-comment'>-- | /O(n+m)/ Find all non-overlapping instances of @needle@ in</span> <a name="line-1191"></a><span class='hs-comment'>-- @haystack@. Each element of the returned list consists of a pair:</span> <a name="line-1192"></a><span class='hs-comment'>--</span> <a name="line-1193"></a><span class='hs-comment'>-- * The entire string prior to the /k/th match (i.e. the prefix)</span> <a name="line-1194"></a><span class='hs-comment'>--</span> <a name="line-1195"></a><span class='hs-comment'>-- * The /k/th match, followed by the remainder of the string</span> <a name="line-1196"></a><span class='hs-comment'>--</span> <a name="line-1197"></a><span class='hs-comment'>-- Examples:</span> <a name="line-1198"></a><span class='hs-comment'>--</span> <a name="line-1199"></a><span class='hs-comment'>-- > find "::" ""</span> <a name="line-1200"></a><span class='hs-comment'>-- > ==> []</span> <a name="line-1201"></a><span class='hs-comment'>-- > find "/" "a/b/c/"</span> <a name="line-1202"></a><span class='hs-comment'>-- > ==> [("a", "/b/c/"), ("a/b", "/c/"), ("a/b/c", "/")]</span> <a name="line-1203"></a><span class='hs-comment'>--</span> <a name="line-1204"></a><span class='hs-comment'>-- In (unlikely) bad cases, this function's time complexity degrades</span> <a name="line-1205"></a><span class='hs-comment'>-- towards /O(n*m)/.</span> <a name="line-1206"></a><span class='hs-comment'>--</span> <a name="line-1207"></a><span class='hs-comment'>-- The @needle@ parameter may not be empty.</span> <a name="line-1208"></a><span class='hs-definition'>find</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ @needle@ to search for</span> <a name="line-1209"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-comment'>-- ^ @haystack@ in which to search</span> <a name="line-1210"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span><span class='hs-layout'>,</span> <span class='hs-conid'>Text</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-1211"></a><span class='hs-definition'>find</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>slen</span><span class='hs-layout'>)</span> <a name="line-1212"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>pat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"find"</span> <a name="line-1213"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-varid'>step</span> <span class='hs-layout'>(</span><span class='hs-varid'>indices</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span><span class='hs-layout'>)</span> <a name="line-1214"></a> <span class='hs-keyword'>where</span> <a name="line-1215"></a> <span class='hs-varid'>step</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>chunk</span> <span class='hs-num'>0</span> <span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>chunk</span> <span class='hs-varid'>x</span> <span class='hs-layout'>(</span><span class='hs-varid'>slen</span><span class='hs-comment'>-</span><span class='hs-varid'>x</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1216"></a> <span class='hs-varid'>chunk</span> <span class='hs-varop'>!</span><span class='hs-varid'>n</span> <span class='hs-varop'>!</span><span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-varid'>l</span> <a name="line-1217"></a><span class='hs-comment'>{-# INLINE find #-}</span> <a name="line-1218"></a> <a name="line-1219"></a><span class='hs-comment'>-------------------------------------------------------------------------------</span> <a name="line-1220"></a><span class='hs-comment'>-- ** Indexing 'Text's</span> <a name="line-1221"></a> <a name="line-1222"></a><span class='hs-comment'>-- $index</span> <a name="line-1223"></a><span class='hs-comment'>--</span> <a name="line-1224"></a><span class='hs-comment'>-- If you think of a 'Text' value as an array of 'Char' values (which</span> <a name="line-1225"></a><span class='hs-comment'>-- it is not), you run the risk of writing inefficient code.</span> <a name="line-1226"></a><span class='hs-comment'>--</span> <a name="line-1227"></a><span class='hs-comment'>-- An idiom that is common in some languages is to find the numeric</span> <a name="line-1228"></a><span class='hs-comment'>-- offset of a character or substring, then use that number to split</span> <a name="line-1229"></a><span class='hs-comment'>-- or trim the searched string. With a 'Text' value, this approach</span> <a name="line-1230"></a><span class='hs-comment'>-- would require two /O(n)/ operations: one to perform the search, and</span> <a name="line-1231"></a><span class='hs-comment'>-- one to operate from wherever the search ended.</span> <a name="line-1232"></a><span class='hs-comment'>--</span> <a name="line-1233"></a><span class='hs-comment'>-- For example, suppose you have a string that you want to split on</span> <a name="line-1234"></a><span class='hs-comment'>-- the substring @\"::\"@, such as @\"foo::bar::quux\"@. Instead of</span> <a name="line-1235"></a><span class='hs-comment'>-- searching for the index of @\"::\"@ and taking the substrings</span> <a name="line-1236"></a><span class='hs-comment'>-- before and after that index, you would instead use @find \"::\"@.</span> <a name="line-1237"></a> <a name="line-1238"></a><a name="index"></a><span class='hs-comment'>-- | /O(n)/ 'Text' index (subscript) operator, starting from 0.</span> <a name="line-1239"></a><span class='hs-definition'>index</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <a name="line-1240"></a><span class='hs-definition'>index</span> <span class='hs-varid'>t</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>index</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-varid'>n</span> <a name="line-1241"></a><span class='hs-comment'>{-# INLINE index #-}</span> <a name="line-1242"></a> <a name="line-1243"></a><a name="findIndex"></a><span class='hs-comment'>-- | /O(n)/ The 'findIndex' function takes a predicate and a 'Text'</span> <a name="line-1244"></a><span class='hs-comment'>-- and returns the index of the first element in the 'Text' satisfying</span> <a name="line-1245"></a><span class='hs-comment'>-- the predicate. Subject to fusion.</span> <a name="line-1246"></a><span class='hs-definition'>findIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span> <a name="line-1247"></a><span class='hs-definition'>findIndex</span> <span class='hs-varid'>p</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>findIndex</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-1248"></a><span class='hs-comment'>{-# INLINE findIndex #-}</span> <a name="line-1249"></a> <a name="line-1250"></a><a name="count"></a><span class='hs-comment'>-- | /O(n+m)/ The 'count' function returns the number of times the</span> <a name="line-1251"></a><span class='hs-comment'>-- query string appears in the given 'Text'. An empty query string is</span> <a name="line-1252"></a><span class='hs-comment'>-- invalid, and will cause an error to be raised.</span> <a name="line-1253"></a><span class='hs-comment'>--</span> <a name="line-1254"></a><span class='hs-comment'>-- In (unlikely) bad cases, this function's time complexity degrades</span> <a name="line-1255"></a><span class='hs-comment'>-- towards /O(n*m)/.</span> <a name="line-1256"></a><span class='hs-definition'>count</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <a name="line-1257"></a><span class='hs-definition'>count</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span> <a name="line-1258"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>pat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>emptyError</span> <span class='hs-str'>"count"</span> <a name="line-1259"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>isSingleton</span> <span class='hs-varid'>pat</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>countChar</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>pat</span><span class='hs-layout'>)</span> <span class='hs-varid'>src</span> <a name="line-1260"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>length</span> <span class='hs-layout'>(</span><span class='hs-varid'>indices</span> <span class='hs-varid'>pat</span> <span class='hs-varid'>src</span><span class='hs-layout'>)</span> <a name="line-1261"></a><span class='hs-comment'>{-# INLINE [1] count #-}</span> <a name="line-1262"></a> <a name="line-1263"></a><span class='hs-comment'>{-# RULES <a name="line-1264"></a>"TEXT count/singleton -> countChar" [~1] forall c t. <a name="line-1265"></a> count (singleton c) t = countChar c t <a name="line-1266"></a> #-}</span> <a name="line-1267"></a> <a name="line-1268"></a><a name="countChar"></a><span class='hs-comment'>-- | /O(n)/ The 'countChar' function returns the number of times the</span> <a name="line-1269"></a><span class='hs-comment'>-- query element appears in the given 'Text'. Subject to fusion.</span> <a name="line-1270"></a><span class='hs-definition'>countChar</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <a name="line-1271"></a><span class='hs-definition'>countChar</span> <span class='hs-varid'>c</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>countChar</span> <span class='hs-varid'>c</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-1272"></a><span class='hs-comment'>{-# INLINE countChar #-}</span> <a name="line-1273"></a> <a name="line-1274"></a><span class='hs-comment'>-------------------------------------------------------------------------------</span> <a name="line-1275"></a><span class='hs-comment'>-- * Zipping</span> <a name="line-1276"></a> <a name="line-1277"></a><a name="zip"></a><span class='hs-comment'>-- | /O(n)/ 'zip' takes two 'Text's and returns a list of</span> <a name="line-1278"></a><span class='hs-comment'>-- corresponding pairs of bytes. If one input 'Text' is short,</span> <a name="line-1279"></a><span class='hs-comment'>-- excess elements of the longer 'Text' are discarded. This is</span> <a name="line-1280"></a><span class='hs-comment'>-- equivalent to a pair of 'unpack' operations.</span> <a name="line-1281"></a><span class='hs-definition'>zip</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-layout'>(</span><span class='hs-conid'>Char</span><span class='hs-layout'>,</span><span class='hs-conid'>Char</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-1282"></a><span class='hs-definition'>zip</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>unstreamList</span> <span class='hs-varop'>$</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>zipWith</span> <span class='hs-conid'>(,)</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <a name="line-1283"></a><span class='hs-comment'>{-# INLINE [0] zip #-}</span> <a name="line-1284"></a> <a name="line-1285"></a><a name="zipWith"></a><span class='hs-comment'>-- | /O(n)/ 'zipWith' generalises 'zip' by zipping with the function</span> <a name="line-1286"></a><span class='hs-comment'>-- given as the first argument, instead of a tupling function.</span> <a name="line-1287"></a><span class='hs-definition'>zipWith</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Char</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-1288"></a><span class='hs-definition'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-varid'>t1</span> <span class='hs-varid'>t2</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unstream</span> <span class='hs-layout'>(</span><span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>zipWith</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>t2</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-1289"></a><span class='hs-comment'>{-# INLINE [0] zipWith #-}</span> <a name="line-1290"></a> <a name="line-1291"></a><a name="words"></a><span class='hs-comment'>-- | /O(n)/ Breaks a 'Text' up into a list of words, delimited by 'Char's</span> <a name="line-1292"></a><span class='hs-comment'>-- representing white space.</span> <a name="line-1293"></a><span class='hs-definition'>words</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1294"></a><span class='hs-definition'>words</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-num'>0</span> <span class='hs-num'>0</span> <a name="line-1295"></a> <span class='hs-keyword'>where</span> <a name="line-1296"></a> <span class='hs-varid'>loop</span> <span class='hs-varop'>!</span><span class='hs-varid'>start</span> <span class='hs-varop'>!</span><span class='hs-varid'>n</span> <a name="line-1297"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>=</span> <span class='hs-varid'>len</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>start</span> <span class='hs-varop'>==</span> <span class='hs-varid'>n</span> <a name="line-1298"></a> <span class='hs-keyword'>then</span> <span class='hs-conid'>[]</span> <a name="line-1299"></a> <span class='hs-keyword'>else</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>start</span><span class='hs-varop'>+</span><span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-varid'>start</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span> <a name="line-1300"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>isSpace</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <a name="line-1301"></a> <span class='hs-keyword'>if</span> <span class='hs-varid'>start</span> <span class='hs-varop'>==</span> <span class='hs-varid'>n</span> <a name="line-1302"></a> <span class='hs-keyword'>then</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>start</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>start</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-1303"></a> <span class='hs-keyword'>else</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>start</span><span class='hs-varop'>+</span><span class='hs-varid'>off</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-varid'>start</span><span class='hs-layout'>)</span> <span class='hs-conop'>:</span> <span class='hs-varid'>loop</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-1304"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>loop</span> <span class='hs-varid'>start</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <a name="line-1305"></a> <span class='hs-keyword'>where</span> <span class='hs-conid'>Iter</span> <span class='hs-varid'>c</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>iter</span> <span class='hs-varid'>t</span> <span class='hs-varid'>n</span> <a name="line-1306"></a><span class='hs-comment'>{-# INLINE words #-}</span> <a name="line-1307"></a> <a name="line-1308"></a><a name="lines"></a><span class='hs-comment'>-- | /O(n)/ Breaks a 'Text' up into a list of 'Text's at</span> <a name="line-1309"></a><span class='hs-comment'>-- newline 'Char's. The resulting strings do not contain newlines.</span> <a name="line-1310"></a><span class='hs-definition'>lines</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <a name="line-1311"></a><span class='hs-definition'>lines</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>ps</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>[]</span> <a name="line-1312"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>h</span> <span class='hs-conop'>:</span> <span class='hs-keyword'>if</span> <span class='hs-varid'>null</span> <span class='hs-varid'>t</span> <a name="line-1313"></a> <span class='hs-keyword'>then</span> <span class='hs-conid'>[]</span> <a name="line-1314"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>lines</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeTail</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <a name="line-1315"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>h</span><span class='hs-layout'>,</span><span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>spanBy</span> <span class='hs-layout'>(</span><span class='hs-varop'>/=</span> <span class='hs-chr'>'\n'</span><span class='hs-layout'>)</span> <span class='hs-varid'>ps</span> <a name="line-1316"></a><span class='hs-comment'>{-# INLINE lines #-}</span> <a name="line-1317"></a> <a name="line-1318"></a><span class='hs-comment'>{- <a name="line-1319"></a>-- | /O(n)/ Portably breaks a 'Text' up into a list of 'Text's at line <a name="line-1320"></a>-- boundaries. <a name="line-1321"></a>-- <a name="line-1322"></a>-- A line boundary is considered to be either a line feed, a carriage <a name="line-1323"></a>-- return immediately followed by a line feed, or a carriage return. <a name="line-1324"></a>-- This accounts for both Unix and Windows line ending conventions, <a name="line-1325"></a>-- and for the old convention used on Mac OS 9 and earlier. <a name="line-1326"></a>lines' :: Text -> [Text] <a name="line-1327"></a>lines' ps | null ps = [] <a name="line-1328"></a> | otherwise = h : case uncons t of <a name="line-1329"></a> Nothing -> [] <a name="line-1330"></a> Just (c,t') <a name="line-1331"></a> | c == '\n' -> lines t' <a name="line-1332"></a> | c == '\r' -> case uncons t' of <a name="line-1333"></a> Just ('\n',t'') -> lines t'' <a name="line-1334"></a> _ -> lines t' <a name="line-1335"></a> where (h,t) = span notEOL ps <a name="line-1336"></a> notEOL c = c /= '\n' && c /= '\r' <a name="line-1337"></a>{-# INLINE lines' #-} <a name="line-1338"></a>-}</span> <a name="line-1339"></a> <a name="line-1340"></a><a name="unlines"></a><span class='hs-comment'>-- | /O(n)/ Joins lines, after appending a terminating newline to</span> <a name="line-1341"></a><span class='hs-comment'>-- each.</span> <a name="line-1342"></a><span class='hs-definition'>unlines</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-1343"></a><span class='hs-definition'>unlines</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>concat</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varop'>`snoc`</span> <span class='hs-chr'>'\n'</span><span class='hs-layout'>)</span> <a name="line-1344"></a><span class='hs-comment'>{-# INLINE unlines #-}</span> <a name="line-1345"></a> <a name="line-1346"></a><a name="unwords"></a><span class='hs-comment'>-- | /O(n)/ Joins words using single space characters.</span> <a name="line-1347"></a><span class='hs-definition'>unwords</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Text</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <a name="line-1348"></a><span class='hs-definition'>unwords</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>intercalate</span> <span class='hs-layout'>(</span><span class='hs-varid'>singleton</span> <span class='hs-chr'>' '</span><span class='hs-layout'>)</span> <a name="line-1349"></a><span class='hs-comment'>{-# INLINE unwords #-}</span> <a name="line-1350"></a> <a name="line-1351"></a><a name="isPrefixOf"></a><span class='hs-comment'>-- | /O(n)/ The 'isPrefixOf' function takes two 'Text's and returns</span> <a name="line-1352"></a><span class='hs-comment'>-- 'True' iff the first is a prefix of the second. This function is</span> <a name="line-1353"></a><span class='hs-comment'>-- subject to fusion.</span> <a name="line-1354"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-1355"></a><span class='hs-definition'>isPrefixOf</span> <span class='hs-varid'>a</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>alen</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>blen</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-1356"></a> <span class='hs-varid'>alen</span> <span class='hs-varop'><=</span> <span class='hs-varid'>blen</span> <span class='hs-varop'>&&</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>isPrefixOf</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>stream</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <a name="line-1357"></a><span class='hs-comment'>{-# INLINE [1] isPrefixOf #-}</span> <a name="line-1358"></a> <a name="line-1359"></a><span class='hs-comment'>{-# RULES <a name="line-1360"></a>"TEXT isPrefixOf -> fused" [~1] forall s t. <a name="line-1361"></a> isPrefixOf s t = S.isPrefixOf (stream s) (stream t) <a name="line-1362"></a>"TEXT isPrefixOf -> unfused" [1] forall s t. <a name="line-1363"></a> S.isPrefixOf (stream s) (stream t) = isPrefixOf s t <a name="line-1364"></a> #-}</span> <a name="line-1365"></a> <a name="line-1366"></a><a name="isSuffixOf"></a><span class='hs-comment'>-- | /O(n)/ The 'isSuffixOf' function takes two 'Text's and returns</span> <a name="line-1367"></a><span class='hs-comment'>-- 'True' iff the first is a suffix of the second.</span> <a name="line-1368"></a><span class='hs-definition'>isSuffixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-1369"></a><span class='hs-definition'>isSuffixOf</span> <span class='hs-varid'>a</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-sel'>_aarr</span> <span class='hs-sel'>_aoff</span> <span class='hs-varid'>alen</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>barr</span> <span class='hs-varid'>boff</span> <span class='hs-varid'>blen</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <a name="line-1370"></a> <span class='hs-varid'>d</span> <span class='hs-varop'>>=</span> <span class='hs-num'>0</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>a</span> <span class='hs-varop'>==</span> <span class='hs-varid'>b'</span> <a name="line-1371"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>blen</span> <span class='hs-comment'>-</span> <span class='hs-varid'>alen</span> <a name="line-1372"></a> <span class='hs-varid'>b'</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>d</span> <span class='hs-varop'>==</span> <span class='hs-num'>0</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>b</span> <a name="line-1373"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Text</span> <span class='hs-varid'>barr</span> <span class='hs-layout'>(</span><span class='hs-varid'>boff</span><span class='hs-varop'>+</span><span class='hs-varid'>d</span><span class='hs-layout'>)</span> <span class='hs-varid'>alen</span> <a name="line-1374"></a><span class='hs-comment'>{-# INLINE isSuffixOf #-}</span> <a name="line-1375"></a> <a name="line-1376"></a><a name="isInfixOf"></a><span class='hs-comment'>-- | /O(n+m)/ The 'isInfixOf' function takes two 'Text's and returns</span> <a name="line-1377"></a><span class='hs-comment'>-- 'True' iff the first is contained, wholly and intact, anywhere</span> <a name="line-1378"></a><span class='hs-comment'>-- within the second.</span> <a name="line-1379"></a><span class='hs-comment'>--</span> <a name="line-1380"></a><span class='hs-comment'>-- In (unlikely) bad cases, this function's time complexity degrades</span> <a name="line-1381"></a><span class='hs-comment'>-- towards /O(n*m)/.</span> <a name="line-1382"></a><span class='hs-definition'>isInfixOf</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Bool</span> <a name="line-1383"></a><span class='hs-definition'>isInfixOf</span> <span class='hs-varid'>needle</span> <span class='hs-varid'>haystack</span> <a name="line-1384"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>null</span> <span class='hs-varid'>needle</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>True</span> <a name="line-1385"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>isSingleton</span> <span class='hs-varid'>needle</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>elem</span> <span class='hs-layout'>(</span><span class='hs-varid'>unsafeHead</span> <span class='hs-varid'>needle</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-varid'>stream</span> <span class='hs-varop'>$</span> <span class='hs-varid'>haystack</span> <a name="line-1386"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>not</span> <span class='hs-varop'>.</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-varid'>null</span> <span class='hs-varop'>.</span> <span class='hs-varid'>indices</span> <span class='hs-varid'>needle</span> <span class='hs-varop'>$</span> <span class='hs-varid'>haystack</span> <a name="line-1387"></a><span class='hs-comment'>{-# INLINE [1] isInfixOf #-}</span> <a name="line-1388"></a> <a name="line-1389"></a><span class='hs-comment'>{-# RULES <a name="line-1390"></a>"TEXT isInfixOf/singleton -> S.elem/S.stream" [~1] forall n h. <a name="line-1391"></a> isInfixOf (singleton n) h = S.elem n (S.stream h) <a name="line-1392"></a> #-}</span> <a name="line-1393"></a> <a name="line-1394"></a><span class='hs-comment'>-------------------------------------------------------------------------------</span> <a name="line-1395"></a><span class='hs-comment'>-- * View patterns</span> <a name="line-1396"></a> <a name="line-1397"></a><a name="stripPrefix"></a><span class='hs-comment'>-- | /O(n)/ Returns the suffix of the second string if its prefix</span> <a name="line-1398"></a><span class='hs-comment'>-- matches the first.</span> <a name="line-1399"></a><span class='hs-comment'>--</span> <a name="line-1400"></a><span class='hs-comment'>-- Examples:</span> <a name="line-1401"></a><span class='hs-comment'>--</span> <a name="line-1402"></a><span class='hs-comment'>-- > stripPrefix "foo" "foobar" == Just "bar"</span> <a name="line-1403"></a><span class='hs-comment'>-- > stripPrefix "foo" "quux" == Nothing</span> <a name="line-1404"></a><span class='hs-comment'>--</span> <a name="line-1405"></a><span class='hs-comment'>-- This is particularly useful with the @ViewPatterns@ extension to</span> <a name="line-1406"></a><span class='hs-comment'>-- GHC, as follows:</span> <a name="line-1407"></a><span class='hs-comment'>--</span> <a name="line-1408"></a><span class='hs-comment'>-- > {-# LANGUAGE ViewPatterns #-}</span> <a name="line-1409"></a><span class='hs-comment'>-- > import Data.Text as T</span> <a name="line-1410"></a><span class='hs-comment'>-- ></span> <a name="line-1411"></a><span class='hs-comment'>-- > fnordLength :: Text -> Int</span> <a name="line-1412"></a><span class='hs-comment'>-- > fnordLength (stripPrefix "fnord" -> Just suf) = T.length suf</span> <a name="line-1413"></a><span class='hs-comment'>-- > fnordLength _ = -1</span> <a name="line-1414"></a><span class='hs-definition'>stripPrefix</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Text</span> <a name="line-1415"></a><span class='hs-definition'>stripPrefix</span> <span class='hs-varid'>p</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-sel'>_arr</span> <span class='hs-sel'>_off</span> <span class='hs-varid'>plen</span><span class='hs-layout'>)</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-1416"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>`isPrefixOf`</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-layout'>(</span><span class='hs-varid'>off</span><span class='hs-varop'>+</span><span class='hs-varid'>plen</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>plen</span><span class='hs-layout'>)</span> <a name="line-1417"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-1418"></a> <a name="line-1419"></a><a name="stripSuffix"></a><span class='hs-comment'>-- | /O(n)/ Returns the prefix of the second string if its suffix</span> <a name="line-1420"></a><span class='hs-comment'>-- matches the first.</span> <a name="line-1421"></a><span class='hs-comment'>--</span> <a name="line-1422"></a><span class='hs-comment'>-- Examples:</span> <a name="line-1423"></a><span class='hs-comment'>--</span> <a name="line-1424"></a><span class='hs-comment'>-- > stripSuffix "bar" "foobar" == Just "foo"</span> <a name="line-1425"></a><span class='hs-comment'>-- > stripSuffix "foo" "quux" == Nothing</span> <a name="line-1426"></a><span class='hs-comment'>--</span> <a name="line-1427"></a><span class='hs-comment'>-- This is particularly useful with the @ViewPatterns@ extension to</span> <a name="line-1428"></a><span class='hs-comment'>-- GHC, as follows:</span> <a name="line-1429"></a><span class='hs-comment'>--</span> <a name="line-1430"></a><span class='hs-comment'>-- > {-# LANGUAGE ViewPatterns #-}</span> <a name="line-1431"></a><span class='hs-comment'>-- > import Data.Text as T</span> <a name="line-1432"></a><span class='hs-comment'>-- ></span> <a name="line-1433"></a><span class='hs-comment'>-- > quuxLength :: Text -> Int</span> <a name="line-1434"></a><span class='hs-comment'>-- > quuxLength (stripSuffix "quux" -> Just pre) = T.length pre</span> <a name="line-1435"></a><span class='hs-comment'>-- > quuxLength _ = -1</span> <a name="line-1436"></a><span class='hs-definition'>stripSuffix</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Text</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Text</span> <a name="line-1437"></a><span class='hs-definition'>stripSuffix</span> <span class='hs-varid'>p</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-sel'>_arr</span> <span class='hs-sel'>_off</span> <span class='hs-varid'>plen</span><span class='hs-layout'>)</span> <span class='hs-varid'>t</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Text</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-varid'>len</span><span class='hs-layout'>)</span> <a name="line-1438"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>p</span> <span class='hs-varop'>`isSuffixOf`</span> <span class='hs-varid'>t</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$!</span> <span class='hs-varid'>textP</span> <span class='hs-varid'>arr</span> <span class='hs-varid'>off</span> <span class='hs-layout'>(</span><span class='hs-varid'>len</span><span class='hs-comment'>-</span><span class='hs-varid'>plen</span><span class='hs-layout'>)</span> <a name="line-1439"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span> <a name="line-1440"></a> <a name="line-1441"></a><a name="emptyError"></a><span class='hs-definition'>emptyError</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span> <a name="line-1442"></a><span class='hs-definition'>emptyError</span> <span class='hs-varid'>fun</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>P</span><span class='hs-varop'>.</span><span class='hs-varid'>error</span> <span class='hs-layout'>(</span><span class='hs-str'>"Data.Text."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>fun</span> <span class='hs-varop'>++</span> <span class='hs-str'>": empty input"</span><span class='hs-layout'>)</span> </pre></body> </html>