@@ -6,7 +6,7 @@
6#if __GLASGOW_HASKELL__ >= 708
6#if __GLASGOW_HASKELL__ >= 708
7{-# LANGUAGE TypeFamilies #-}
7{-# LANGUAGE TypeFamilies #-}
9−{-# LANGUAGE ForeignFunctionInterface, JavaScriptFFI, UnliftedFFITypes #-}
9+
11-- Module : Data.Text
11-- Module : Data.Text
12-- Copyright : (c) 2009, 2010, 2011, 2012 Bryan O'Sullivan,
12-- Copyright : (c) 2009, 2010, 2011, 2012 Bryan O'Sullivan,
@@ -15,6 +15,7 @@
16-- License : BSD-style
16-- License : BSD-style
17-- Maintainer : bos@serpentine.com
17-- Maintainer : bos@serpentine.com
18+-- Stability : experimental
18-- Portability : GHC
19-- Portability : GHC
20-- A time and space-efficient implementation of Unicode text.
21-- A time and space-efficient implementation of Unicode text.
@@ -31,9 +32,8 @@
32-- To use an extended and very rich family of functions for working
33-- To use an extended and very rich family of functions for working
33-- with Unicode text (including normalization, regular expressions,
34-- with Unicode text (including normalization, regular expressions,
34−-- non-standard encodings, text breaking, and locales), see the
35+-- non-standard encodings, text breaking, and locales), see
35−-- <http://hackage.haskell.org/package/text-icu text-icu package >.
36+-- <http://hackage.haskell.org/package/text-icu the text-icu package >.
38module Data.Text
38module Data.Text
@@ -43,9 +43,6 @@ module Data.Text
43 -- * Acceptable data
43 -- * Acceptable data
44 -- $replacement
44 -- $replacement
46− -- * Definition of character
47− -- $character_definition
49 -- * Fusion
46 -- * Fusion
50 -- $fusion
47 -- $fusion
@@ -63,7 +60,6 @@ module Data.Text
@@ -227,17 +223,16 @@ import qualified Data.Text.Internal.Fusion as S
227import qualified Data.Text.Internal.Fusion.Common as S
223import qualified Data.Text.Internal.Fusion.Common as S
228import Data.Text.Encoding (decodeUtf8', encodeUtf8)
224import Data.Text.Encoding (decodeUtf8', encodeUtf8)
229import Data.Text.Internal.Fusion (stream, reverseStream, unstream)
225import Data.Text.Internal.Fusion (stream, reverseStream, unstream)
230−-- import Data.Text.Internal.Private (span_)
226+import Data.Text.Internal.Private (span_)
231−import Data.Text.Internal (Text(..), empty, empty_, firstf, mul, safe, text)
227+import Data.Text.Internal (Text(..), empty, firstf, mul, safe, text)
232−-- import Data.Text.Show (singleton, unpack, unpackCString#)
228+import Data.Text.Show (singleton, unpack, unpackCString#)
233import qualified Prelude as P
229import qualified Prelude as P
234import Data.Text.Unsafe (Iter(..), iter, iter_, lengthWord16, reverseIter,
230import Data.Text.Unsafe (Iter(..), iter, iter_, lengthWord16, reverseIter,
235− reverseIter_, unsafeHead, unsafeTail,
231+ reverseIter_, unsafeHead, unsafeTail)
236− unsafeDupablePerformIO)
237import Data.Text.Internal.Unsafe.Char (unsafeChr)
232import Data.Text.Internal.Unsafe.Char (unsafeChr)
238import qualified Data.Text.Internal.Functions as F
233import qualified Data.Text.Internal.Functions as F
239import qualified Data.Text.Internal.Encoding.Utf16 as U16
234import qualified Data.Text.Internal.Encoding.Utf16 as U16
240−-- import Data.Text.Internal.Search (indices)
235+import Data.Text.Internal.Search (indices)
241#if defined(__HADDOCK__)
236#if defined(__HADDOCK__)
242import Data.ByteString (ByteString)
237import Data.ByteString (ByteString)
243import qualified Data.Text.Lazy as L
238import qualified Data.Text.Lazy as L
@@ -251,68 +246,6 @@ import qualified GHC.Exts as Exts
251import Text.Printf (PrintfArg, formatArg, formatString)
246import Text.Printf (PrintfArg, formatArg, formatString)
254−-- GHCJS ------------------------------------------------------------
255−import Data.JSString.Internal.Type (JSString (..))
256−import qualified Data.JSString as JSS
257−import qualified Data.JSString.Internal.Fusion as SJS
258−import qualified Data.JSString.Internal.Fusion.Common as SJS
260−import GHC.Base (build)
261−import qualified GHC.CString as GHC
262−import GHC.Exts (Addr#, ByteArray#)
263−import GHCJS.Prim (JSVal (..), unpackJSString#)
265−unpack :: Text -> String
266−unpack = coerce JSS.unpack
267−{-# INLINE [1] unpack #-}
269−singleton :: Char -> Text
270−singleton = coerce JSS.singleton
271−{-# INLINE [1] singleton #-}
274−"JSSTRING singleton -> fused" [~1] forall a.
275− singleton a = unstream (S.singleton (safe a))
276−"JSSTRING singleton -> unfused" [1] forall a.
277− unstream (S.singleton (safe a)) = singleton a
280−{-# RULES "inlineJSString" forall s. pack (GHC.Base.build (GHC.unpackFoldrCString# s)) = Text (JSString (unsafeDupablePerformIO (unpackJSString# s))) #-}
282−-- | /O(n)/ Convert a literal string into a JSString. Subject to fusion.
283−unpackCString# :: Addr# -> Text
284−unpackCString# addr# = Text $ SJS.unstream (SJS.streamCString# addr#)
285−{-# NOINLINE unpackCString# #-}
287−{-# RULES "TEXT literal" forall a.
288− unstream (S.map safe (S.streamList (GHC.unpackCString# a)))
289− = unpackCString# a #-}
291−{-# RULES "TEXT literal UTF8" [1] forall a.
292− unstream (S.map safe (S.streamList (GHC.unpackCStringUtf8# a)))
293− = unpackCString# a #-}
295−{-# RULES "TEXT empty literal" [1]
296− unstream (S.map safe (S.streamList []))
299−{-# RULES "TEXT singleton literal" [1] forall a.
300− unstream (S.map safe (S.streamList [a]))
303−---------------------------------------------------------------------
304−-- $character_definition
306−-- This package uses the term /character/ to denote Unicode /code points/.
308−-- Note that this is not the same thing as a grapheme (e.g. a
309−-- composition of code points that form one visual symbol). For
310−-- instance, consider the grapheme \"ä\". This symbol has two
311−-- Unicode representations: a single code-point representation
312−-- @U+00E4@ (the @LATIN SMALL LETTER A WITH DIAERESIS@ code point),
313−-- and a two code point representation @U+0061@ (the \"@A@\" code
314−-- point) and @U+0308@ (the @COMBINING DIAERESIS@ code point).
316-- $strict
249-- $strict
318-- This package provides both strict and lazy 'Text' types. The
251-- This package provides both strict and lazy 'Text' types. The
@@ -388,31 +321,22 @@ unpackCString# addr# = Text $ SJS.unstream (SJS.streamCString# addr#)
388-- Functions that can be fused by the compiler are documented with the
321-- Functions that can be fused by the compiler are documented with the
389-- phrase \"Subject to fusion\".
322-- phrase \"Subject to fusion\".
391−-- instance Eq Text where
392−-- Text arrA offA lenA == Text arrB offB lenB
393−-- | lenA == lenB = A.equal arrA offA arrB offB lenA
394−-- | otherwise = False
395−-- {-# INLINE (==) #-}
396instance Eq Text where
324instance Eq Text where
397− Text x == Text y = x == y
325+ Text arrA offA lenA == Text arrB offB lenB
398−
326+ | lenA == lenB = A.equal arrA offA arrB offB lenA
399−-- instance Ord Text where
327+ | otherwise = False
400−-- compare = compareText
328+ {-# INLINE (==) #-}
402instance Ord Text where
330instance Ord Text where
403− compare (Text x) (Text y) = compare x y
331+ compare = compareText
405instance Read Text where
333instance Read Text where
406 readsPrec p str = [(pack x,y) | (x,y) <- readsPrec p str]
334 readsPrec p str = [(pack x,y) | (x,y) <- readsPrec p str]
408#if MIN_VERSION_base(4,9,0)
336#if MIN_VERSION_base(4,9,0)
409−-- | Non-orphan 'Semigroup' instance only defined for
410−-- @base-4.9.0.0@ and later; orphan instances for older GHCs are
337+-- Semigroup orphan instances for older GHCs are provided by
412−-- the [semigroups](http://hackage.haskell.org/package/semigroups)
413−-- package
338+-- 'semigroups` package
416instance Semigroup Text where
340instance Semigroup Text where
417 (<>) = append
341 (<>) = append
@@ -430,7 +354,6 @@ instance IsString Text where
430 fromString = pack
354 fromString = pack
432#if __GLASGOW_HASKELL__ >= 708
356#if __GLASGOW_HASKELL__ >= 708
434instance Exts.IsList Text where
357instance Exts.IsList Text where
435 type Item Text = Char
358 type Item Text = Char
436 fromList = pack
359 fromList = pack
@@ -441,7 +364,6 @@ instance Exts.IsList Text where
441instance NFData Text where rnf !_ = ()
364instance NFData Text where rnf !_ = ()
445instance Binary Text where
367instance Binary Text where
446 put t = put (encodeUtf8 t)
368 put t = put (encodeUtf8 t)
@@ -475,10 +397,8 @@ instance Data Text where
476#if MIN_VERSION_base(4,7,0)
398#if MIN_VERSION_base(4,7,0)
477-- | Only defined for @base-4.7.0.0@ and later
399-- | Only defined for @base-4.7.0.0@ and later
480instance PrintfArg Text where
400instance PrintfArg Text where
481− formatArg t = formatString $ unpack t
401+ formatArg txt = formatString $ unpack txt
484packConstr :: Constr
404packConstr :: Constr
@@ -487,19 +407,19 @@ packConstr = mkConstr textDataType "pack" [] Prefix
487textDataType :: DataType
407textDataType :: DataType
488textDataType = mkDataType "Data.Text.Text" [packConstr]
408textDataType = mkDataType "Data.Text.Text" [packConstr]
490−-- -- | /O(n)/ Compare two 'Text' values lexicographically.
410+-- | /O(n)/ Compare two 'Text' values lexicographically.
491−-- compareText :: Text -> Text -> Ordering
411+compareText :: Text -> Text -> Ordering
492−-- compareText ta@(Text _arrA _offA lenA) tb@(Text _arrB _offB lenB)
412+compareText ta@(Text _arrA _offA lenA) tb@(Text _arrB _offB lenB)
493−-- | lenA == 0 && lenB == 0 = EQ
413+ | lenA == 0 && lenB == 0 = EQ
494−-- | otherwise = go 0 0
414+ | otherwise = go 0 0
496−-- go !i !j
416+ go !i !j
497−-- | i >= lenA || j >= lenB = compare lenA lenB
417+ | i >= lenA || j >= lenB = compare lenA lenB
498−-- | a < b = LT
418+ | a < b = LT
499−-- | a > b = GT
419+ | a > b = GT
500−-- | otherwise = go (i+di) (j+dj)
420+ | otherwise = go (i+di) (j+dj)
501−-- where Iter a di = iter ta i
421+ where Iter a di = iter ta i
502−-- Iter b dj = iter tb j
422+ Iter b dj = iter tb j
504-- -----------------------------------------------------------------------------
424-- -----------------------------------------------------------------------------
505-- * Conversion to/from 'Text'
425-- * Conversion to/from 'Text'
@@ -507,8 +427,7 @@ textDataType = mkDataType "Data.Text.Text" [packConstr]
507-- | /O(n)/ Convert a 'String' into a 'Text'. Subject to
427-- | /O(n)/ Convert a 'String' into a 'Text'. Subject to
508-- fusion. Performs replacement on invalid scalar values.
428-- fusion. Performs replacement on invalid scalar values.
509pack :: String -> Text
429pack :: String -> Text
510−pack = coerce JSS.pack
511−-- pack = unstream . S.map safe . S.streamList
430+pack = unstream . S.map safe . S.streamList
512{-# INLINE [1] pack #-}
431{-# INLINE [1] pack #-}
514-- -----------------------------------------------------------------------------
433-- -----------------------------------------------------------------------------
@@ -519,8 +438,7 @@ pack = coerce JSS.pack
519-- copying a new array. Subject to fusion. Performs replacement on
438-- copying a new array. Subject to fusion. Performs replacement on
520-- invalid scalar values.
439-- invalid scalar values.
521cons :: Char -> Text -> Text
440cons :: Char -> Text -> Text
522−cons = coerce JSS.cons
523−-- cons c t = unstream (S.cons (safe c) (stream t))
441+cons c t = unstream (S.cons (safe c) (stream t))
524{-# INLINE cons #-}
442{-# INLINE cons #-}
526infixr 5 `cons`
444infixr 5 `cons`
@@ -529,27 +447,25 @@ infixr 5 `cons`
529-- entire array in the process, unless fused. Subject to fusion.
447-- entire array in the process, unless fused. Subject to fusion.
530-- Performs replacement on invalid scalar values.
448-- Performs replacement on invalid scalar values.
531snoc :: Text -> Char -> Text
449snoc :: Text -> Char -> Text
532−snoc = coerce JSS.snoc
533−-- snoc t c = unstream (S.snoc (stream t) (safe c))
450+snoc t c = unstream (S.snoc (stream t) (safe c))
534{-# INLINE snoc #-}
451{-# INLINE snoc #-}
536-- | /O(n)/ Appends one 'Text' to the other by copying both of them
453-- | /O(n)/ Appends one 'Text' to the other by copying both of them
537-- into a new 'Text'. Subject to fusion.
454-- into a new 'Text'. Subject to fusion.
538append :: Text -> Text -> Text
455append :: Text -> Text -> Text
539−append = coerce JSS.append
540−-- append a@(Text arr1 off1 len1) b@(Text arr2 off2 len2)
456+append a@(Text arr1 off1 len1) b@(Text arr2 off2 len2)
541−-- | len1 == 0 = b
457+ | len1 == 0 = b
542−-- | len2 == 0 = a
458+ | len2 == 0 = a
543−-- | len > 0 = Text (A.run x) 0 len
459+ | len > 0 = Text (A.run x) 0 len
544−-- | otherwise = overflowError "append"
460+ | otherwise = overflowError "append"
546−-- len = len1+len2
462+ len = len1+len2
547−-- x :: ST s (A.MArray s)
463+ x :: ST s (A.MArray s)
549−-- arr <- A.new len
465+ arr <- A.new len
550−-- A.copyI arr 0 arr1 off1 len1
466+ A.copyI arr 0 arr1 off1 len1
551−-- A.copyI arr len1 arr2 off2 len
467+ A.copyI arr len1 arr2 off2 len
552−-- return arr
468+ return arr
553{-# NOINLINE append #-}
469{-# NOINLINE append #-}
@@ -562,18 +478,16 @@ append = coerce JSS.append
562-- | /O(1)/ Returns the first character of a 'Text', which must be
478-- | /O(1)/ Returns the first character of a 'Text', which must be
563-- non-empty. Subject to fusion.
479-- non-empty. Subject to fusion.
564head :: Text -> Char
480head :: Text -> Char
565−head = coerce JSS.head
566−-- head t = S.head (stream t)
481+head t = S.head (stream t)
567{-# INLINE head #-}
482{-# INLINE head #-}
569-- | /O(1)/ Returns the first character and rest of a 'Text', or
484-- | /O(1)/ Returns the first character and rest of a 'Text', or
570-- 'Nothing' if empty. Subject to fusion.
485-- 'Nothing' if empty. Subject to fusion.
571uncons :: Text -> Maybe (Char, Text)
486uncons :: Text -> Maybe (Char, Text)
572−uncons = coerce JSS.uncons
573−-- uncons t@(Text arr off len)
487+uncons t@(Text arr off len)
574−-- | len <= 0 = Nothing
488+ | len <= 0 = Nothing
575−-- | otherwise = Just $ let !(Iter c d) = iter t 0
489+ | otherwise = Just $ let !(Iter c d) = iter t 0
576−-- in (c, text arr (off+d) (len-d))
490+ in (c, text arr (off+d) (len-d))
577{-# INLINE [1] uncons #-}
491{-# INLINE [1] uncons #-}
579-- | Lifted from Control.Arrow and specialized.
493-- | Lifted from Control.Arrow and specialized.
@@ -583,13 +497,12 @@ second f (a, b) = (a, f b)
583-- | /O(1)/ Returns the last character of a 'Text', which must be
497-- | /O(1)/ Returns the last character of a 'Text', which must be
584-- non-empty. Subject to fusion.
498-- non-empty. Subject to fusion.
585last :: Text -> Char
499last :: Text -> Char
586−last = coerce JSS.last
587−-- last (Text arr off len)
500+last (Text arr off len)
588−-- | len <= 0 = emptyError "last"
501+ | len <= 0 = emptyError "last"
589−-- | n < 0xDC00 || n > 0xDFFF = unsafeChr n
502+ | n < 0xDC00 || n > 0xDFFF = unsafeChr n
590−-- | otherwise = U16.chr2 n0 n
503+ | otherwise = U16.chr2 n0 n
591−-- where n = A.unsafeIndex arr (off+len-1)
504+ where n = A.unsafeIndex arr (off+len-1)
592−-- n0 = A.unsafeIndex arr (off+len-2)
505+ n0 = A.unsafeIndex arr (off+len-2)
593{-# INLINE [1] last #-}
506{-# INLINE [1] last #-}
@@ -602,11 +515,10 @@ last = coerce JSS.last
602-- | /O(1)/ Returns all characters after the head of a 'Text', which
515-- | /O(1)/ Returns all characters after the head of a 'Text', which
603-- must be non-empty. Subject to fusion.
516-- must be non-empty. Subject to fusion.
604tail :: Text -> Text
517tail :: Text -> Text
605−tail = coerce JSS.tail
606−-- tail t@(Text arr off len)
518+tail t@(Text arr off len)
607−-- | len <= 0 = emptyError "tail"
519+ | len <= 0 = emptyError "tail"
608−-- | otherwise = text arr (off+d) (len-d)
520+ | otherwise = text arr (off+d) (len-d)
609−-- where d = iter_ t 0
521+ where d = iter_ t 0
610{-# INLINE [1] tail #-}
522{-# INLINE [1] tail #-}
@@ -619,12 +531,11 @@ tail = coerce JSS.tail
619-- | /O(1)/ Returns all but the last character of a 'Text', which must
531-- | /O(1)/ Returns all but the last character of a 'Text', which must
620-- be non-empty. Subject to fusion.
532-- be non-empty. Subject to fusion.
621init :: Text -> Text
533init :: Text -> Text
622−init = coerce JSS.init
623−-- init (Text arr off len) | len <= 0 = emptyError "init"
534+init (Text arr off len) | len <= 0 = emptyError "init"
624−-- | n >= 0xDC00 && n <= 0xDFFF = text arr off (len-2)
535+ | n >= 0xDC00 && n <= 0xDFFF = text arr off (len-2)
625−-- | otherwise = text arr off (len-1)
536+ | otherwise = text arr off (len-1)
627−-- n = A.unsafeIndex arr (off+len-1)
538+ n = A.unsafeIndex arr (off+len-1)
628{-# INLINE [1] init #-}
539{-# INLINE [1] init #-}
@@ -634,28 +545,14 @@ init = coerce JSS.init
634 unstream (S.init (stream t)) = init t
545 unstream (S.init (stream t)) = init t
637−-- | /O(1)/ Returns all but the last character and the last character of a
638−-- 'Text', or 'Nothing' if empty.
641−unsnoc :: Text -> Maybe (Text, Char)
642−unsnoc (Text arr off len)
643− | len <= 0 = Nothing
644− | n < 0xDC00 || n > 0xDFFF = Just (text arr off (len-1), unsafeChr n)
645− | otherwise = Just (text arr off (len-2), U16.chr2 n0 n)
646− where n = A.unsafeIndex arr (off+len-1)
647− n0 = A.unsafeIndex arr (off+len-2)
648−{-# INLINE [1] unsnoc #-}
650-- | /O(1)/ Tests whether a 'Text' is empty or not. Subject to
548-- | /O(1)/ Tests whether a 'Text' is empty or not. Subject to
651-- fusion.
549-- fusion.
652null :: Text -> Bool
550null :: Text -> Bool
653−null = coerce JSS.null
654−-- null (Text _arr _off len) =
551+null (Text _arr _off len) =
655−-- #if defined(ASSERTS)
552+#if defined(ASSERTS)
656−-- assert (len >= 0) $
553+ assert (len >= 0) $
658−-- len <= 0
555+ len <= 0
659{-# INLINE [1] null #-}
556{-# INLINE [1] null #-}
@@ -667,15 +564,14 @@ null = coerce JSS.null
668-- | /O(1)/ Tests whether a 'Text' contains exactly one character.
565-- | /O(1)/ Tests whether a 'Text' contains exactly one character.
669-- Subject to fusion.
566-- Subject to fusion.
670−-- isSingleton :: Text -> Bool
567+isSingleton :: Text -> Bool
671−-- isSingleton = S.isSingleton . stream
568+isSingleton = S.isSingleton . stream
672−-- {-# INLINE isSingleton #-}
569+{-# INLINE isSingleton #-}
674-- | /O(n)/ Returns the number of characters in a 'Text'.
571-- | /O(n)/ Returns the number of characters in a 'Text'.
675-- Subject to fusion.
572-- Subject to fusion.
676length :: Text -> Int
573length :: Text -> Int
677−length = coerce JSS.length
678−-- length t = S.length (stream t)
574+length t = S.length (stream t)
679{-# INLINE [0] length #-}
575{-# INLINE [0] length #-}
680-- length needs to be phased after the compareN/length rules otherwise
576-- length needs to be phased after the compareN/length rules otherwise
681-- it may inline before the rules have an opportunity to fire.
577-- it may inline before the rules have an opportunity to fire.
@@ -728,58 +624,29 @@ compareLength t n = S.compareLengthI (stream t) n
728-- -----------------------------------------------------------------------------
624-- -----------------------------------------------------------------------------
729-- * Transformations
625-- * Transformations
730-- | /O(n)/ 'map' @f@ @t@ is the 'Text' obtained by applying @f@ to
626-- | /O(n)/ 'map' @f@ @t@ is the 'Text' obtained by applying @f@ to
731−-- each element of @t@.
735−-- >>> let message = pack "I am not angry. Not at all."
736−-- >>> T.map (\c -> if c == '.' then '!' else c) message
737−-- "I am not angry! Not at all!"
739−-- Subject to fusion. Performs replacement on invalid scalar values.
627+-- each element of @t@. Subject to fusion. Performs replacement on
628+-- invalid scalar values.
740map :: (Char -> Char) -> Text -> Text
629map :: (Char -> Char) -> Text -> Text
742−-- map f t = unstream (S.map (safe . f) (stream t))
630+map f t = unstream (S.map (safe . f) (stream t))
743{-# INLINE [1] map #-}
631{-# INLINE [1] map #-}
745-- | /O(n)/ The 'intercalate' function takes a 'Text' and a list of
633-- | /O(n)/ The 'intercalate' function takes a 'Text' and a list of
746-- 'Text's and concatenates the list after interspersing the first
634-- 'Text's and concatenates the list after interspersing the first
747-- argument between each element of the list.
635-- argument between each element of the list.
751−-- >>> T.intercalate "NI!" ["We", "seek", "the", "Holy", "Grail"]
752−-- "WeNI!seekNI!theNI!HolyNI!Grail"
753intercalate :: Text -> [Text] -> Text
636intercalate :: Text -> [Text] -> Text
754−intercalate = coerce JSS.intercalate
755−-- intercalate t = concat . (F.intersperse t)
637+intercalate t = concat . (F.intersperse t)
756{-# INLINE intercalate #-}
638{-# INLINE intercalate #-}
758-- | /O(n)/ The 'intersperse' function takes a character and places it
640-- | /O(n)/ The 'intersperse' function takes a character and places it
759−-- between the characters of a 'Text'.
641+-- between the characters of a 'Text'. Subject to fusion. Performs
763−-- >>> T.intersperse '.' "SHIELD"
766−-- Subject to fusion. Performs replacement on invalid scalar values.
642+-- replacement on invalid scalar values.
767intersperse :: Char -> Text -> Text
643intersperse :: Char -> Text -> Text
768−intersperse = coerce JSS.intersperse
769−-- intersperse c t = unstream (S.intersperse (safe c) (stream t))
644+intersperse c t = unstream (S.intersperse (safe c) (stream t))
770{-# INLINE intersperse #-}
645{-# INLINE intersperse #-}
772−-- | /O(n)/ Reverse the characters of a string.
647+-- | /O(n)/ Reverse the characters of a string. Subject to fusion.
776−-- >>> T.reverse "desrever"
779−-- Subject to fusion.
780reverse :: Text -> Text
648reverse :: Text -> Text
781−reverse = coerce JSS.reverse
782−-- reverse t = S.reverse (stream t)
649+reverse t = S.reverse (stream t)
783{-# INLINE reverse #-}
650{-# INLINE reverse #-}
785-- | /O(m+n)/ Replace every non-overlapping occurrence of @needle@ in
652-- | /O(m+n)/ Replace every non-overlapping occurrence of @needle@ in
@@ -796,14 +663,12 @@ reverse = coerce JSS.reverse
796-- @needle@ occurs in @replacement@, that occurrence will /not/ itself
663-- @needle@ occurs in @replacement@, that occurrence will /not/ itself
797-- be replaced recursively:
664-- be replaced recursively:
799−-- >>> replace "oo" "foo" "oo"
666+-- > replace "oo" "foo" "oo" == "foo"
802-- In cases where several instances of @needle@ overlap, only the
668-- In cases where several instances of @needle@ overlap, only the
803-- first one will be replaced:
669-- first one will be replaced:
805−-- >>> replace "ofo" "bar" "ofofo"
671+-- > replace "ofo" "bar" "ofofo" == "barfo"
808-- In (unlikely) bad cases, this function's time complexity degrades
673-- In (unlikely) bad cases, this function's time complexity degrades
809-- towards /O(n*m)/.
674-- towards /O(n*m)/.
@@ -815,29 +680,28 @@ replace :: Text
816 -- ^ @haystack@ in which to search.
681 -- ^ @haystack@ in which to search.
818−replace = coerce JSS.replace
819−-- replace needle@(Text _ _ neeLen)
683+replace needle@(Text _ _ neeLen)
820−-- (Text repArr repOff repLen)
684+ (Text repArr repOff repLen)
821−-- haystack@(Text hayArr hayOff hayLen)
685+ haystack@(Text hayArr hayOff hayLen)
822−-- | neeLen == 0 = emptyError "replace"
686+ | neeLen == 0 = emptyError "replace"
823−-- | L.null ixs = haystack
687+ | L.null ixs = haystack
824−-- | len > 0 = Text (A.run x) 0 len
688+ | len > 0 = Text (A.run x) 0 len
825−-- | otherwise = empty
689+ | otherwise = empty
827−-- ixs = indices needle haystack
691+ ixs = indices needle haystack
828−-- len = hayLen - (neeLen - repLen) `mul` L.length ixs
692+ len = hayLen - (neeLen - repLen) `mul` L.length ixs
829−-- x :: ST s (A.MArray s)
693+ x :: ST s (A.MArray s)
831−-- marr <- A.new len
695+ marr <- A.new len
832−-- let loop (i:is) o d = do
696+ let loop (i:is) o d = do
833−-- let d0 = d + i - o
697+ let d0 = d + i - o
834−-- d1 = d0 + repLen
698+ d1 = d0 + repLen
835−-- A.copyI marr d hayArr (hayOff+o) d0
699+ A.copyI marr d hayArr (hayOff+o) d0
836−-- A.copyI marr d0 repArr repOff d1
700+ A.copyI marr d0 repArr repOff d1
837−-- loop is (i + neeLen) d1
701+ loop is (i + neeLen) d1
838−-- loop [] o d = A.copyI marr d hayArr (hayOff+o) len
702+ loop [] o d = A.copyI marr d hayArr (hayOff+o) len
839−-- loop ixs 0 0
703+ loop ixs 0 0
840−-- return marr
704+ return marr
842-- ----------------------------------------------------------------------------
706-- ----------------------------------------------------------------------------
843-- ** Case conversions (folds)
707-- ** Case conversions (folds)
@@ -876,8 +740,7 @@ replace = coerce JSS.replace
876-- U+00B5) is case folded to \"μ\" (small letter mu, U+03BC)
740-- U+00B5) is case folded to \"μ\" (small letter mu, U+03BC)
877-- instead of itself.
741-- instead of itself.
878toCaseFold :: Text -> Text
742toCaseFold :: Text -> Text
879−-- toCaseFold t = unstream (S.toCaseFold (stream t))
743+toCaseFold t = unstream (S.toCaseFold (stream t))
880−toCaseFold = coerce JSS.toCaseFold
881{-# INLINE toCaseFold #-}
744{-# INLINE toCaseFold #-}
883-- | /O(n)/ Convert a string to lower case, using simple case
746-- | /O(n)/ Convert a string to lower case, using simple case
@@ -888,8 +751,7 @@ toCaseFold = coerce JSS.toCaseFold
888-- U+0130) maps to the sequence \"i\" (Latin small letter i, U+0069)
751-- U+0130) maps to the sequence \"i\" (Latin small letter i, U+0069)
889-- followed by \" ̇\" (combining dot above, U+0307).
752-- followed by \" ̇\" (combining dot above, U+0307).
890toLower :: Text -> Text
753toLower :: Text -> Text
891−-- toLower t = unstream (S.toLower (stream t))
754+toLower t = unstream (S.toLower (stream t))
892−toLower = coerce JSS.toLower
893{-# INLINE toLower #-}
755{-# INLINE toLower #-}
895-- | /O(n)/ Convert a string to upper case, using simple case
757-- | /O(n)/ Convert a string to upper case, using simple case
@@ -899,8 +761,7 @@ toLower = coerce JSS.toLower
899-- instance, the German \"ß\" (eszett, U+00DF) maps to the
761-- instance, the German \"ß\" (eszett, U+00DF) maps to the
900-- two-letter sequence \"SS\".
762-- two-letter sequence \"SS\".
901toUpper :: Text -> Text
763toUpper :: Text -> Text
902−-- toUpper t = unstream (S.toUpper (stream t))
764+toUpper t = unstream (S.toUpper (stream t))
903−toUpper = coerce JSS.toUpper
904{-# INLINE toUpper #-}
765{-# INLINE toUpper #-}
906-- | /O(n)/ Convert a string to title case, using simple case
767-- | /O(n)/ Convert a string to title case, using simple case
@@ -921,11 +782,8 @@ toUpper = coerce JSS.toUpper
921-- guides disagree on whether the book name \"The Hill of the Red
782-- guides disagree on whether the book name \"The Hill of the Red
922-- Fox\" is correctly title cased—but this function will
783-- Fox\" is correctly title cased—but this function will
923-- capitalize /every/ word.
784-- capitalize /every/ word.
926toTitle :: Text -> Text
785toTitle :: Text -> Text
927−toTitle = coerce JSS.toTitle
928−-- toTitle t = unstream (S.toTitle (stream t))
786+toTitle t = unstream (S.toTitle (stream t))
929{-# INLINE toTitle #-}
787{-# INLINE toTitle #-}
931-- | /O(n)/ Left-justify a string to the given length, using the
789-- | /O(n)/ Left-justify a string to the given length, using the
@@ -934,17 +792,13 @@ toTitle = coerce JSS.toTitle
935-- Examples:
793-- Examples:
937−-- >>> justifyLeft 7 'x' "foo"
795+-- > justifyLeft 7 'x' "foo" == "fooxxxx"
940−-- >>> justifyLeft 3 'x' "foobar"
796+-- > justifyLeft 3 'x' "foobar" == "foobar"
942justifyLeft :: Int -> Char -> Text -> Text
797justifyLeft :: Int -> Char -> Text -> Text
943−justifyLeft = coerce JSS.justifyLeft
798+justifyLeft k c t
945−-- | len >= k = t
799+ | len >= k = t
946−-- | otherwise = t `append` replicateChar (k-len) c
800+ | otherwise = t `append` replicateChar (k-len) c
947−-- where len = length t
801+ where len = length t
948{-# INLINE [1] justifyLeft #-}
802{-# INLINE [1] justifyLeft #-}
@@ -960,17 +814,13 @@ justifyLeft = coerce JSS.justifyLeft
961-- Examples:
815-- Examples:
963−-- >>> justifyRight 7 'x' "bar"
817+-- > justifyRight 7 'x' "bar" == "xxxxbar"
966−-- >>> justifyRight 3 'x' "foobar"
818+-- > justifyRight 3 'x' "foobar" == "foobar"
968justifyRight :: Int -> Char -> Text -> Text
819justifyRight :: Int -> Char -> Text -> Text
969−justifyRight = coerce JSS.justifyRight
820+justifyRight k c t
970−-- justifyRight k c t
971−-- | len >= k = t
821+ | len >= k = t
972−-- | otherwise = replicateChar (k-len) c `append` t
822+ | otherwise = replicateChar (k-len) c `append` t
973−-- where len = length t
823+ where len = length t
974{-# INLINE justifyRight #-}
824{-# INLINE justifyRight #-}
976-- | /O(n)/ Center a string to the given length, using the specified
826-- | /O(n)/ Center a string to the given length, using the specified
@@ -979,34 +829,23 @@ justifyRight = coerce JSS.justifyRight
980-- Examples:
830-- Examples:
982−-- >>> center 8 'x' "HS"
832+-- > center 8 'x' "HS" = "xxxHSxxx"
984center :: Int -> Char -> Text -> Text
833center :: Int -> Char -> Text -> Text
985−center = coerce JSS.center
834+center k c t
987−-- | len >= k = t
835+ | len >= k = t
988−-- | otherwise = replicateChar l c `append` t `append` replicateChar r c
836+ | otherwise = replicateChar l c `append` t `append` replicateChar r c
989−-- where len = length t
837+ where len = length t
990−-- d = k - len
838+ d = k - len
991−-- r = d `quot` 2
839+ r = d `quot` 2
992−-- l = d - r
840+ l = d - r
993{-# INLINE center #-}
841{-# INLINE center #-}
995-- | /O(n)/ The 'transpose' function transposes the rows and columns
843-- | /O(n)/ The 'transpose' function transposes the rows and columns
996-- of its 'Text' argument. Note that this function uses 'pack',
844-- of its 'Text' argument. Note that this function uses 'pack',
997-- 'unpack', and the list version of transpose, and is thus not very
845-- 'unpack', and the list version of transpose, and is thus not very
998-- efficient.
846-- efficient.
1002−-- >>> transpose ["green","orange"]
1003−-- ["go","rr","ea","en","ng","e"]
1005−-- >>> transpose ["blue","red"]
1006−-- ["br","le","ud","e"]
1007transpose :: [Text] -> [Text]
847transpose :: [Text] -> [Text]
1008−transpose = coerce JSS.transpose
1009−-- transpose ts = P.map pack (L.transpose (P.map unpack ts))
848+transpose ts = P.map pack (L.transpose (P.map unpack ts))
1011-- -----------------------------------------------------------------------------
850-- -----------------------------------------------------------------------------
1012-- * Reducing 'Text's (folds)
851-- * Reducing 'Text's (folds)
@@ -1016,27 +855,23 @@ transpose = coerce JSS.transpose
1016-- reduces the 'Text' using the binary operator, from left to right.
855-- reduces the 'Text' using the binary operator, from left to right.
1017-- Subject to fusion.
856-- Subject to fusion.
1018foldl :: (a -> Char -> a) -> a -> Text -> a
857foldl :: (a -> Char -> a) -> a -> Text -> a
1019−foldl f a0 (Text t) = JSS.foldl f a0 t
1020−-- foldl f z t = S.foldl f z (stream t)
858+foldl f z t = S.foldl f z (stream t)
1021{-# INLINE foldl #-}
859{-# INLINE foldl #-}
1023-- | /O(n)/ A strict version of 'foldl'. Subject to fusion.
861-- | /O(n)/ A strict version of 'foldl'. Subject to fusion.
1024foldl' :: (a -> Char -> a) -> a -> Text -> a
862foldl' :: (a -> Char -> a) -> a -> Text -> a
1025−foldl' f a0 (Text t) = JSS.foldl' f a0 t
1026−-- foldl' f z t = S.foldl' f z (stream t)
863+foldl' f z t = S.foldl' f z (stream t)
1027{-# INLINE foldl' #-}
864{-# INLINE foldl' #-}
1029-- | /O(n)/ A variant of 'foldl' that has no starting value argument,
866-- | /O(n)/ A variant of 'foldl' that has no starting value argument,
1030-- and thus must be applied to a non-empty 'Text'. Subject to fusion.
867-- and thus must be applied to a non-empty 'Text'. Subject to fusion.
1031foldl1 :: (Char -> Char -> Char) -> Text -> Char
868foldl1 :: (Char -> Char -> Char) -> Text -> Char
1032−foldl1 = coerce JSS.foldl1
1033−-- foldl1 f t = S.foldl1 f (stream t)
869+foldl1 f t = S.foldl1 f (stream t)
1034{-# INLINE foldl1 #-}
870{-# INLINE foldl1 #-}
1036-- | /O(n)/ A strict version of 'foldl1'. Subject to fusion.
872-- | /O(n)/ A strict version of 'foldl1'. Subject to fusion.
1037foldl1' :: (Char -> Char -> Char) -> Text -> Char
873foldl1' :: (Char -> Char -> Char) -> Text -> Char
1038−foldl1' = coerce JSS.foldl1'
1039−-- foldl1' f t = S.foldl1' f (stream t)
874+foldl1' f t = S.foldl1' f (stream t)
1040{-# INLINE foldl1' #-}
875{-# INLINE foldl1' #-}
1042-- | /O(n)/ 'foldr', applied to a binary operator, a starting value
877-- | /O(n)/ 'foldr', applied to a binary operator, a starting value
@@ -1044,16 +879,14 @@ foldl1' = coerce JSS.foldl1'
1044-- reduces the 'Text' using the binary operator, from right to left.
879-- reduces the 'Text' using the binary operator, from right to left.
1045-- Subject to fusion.
880-- Subject to fusion.
1046foldr :: (Char -> a -> a) -> a -> Text -> a
881foldr :: (Char -> a -> a) -> a -> Text -> a
1047−foldr f a0 (Text t) = JSS.foldr f a0 t
1048−-- foldr f z t = S.foldr f z (stream t)
882+foldr f z t = S.foldr f z (stream t)
1049{-# INLINE foldr #-}
883{-# INLINE foldr #-}
1051-- | /O(n)/ A variant of 'foldr' that has no starting value argument,
885-- | /O(n)/ A variant of 'foldr' that has no starting value argument,
1052-- and thus must be applied to a non-empty 'Text'. Subject to
886-- and thus must be applied to a non-empty 'Text'. Subject to
1053-- fusion.
887-- fusion.
1054foldr1 :: (Char -> Char -> Char) -> Text -> Char
888foldr1 :: (Char -> Char -> Char) -> Text -> Char
1055−foldr1 = coerce JSS.foldr1
1056−-- foldr1 f t = S.foldr1 f (stream t)
889+foldr1 f t = S.foldr1 f (stream t)
1057{-# INLINE foldr1 #-}
890{-# INLINE foldr1 #-}
1059-- -----------------------------------------------------------------------------
892-- -----------------------------------------------------------------------------
@@ -1061,54 +894,48 @@ foldr1 = coerce JSS.foldr1
1062-- | /O(n)/ Concatenate a list of 'Text's.
895-- | /O(n)/ Concatenate a list of 'Text's.
1063concat :: [Text] -> Text
896concat :: [Text] -> Text
1064−concat = coerce JSS.concat
1065−-- concat ts = case ts' of
897+concat ts = case ts' of
1066−-- [] -> empty
898+ [] -> empty
1067−-- [t] -> t
899+ [t] -> t
1068−-- _ -> Text (A.run go) 0 len
900+ _ -> Text (A.run go) 0 len
1070−-- ts' = L.filter (not . null) ts
902+ ts' = L.filter (not . null) ts
1071−-- len = sumP "concat" $ L.map lengthWord16 ts'
903+ len = sumP "concat" $ L.map lengthWord16 ts'
1072−-- go :: ST s (A.MArray s)
904+ go :: ST s (A.MArray s)
1073−-- go = do
905+ go = do
1074−-- arr <- A.new len
906+ arr <- A.new len
1075−-- let step i (Text a o l) =
907+ let step i (Text a o l) =
1076−-- let !j = i + l in A.copyI arr i a o j >> return j
908+ let !j = i + l in A.copyI arr i a o j >> return j
1077−-- foldM step 0 ts' >> return arr
909+ foldM step 0 ts' >> return arr
1079-- | /O(n)/ Map a function over a 'Text' that results in a 'Text', and
911-- | /O(n)/ Map a function over a 'Text' that results in a 'Text', and
1080-- concatenate the results.
912-- concatenate the results.
1081concatMap :: (Char -> Text) -> Text -> Text
913concatMap :: (Char -> Text) -> Text -> Text
1082−concatMap = coerce JSS.concatMap
1083−-- concatMap f = concat . foldr ((:) . f) []
914+concatMap f = concat . foldr ((:) . f) []
1084{-# INLINE concatMap #-}
915{-# INLINE concatMap #-}
1086-- | /O(n)/ 'any' @p@ @t@ determines whether any character in the
917-- | /O(n)/ 'any' @p@ @t@ determines whether any character in the
1087-- 'Text' @t@ satisfies the predicate @p@. Subject to fusion.
918-- 'Text' @t@ satisfies the predicate @p@. Subject to fusion.
1088any :: (Char -> Bool) -> Text -> Bool
919any :: (Char -> Bool) -> Text -> Bool
1089−any = coerce JSS.any
1090−-- any p t = S.any p (stream t)
920+any p t = S.any p (stream t)
1091{-# INLINE any #-}
921{-# INLINE any #-}
1093-- | /O(n)/ 'all' @p@ @t@ determines whether all characters in the
923-- | /O(n)/ 'all' @p@ @t@ determines whether all characters in the
1094-- 'Text' @t@ satisfy the predicate @p@. Subject to fusion.
924-- 'Text' @t@ satisfy the predicate @p@. Subject to fusion.
1095all :: (Char -> Bool) -> Text -> Bool
925all :: (Char -> Bool) -> Text -> Bool
1096−all = coerce JSS.all
1097−-- all p t = S.all p (stream t)
926+all p t = S.all p (stream t)
1098{-# INLINE all #-}
927{-# INLINE all #-}
1100-- | /O(n)/ 'maximum' returns the maximum value from a 'Text', which
929-- | /O(n)/ 'maximum' returns the maximum value from a 'Text', which
1101-- must be non-empty. Subject to fusion.
930-- must be non-empty. Subject to fusion.
1102maximum :: Text -> Char
931maximum :: Text -> Char
1103−maximum = coerce JSS.maximum
1104−-- maximum t = S.maximum (stream t)
932+maximum t = S.maximum (stream t)
1105{-# INLINE maximum #-}
933{-# INLINE maximum #-}
1107-- | /O(n)/ 'minimum' returns the minimum value from a 'Text', which
935-- | /O(n)/ 'minimum' returns the minimum value from a 'Text', which
1108-- must be non-empty. Subject to fusion.
936-- must be non-empty. Subject to fusion.
1109minimum :: Text -> Char
937minimum :: Text -> Char
1110−minimum = coerce JSS.minimum
1111−-- minimum t = S.minimum (stream t)
938+minimum t = S.minimum (stream t)
1112{-# INLINE minimum #-}
939{-# INLINE minimum #-}
1114-- -----------------------------------------------------------------------------
941-- -----------------------------------------------------------------------------
@@ -1124,9 +951,8 @@ minimum = coerce JSS.minimum
1125-- > last (scanl f z xs) == foldl f z xs.
952-- > last (scanl f z xs) == foldl f z xs.
1126scanl :: (Char -> Char -> Char) -> Char -> Text -> Text
953scanl :: (Char -> Char -> Char) -> Char -> Text -> Text
1127−scanl = coerce JSS.scanl
1128−-- scanl f z t = unstream (S.scanl g z (stream t))
954+scanl f z t = unstream (S.scanl g z (stream t))
1129−-- where g a b = safe (f a b)
955+ where g a b = safe (f a b)
1130{-# INLINE scanl #-}
956{-# INLINE scanl #-}
1132-- | /O(n)/ 'scanl1' is a variant of 'scanl' that has no starting
958-- | /O(n)/ 'scanl1' is a variant of 'scanl' that has no starting
@@ -1135,9 +961,8 @@ scanl = coerce JSS.scanl
1136-- > scanl1 f [x1, x2, ...] == [x1, x1 `f` x2, ...]
962-- > scanl1 f [x1, x2, ...] == [x1, x1 `f` x2, ...]
1137scanl1 :: (Char -> Char -> Char) -> Text -> Text
963scanl1 :: (Char -> Char -> Char) -> Text -> Text
1138−scanl1 = coerce JSS.scanl1
1139−-- scanl1 f t | null t = empty
964+scanl1 f t | null t = empty
1140−-- | otherwise = scanl f (unsafeHead t) (unsafeTail t)
965+ | otherwise = scanl f (unsafeHead t) (unsafeTail t)
1141{-# INLINE scanl1 #-}
966{-# INLINE scanl1 #-}
1143-- | /O(n)/ 'scanr' is the right-to-left dual of 'scanl'. Performs
968-- | /O(n)/ 'scanr' is the right-to-left dual of 'scanl'. Performs
@@ -1145,18 +970,16 @@ scanl1 = coerce JSS.scanl1
1146-- > scanr f v == reverse . scanl (flip f) v . reverse
971-- > scanr f v == reverse . scanl (flip f) v . reverse
1147scanr :: (Char -> Char -> Char) -> Char -> Text -> Text
972scanr :: (Char -> Char -> Char) -> Char -> Text -> Text
1148−scanr = coerce JSS.scanr
1149−-- scanr f z = S.reverse . S.reverseScanr g z . reverseStream
973+scanr f z = S.reverse . S.reverseScanr g z . reverseStream
1150−-- where g a b = safe (f a b)
974+ where g a b = safe (f a b)
1151{-# INLINE scanr #-}
975{-# INLINE scanr #-}
1153-- | /O(n)/ 'scanr1' is a variant of 'scanr' that has no starting
977-- | /O(n)/ 'scanr1' is a variant of 'scanr' that has no starting
1154-- value argument. Subject to fusion. Performs replacement on
978-- value argument. Subject to fusion. Performs replacement on
1155-- invalid scalar values.
979-- invalid scalar values.
1156scanr1 :: (Char -> Char -> Char) -> Text -> Text
980scanr1 :: (Char -> Char -> Char) -> Text -> Text
1157−scanr1 = coerce JSS.scanr1
1158−-- scanr1 f t | null t = empty
981+scanr1 f t | null t = empty
1159−-- | otherwise = scanr f (last t) (init t)
982+ | otherwise = scanr f (last t) (init t)
1160{-# INLINE scanr1 #-}
983{-# INLINE scanr1 #-}
1162-- | /O(n)/ Like a combination of 'map' and 'foldl''. Applies a
985-- | /O(n)/ Like a combination of 'map' and 'foldl''. Applies a
@@ -1164,11 +987,8 @@ scanr1 = coerce JSS.scanr1
1164-- parameter from left to right, and returns a final 'Text'. Performs
987-- parameter from left to right, and returns a final 'Text'. Performs
1165-- replacement on invalid scalar values.
988-- replacement on invalid scalar values.
1166mapAccumL :: (a -> Char -> (a,Char)) -> a -> Text -> (a, Text)
989mapAccumL :: (a -> Char -> (a,Char)) -> a -> Text -> (a, Text)
1167−mapAccumL f z0 (Text a) =
1168− let (a', t) = JSS.mapAccumL f z0 a
1170−-- mapAccumL f z0 = S.mapAccumL g z0 . stream
990+mapAccumL f z0 = S.mapAccumL g z0 . stream
1171−-- where g a b = second safe (f a b)
991+ where g a b = second safe (f a b)
1172{-# INLINE mapAccumL #-}
992{-# INLINE mapAccumL #-}
1174-- | The 'mapAccumR' function behaves like a combination of 'map' and
994-- | The 'mapAccumR' function behaves like a combination of 'map' and
@@ -1178,11 +998,8 @@ mapAccumL f z0 (Text a) =
1178-- 'Text'.
998-- 'Text'.
1179-- Performs replacement on invalid scalar values.
999-- Performs replacement on invalid scalar values.
1180mapAccumR :: (a -> Char -> (a,Char)) -> a -> Text -> (a, Text)
1000mapAccumR :: (a -> Char -> (a,Char)) -> a -> Text -> (a, Text)
1181−mapAccumR f z0 (Text a) =
1182− let (a', t) = JSS.mapAccumR f z0 a
1184−-- mapAccumR f z0 = second reverse . S.mapAccumL g z0 . reverseStream
1001+mapAccumR f z0 = second reverse . S.mapAccumL g z0 . reverseStream
1185−-- where g a b = second safe (f a b)
1002+ where g a b = second safe (f a b)
1186{-# INLINE mapAccumR #-}
1003{-# INLINE mapAccumR #-}
1188-- -----------------------------------------------------------------------------
1005-- -----------------------------------------------------------------------------
@@ -1191,21 +1008,20 @@ mapAccumR f z0 (Text a) =
1191-- | /O(n*m)/ 'replicate' @n@ @t@ is a 'Text' consisting of the input
1008-- | /O(n*m)/ 'replicate' @n@ @t@ is a 'Text' consisting of the input
1192-- @t@ repeated @n@ times.
1009-- @t@ repeated @n@ times.
1193replicate :: Int -> Text -> Text
1010replicate :: Int -> Text -> Text
1194−replicate = coerce JSS.replicate
1195−-- replicate n t@(Text a o l)
1011+replicate n t@(Text a o l)
1196−-- | n <= 0 || l <= 0 = empty
1012+ | n <= 0 || l <= 0 = empty
1197−-- | n == 1 = t
1013+ | n == 1 = t
1198−-- | isSingleton t = replicateChar n (unsafeHead t)
1014+ | isSingleton t = replicateChar n (unsafeHead t)
1199−-- | otherwise = Text (A.run x) 0 len
1015+ | otherwise = Text (A.run x) 0 len
1201−-- len = l `mul` n
1017+ len = l `mul` n
1202−-- x :: ST s (A.MArray s)
1018+ x :: ST s (A.MArray s)
1203−-- x = do
1019+ x = do
1204−-- arr <- A.new len
1020+ arr <- A.new len
1205−-- let loop !d !i | i >= n = return arr
1021+ let loop !d !i | i >= n = return arr
1206−-- | otherwise = let m = d + l
1022+ | otherwise = let m = d + l
1207−-- in A.copyI arr d a o m >> loop m (i+1)
1023+ in A.copyI arr d a o m >> loop m (i+1)
1208−-- loop 0 0
1024+ loop 0 0
1209{-# INLINE [1] replicate #-}
1025{-# INLINE [1] replicate #-}
1211{-# RULES
1027{-# RULES
@@ -1216,19 +1032,8 @@ replicate = coerce JSS.replicate
1216-- | /O(n)/ 'replicateChar' @n@ @c@ is a 'Text' of length @n@ with @c@ the
1032-- | /O(n)/ 'replicateChar' @n@ @c@ is a 'Text' of length @n@ with @c@ the
1217-- value of every element. Subject to fusion.
1033-- value of every element. Subject to fusion.
1218replicateChar :: Int -> Char -> Text
1034replicateChar :: Int -> Char -> Text
1220replicateChar n c = unstream (S.replicateCharI n (safe c))
1035replicateChar n c = unstream (S.replicateCharI n (safe c))
1221{-# INLINE replicateChar #-}
1036{-# INLINE replicateChar #-}
1223−replicateChar n c = Text $ js_replicateChar n c
1224−{-# INLINE [1] replicateChar #-}
1226−"JSSTRING replicateChar -> fused" [~1] forall n c.
1227− replicateChar n c = unstream (S.replicateCharI n (safe c))
1228−"JSSTRING replicateChar -> unfused" [1] forall n c.
1229− unstream (S.replicateCharI n (safe c)) = replicateChar n c
1233-- | /O(n)/, where @n@ is the length of the result. The 'unfoldr'
1038-- | /O(n)/, where @n@ is the length of the result. The 'unfoldr'
1234-- function is analogous to the List 'L.unfoldr'. 'unfoldr' builds a
1039-- function is analogous to the List 'L.unfoldr'. 'unfoldr' builds a
@@ -1238,8 +1043,7 @@ replicateChar n c = Text $ js_replicateChar n c
1238-- string, and @b@ is the seed value for further production. Subject
1043-- string, and @b@ is the seed value for further production. Subject
1239-- to fusion. Performs replacement on invalid scalar values.
1044-- to fusion. Performs replacement on invalid scalar values.
1240unfoldr :: (a -> Maybe (Char,a)) -> a -> Text
1045unfoldr :: (a -> Maybe (Char,a)) -> a -> Text
1241−unfoldr f a = Text $ JSS.unfoldr f a
1242−-- unfoldr f s = unstream (S.unfoldr (firstf safe . f) s)
1046+unfoldr f s = unstream (S.unfoldr (firstf safe . f) s)
1243{-# INLINE unfoldr #-}
1047{-# INLINE unfoldr #-}
1245-- | /O(n)/ Like 'unfoldr', 'unfoldrN' builds a 'Text' from a seed
1049-- | /O(n)/ Like 'unfoldr', 'unfoldrN' builds a 'Text' from a seed
@@ -1249,8 +1053,7 @@ unfoldr f a = Text $ JSS.unfoldr f a
1249-- correct, otherwise its performance is similar to 'unfoldr'. Subject
1053-- correct, otherwise its performance is similar to 'unfoldr'. Subject
1250-- to fusion. Performs replacement on invalid scalar values.
1054-- to fusion. Performs replacement on invalid scalar values.
1251unfoldrN :: Int -> (a -> Maybe (Char,a)) -> a -> Text
1055unfoldrN :: Int -> (a -> Maybe (Char,a)) -> a -> Text
1252−unfoldrN n f a0 = Text $ JSS.unfoldrN n f a0
1253−-- unfoldrN n f s = unstream (S.unfoldrN n (firstf safe . f) s)
1056+unfoldrN n f s = unstream (S.unfoldrN n (firstf safe . f) s)
1254{-# INLINE unfoldrN #-}
1057{-# INLINE unfoldrN #-}
1256-- -----------------------------------------------------------------------------
1059-- -----------------------------------------------------------------------------
@@ -1260,19 +1063,18 @@ unfoldrN n f a0 = Text $ JSS.unfoldrN n f a0
1260-- 'Text' of length @n@, or the 'Text' itself if @n@ is greater than
1063-- 'Text' of length @n@, or the 'Text' itself if @n@ is greater than
1261-- the length of the Text. Subject to fusion.
1064-- the length of the Text. Subject to fusion.
1262take :: Int -> Text -> Text
1065take :: Int -> Text -> Text
1263−take = coerce JSS.take
1264−-- take n t@(Text arr off len)
1066+take n t@(Text arr off len)
1265−-- | n <= 0 = empty
1067+ | n <= 0 = empty
1266−-- | n >= len = t
1068+ | n >= len = t
1267−-- | otherwise = text arr off (iterN n t)
1069+ | otherwise = text arr off (iterN n t)
1268{-# INLINE [1] take #-}
1070{-# INLINE [1] take #-}
1270−-- iterN :: Int -> Text -> Int
1072+iterN :: Int -> Text -> Int
1271−-- iterN n t@(Text _arr _off len) = loop 0 0
1073+iterN n t@(Text _arr _off len) = loop 0 0
1272−-- where loop !i !cnt
1074+ where loop !i !cnt
1273−-- | i >= len || cnt >= n = i
1075+ | i >= len || cnt >= n = i
1274−-- | otherwise = loop (i+d) (cnt+1)
1076+ | otherwise = loop (i+d) (cnt+1)
1275−-- where d = iter_ t i
1077+ where d = iter_ t i
1277{-# RULES
1079{-# RULES
1278"TEXT take -> fused" [~1] forall n t.
1080"TEXT take -> fused" [~1] forall n t.
@@ -1286,36 +1088,31 @@ take = coerce JSS.take
1287-- Examples:
1089-- Examples:
1289−-- >>> takeEnd 3 "foobar"
1091+-- > takeEnd 3 "foobar" == "bar"
1293takeEnd :: Int -> Text -> Text
1092takeEnd :: Int -> Text -> Text
1294−takeEnd = coerce JSS.takeEnd
1295−-- takeEnd n t@(Text arr off len)
1093+takeEnd n t@(Text arr off len)
1296−-- | n <= 0 = empty
1094+ | n <= 0 = empty
1297−-- | n >= len = t
1095+ | n >= len = t
1298−-- | otherwise = text arr (off+i) (len-i)
1096+ | otherwise = text arr (off+i) (len-i)
1299−-- where i = iterNEnd n t
1097+ where i = iterNEnd n t
1301−-- iterNEnd :: Int -> Text -> Int
1099+iterNEnd :: Int -> Text -> Int
1302−-- iterNEnd n t@(Text _arr _off len) = loop (len-1) n
1100+iterNEnd n t@(Text _arr _off len) = loop (len-1) n
1303−-- where loop i !m
1101+ where loop i !m
1304−-- | i <= 0 = 0
1102+ | i <= 0 = 0
1305−-- | m <= 1 = i
1103+ | m <= 1 = i
1306−-- | otherwise = loop (i+d) (m-1)
1104+ | otherwise = loop (i+d) (m-1)
1307−-- where d = reverseIter_ t i
1105+ where d = reverseIter_ t i
1309-- | /O(n)/ 'drop' @n@, applied to a 'Text', returns the suffix of the
1107-- | /O(n)/ 'drop' @n@, applied to a 'Text', returns the suffix of the
1310-- 'Text' after the first @n@ characters, or the empty 'Text' if @n@
1108-- 'Text' after the first @n@ characters, or the empty 'Text' if @n@
1311-- is greater than the length of the 'Text'. Subject to fusion.
1109-- is greater than the length of the 'Text'. Subject to fusion.
1312drop :: Int -> Text -> Text
1110drop :: Int -> Text -> Text
1313−drop = coerce JSS.drop
1314−-- drop n t@(Text arr off len)
1111+drop n t@(Text arr off len)
1315−-- | n <= 0 = t
1112+ | n <= 0 = t
1316−-- | n >= len = empty
1113+ | n >= len = empty
1317−-- | otherwise = text arr (off+i) (len-i)
1114+ | otherwise = text arr (off+i) (len-i)
1318−-- where i = iterN n t
1115+ where i = iterN n t
1319{-# INLINE [1] drop #-}
1116{-# INLINE [1] drop #-}
1321{-# RULES
1118{-# RULES
@@ -1330,27 +1127,22 @@ drop = coerce JSS.drop
1331-- Examples:
1128-- Examples:
1333−-- >>> dropEnd 3 "foobar"
1130+-- > dropEnd 3 "foobar" == "foo"
1337dropEnd :: Int -> Text -> Text
1131dropEnd :: Int -> Text -> Text
1338−dropEnd = coerce JSS.dropEnd
1339−-- dropEnd n t@(Text arr off len)
1132+dropEnd n t@(Text arr off len)
1340−-- | n <= 0 = t
1133+ | n <= 0 = t
1341−-- | n >= len = empty
1134+ | n >= len = empty
1342−-- | otherwise = text arr off (iterNEnd n t)
1135+ | otherwise = text arr off (iterNEnd n t)
1344-- | /O(n)/ 'takeWhile', applied to a predicate @p@ and a 'Text',
1137-- | /O(n)/ 'takeWhile', applied to a predicate @p@ and a 'Text',
1345-- returns the longest prefix (possibly empty) of elements that
1138-- returns the longest prefix (possibly empty) of elements that
1346-- satisfy @p@. Subject to fusion.
1139-- satisfy @p@. Subject to fusion.
1347takeWhile :: (Char -> Bool) -> Text -> Text
1140takeWhile :: (Char -> Bool) -> Text -> Text
1348−takeWhile = coerce JSS.takeWhile
1349−-- takeWhile p t@(Text arr off len) = loop 0
1141+takeWhile p t@(Text arr off len) = loop 0
1350−-- where loop !i | i >= len = t
1142+ where loop !i | i >= len = t
1351−-- | p c = loop (i+d)
1143+ | p c = loop (i+d)
1352−-- | otherwise = text arr off i
1144+ | otherwise = text arr off i
1353−-- where Iter c d = iter t i
1145+ where Iter c d = iter t i
1354{-# INLINE [1] takeWhile #-}
1146{-# INLINE [1] takeWhile #-}
1356{-# RULES
1148{-# RULES
@@ -1365,25 +1157,13 @@ takeWhile = coerce JSS.takeWhile
1365-- satisfy @p@. Subject to fusion.
1157-- satisfy @p@. Subject to fusion.
1366-- Examples:
1158-- Examples:
1368−-- >>> takeWhileEnd (=='o') "foo"
1160+-- > takeWhileEnd (=='o') "foo" == "oo"
1372takeWhileEnd :: (Char -> Bool) -> Text -> Text
1161takeWhileEnd :: (Char -> Bool) -> Text -> Text
1374takeWhileEnd p t@(Text arr off len) = loop (len-1) len
1162takeWhileEnd p t@(Text arr off len) = loop (len-1) len
1375 where loop !i !l | l <= 0 = t
1163 where loop !i !l | l <= 0 = t
1376 | p c = loop (i+d) (l+d)
1164 | p c = loop (i+d) (l+d)
1377 | otherwise = text arr (off+l) (len-l)
1165 | otherwise = text arr (off+l) (len-l)
1378 where (c,d) = reverseIter t i
1166 where (c,d) = reverseIter t i
1380−takeWhileEnd p t@(Text jst) = loop (len-1) len
1381− where loop !i !l | l <= 0 = t
1382− | p c = loop (i+d) (l+d)
1383− | otherwise = Text $ js_substr1 l jst
1384− where (c,d) = reverseIter t i
1387{-# INLINE [1] takeWhileEnd #-}
1167{-# INLINE [1] takeWhileEnd #-}
1389{-# RULES
1169{-# RULES
@@ -1396,12 +1176,11 @@ takeWhileEnd p t@(Text jst) = loop (len-1) len
1396-- | /O(n)/ 'dropWhile' @p@ @t@ returns the suffix remaining after
1176-- | /O(n)/ 'dropWhile' @p@ @t@ returns the suffix remaining after
1397-- 'takeWhile' @p@ @t@. Subject to fusion.
1177-- 'takeWhile' @p@ @t@. Subject to fusion.
1398dropWhile :: (Char -> Bool) -> Text -> Text
1178dropWhile :: (Char -> Bool) -> Text -> Text
1399−dropWhile = coerce JSS.dropWhile
1400−-- dropWhile p t@(Text arr off len) = loop 0 0
1179+dropWhile p t@(Text arr off len) = loop 0 0
1401−-- where loop !i !l | l >= len = empty
1180+ where loop !i !l | l >= len = empty
1402−-- | p c = loop (i+d) (l+d)
1181+ | p c = loop (i+d) (l+d)
1403−-- | otherwise = Text arr (off+i) (len-l)
1182+ | otherwise = Text arr (off+i) (len-l)
1404−
1183+ where Iter c d = iter t i
1405{-# INLINE [1] dropWhile #-}
1184{-# INLINE [1] dropWhile #-}
1407{-# RULES
1186{-# RULES
@@ -1417,15 +1196,13 @@ dropWhile = coerce JSS.dropWhile
1418-- Examples:
1197-- Examples:
1420−-- >>> dropWhileEnd (=='.') "foo..."
1199+-- > dropWhileEnd (=='.') "foo..." == "foo"
1422dropWhileEnd :: (Char -> Bool) -> Text -> Text
1200dropWhileEnd :: (Char -> Bool) -> Text -> Text
1423−dropWhileEnd = coerce JSS.dropWhileEnd
1424−-- dropWhileEnd p t@(Text arr off len) = loop (len-1) len
1201+dropWhileEnd p t@(Text arr off len) = loop (len-1) len
1425−-- where loop !i !l | l <= 0 = empty
1202+ where loop !i !l | l <= 0 = empty
1426−-- | p c = loop (i+d) (l+d)
1203+ | p c = loop (i+d) (l+d)
1427−-- | otherwise = Text arr off l
1204+ | otherwise = Text arr off l
1428−-- where (c,d) = reverseIter t i
1205+ where (c,d) = reverseIter t i
1429{-# INLINE [1] dropWhileEnd #-}
1206{-# INLINE [1] dropWhileEnd #-}
1431{-# RULES
1208{-# RULES
@@ -1468,49 +1245,45 @@ strip = dropAround isSpace
1468-- prefix of @t@ of length @n@, and whose second is the remainder of
1245-- prefix of @t@ of length @n@, and whose second is the remainder of
1469-- the string. It is equivalent to @('take' n t, 'drop' n t)@.
1246-- the string. It is equivalent to @('take' n t, 'drop' n t)@.
1470splitAt :: Int -> Text -> (Text, Text)
1247splitAt :: Int -> Text -> (Text, Text)
1471−splitAt = coerce JSS.splitAt
1472−-- splitAt n t@(Text arr off len)
1248+splitAt n t@(Text arr off len)
1473−-- | n <= 0 = (empty, t)
1249+ | n <= 0 = (empty, t)
1474−-- | n >= len = (t, empty)
1250+ | n >= len = (t, empty)
1475−-- | otherwise = let k = iterN n t
1251+ | otherwise = let k = iterN n t
1476−-- in (text arr off k, text arr (off+k) (len-k))
1252+ in (text arr off k, text arr (off+k) (len-k))
1478-- | /O(n)/ 'span', applied to a predicate @p@ and text @t@, returns
1254-- | /O(n)/ 'span', applied to a predicate @p@ and text @t@, returns
1479-- a pair whose first element is the longest prefix (possibly empty)
1255-- a pair whose first element is the longest prefix (possibly empty)
1480-- of @t@ of elements that satisfy @p@, and whose second is the
1256-- of @t@ of elements that satisfy @p@, and whose second is the
1481-- remainder of the list.
1257-- remainder of the list.
1482span :: (Char -> Bool) -> Text -> (Text, Text)
1258span :: (Char -> Bool) -> Text -> (Text, Text)
1483−span = coerce JSS.span
1484−-- span p t = case span_ p t of
1259+span p t = case span_ p t of
1485−-- (# hd,tl #) -> (hd,tl)
1260+ (# hd,tl #) -> (hd,tl)
1486{-# INLINE span #-}
1261{-# INLINE span #-}
1488-- | /O(n)/ 'break' is like 'span', but the prefix returned is
1263-- | /O(n)/ 'break' is like 'span', but the prefix returned is
1489-- over elements that fail the predicate @p@.
1264-- over elements that fail the predicate @p@.
1490break :: (Char -> Bool) -> Text -> (Text, Text)
1265break :: (Char -> Bool) -> Text -> (Text, Text)
1491−break = coerce JSS.break
1492−-- break p = span (not . p)
1266+break p = span (not . p)
1493{-# INLINE break #-}
1267{-# INLINE break #-}
1495-- | /O(n)/ Group characters in a string according to a predicate.
1269-- | /O(n)/ Group characters in a string according to a predicate.
1496groupBy :: (Char -> Char -> Bool) -> Text -> [Text]
1270groupBy :: (Char -> Char -> Bool) -> Text -> [Text]
1497−groupBy = coerce JSS.groupBy
1498−-- groupBy p = loop
1271+groupBy p = loop
1500−-- loop t@(Text arr off len)
1273+ loop t@(Text arr off len)
1501−-- | null t = []
1274+ | null t = []
1502−-- | otherwise = text arr off n : loop (text arr (off+n) (len-n))
1275+ | otherwise = text arr off n : loop (text arr (off+n) (len-n))
1503−-- where Iter c d = iter t 0
1276+ where Iter c d = iter t 0
1504−-- n = d + findAIndexOrEnd (not . p c) (Text arr (off+d) (len-d))
1277+ n = d + findAIndexOrEnd (not . p c) (Text arr (off+d) (len-d))
1506-- | Returns the /array/ index (in units of 'Word16') at which a
1279-- | Returns the /array/ index (in units of 'Word16') at which a
1507-- character may be found. This is /not/ the same as the logical
1280-- character may be found. This is /not/ the same as the logical
1508-- index returned by e.g. 'findIndex'.
1281-- index returned by e.g. 'findIndex'.
1509−-- findAIndexOrEnd :: (Char -> Bool) -> Text -> Int
1282+findAIndexOrEnd :: (Char -> Bool) -> Text -> Int
1510−-- findAIndexOrEnd q t@(Text _arr _off len) = go 0
1283+findAIndexOrEnd q t@(Text _arr _off len) = go 0
1511−-- where go !i | i >= len || q c = i
1284+ where go !i | i >= len || q c = i
1512−-- | otherwise = go (i+d)
1285+ | otherwise = go (i+d)
1513−-- where Iter c d = iter t i
1286+ where Iter c d = iter t i
1515-- | /O(n)/ Group characters in a string by equality.
1288-- | /O(n)/ Group characters in a string by equality.
1516group :: Text -> [Text]
1289group :: Text -> [Text]
@@ -1519,17 +1292,15 @@ group = groupBy (==)
1519-- | /O(n)/ Return all initial segments of the given 'Text', shortest
1292-- | /O(n)/ Return all initial segments of the given 'Text', shortest
1520-- first.
1293-- first.
1521inits :: Text -> [Text]
1294inits :: Text -> [Text]
1522−inits = coerce JSS.inits
1523−-- inits t@(Text arr off len) = loop 0
1295+inits t@(Text arr off len) = loop 0
1524−-- where loop i | i >= len = [t]
1296+ where loop i | i >= len = [t]
1525−-- | otherwise = Text arr off i : loop (i + iter_ t i)
1297+ | otherwise = Text arr off i : loop (i + iter_ t i)
1527-- | /O(n)/ Return all final segments of the given 'Text', longest
1299-- | /O(n)/ Return all final segments of the given 'Text', longest
1528-- first.
1300-- first.
1529tails :: Text -> [Text]
1301tails :: Text -> [Text]
1530−tails = coerce JSS.tails
1531−-- tails t | null t = [empty]
1302+tails t | null t = [empty]
1532−-- | otherwise = t : tails (unsafeTail t)
1303+ | otherwise = t : tails (unsafeTail t)
1534-- $split
1305-- $split
@@ -1543,14 +1314,9 @@ tails = coerce JSS.tails
1544-- Examples:
1315-- Examples:
1546−-- >>> splitOn "\r\n" "a\r\nb\r\nd\r\ne"
1317+-- > splitOn "\r\n" "a\r\nb\r\nd\r\ne" == ["a","b","d","e"]
1547−-- ["a","b","d","e"]
1549−-- >>> splitOn "aaa" "aaaXaaaXaaaXaaa"
1318+-- > splitOn "aaa" "aaaXaaaXaaaXaaa" == ["","X","X","X",""]
1550−-- ["","X","X","X",""]
1552−-- >>> splitOn "x" "x"
1319+-- > splitOn "x" "x" == ["",""]
@@ -1567,14 +1333,13 @@ splitOn :: Text
1568 -- ^ Input text.
1334 -- ^ Input text.
1569 -> [Text]
1335 -> [Text]
1570−splitOn = coerce JSS.splitOn
1571−-- splitOn pat@(Text _ _ l) src@(Text arr off len)
1336+splitOn pat@(Text _ _ l) src@(Text arr off len)
1572−-- | l <= 0 = emptyError "splitOn"
1337+ | l <= 0 = emptyError "splitOn"
1573−-- | isSingleton pat = split (== unsafeHead pat) src
1338+ | isSingleton pat = split (== unsafeHead pat) src
1574−-- | otherwise = go 0 (indices pat src)
1339+ | otherwise = go 0 (indices pat src)
1576−-- go !s (x:xs) = text arr (s+off) (x-s) : go (x+l) xs
1341+ go !s (x:xs) = text arr (s+off) (x-s) : go (x+l) xs
1577−-- go s _ = [text arr (s+off) (len-s)]
1342+ go s _ = [text arr (s+off) (len-s)]
1578{-# INLINE [1] splitOn #-}
1343{-# INLINE [1] splitOn #-}
1580{-# RULES
1345{-# RULES
@@ -1587,36 +1352,28 @@ splitOn = coerce JSS.splitOn
1587-- resulting components do not contain the separators. Two adjacent
1352-- resulting components do not contain the separators. Two adjacent
1588-- separators result in an empty component in the output. eg.
1353-- separators result in an empty component in the output. eg.
1590−-- >>> split (=='a') "aabbaca"
1355+-- > split (=='a') "aabbaca" == ["","","bb","c",""]
1591−-- ["","","bb","c",""]
1593−-- >>> split (=='a') ""
1356+-- > split (=='a') "" == [""]
1595split :: (Char -> Bool) -> Text -> [Text]
1357split :: (Char -> Bool) -> Text -> [Text]
1596−split = coerce JSS.split
1597−-- split _ t@(Text _off _arr 0) = [t]
1358+split _ t@(Text _off _arr 0) = [t]
1598−-- split p t = loop t
1359+split p t = loop t
1599−-- where loop s | null s' = [l]
1360+ where loop s | null s' = [l]
1600−-- | otherwise = l : loop (unsafeTail s')
1361+ | otherwise = l : loop (unsafeTail s')
1601−-- where (# l, s' #) = span_ (not . p) s
1362+ where (# l, s' #) = span_ (not . p) s
1602{-# INLINE split #-}
1363{-# INLINE split #-}
1604-- | /O(n)/ Splits a 'Text' into components of length @k@. The last
1365-- | /O(n)/ Splits a 'Text' into components of length @k@. The last
1605-- element may be shorter than the other chunks, depending on the
1366-- element may be shorter than the other chunks, depending on the
1606-- length of the input. Examples:
1367-- length of the input. Examples:
1608−-- >>> chunksOf 3 "foobarbaz"
1369+-- > chunksOf 3 "foobarbaz" == ["foo","bar","baz"]
1609−-- ["foo","bar","baz"]
1611−-- >>> chunksOf 4 "haskell.org"
1370+-- > chunksOf 4 "haskell.org" == ["hask","ell.","org"]
1612−-- ["hask","ell.","org"]
1613chunksOf :: Int -> Text -> [Text]
1371chunksOf :: Int -> Text -> [Text]
1614−chunksOf = coerce JSS.chunksOf
1372+chunksOf k = go
1617−-- go t = case splitAt k t of
1374+ go t = case splitAt k t of
1618−-- (a,b) | null a -> []
1375+ (a,b) | null a -> []
1619−-- | otherwise -> a : go b
1376+ | otherwise -> a : go b
1620{-# INLINE chunksOf #-}
1377{-# INLINE chunksOf #-}
1622-- ----------------------------------------------------------------------------
1379-- ----------------------------------------------------------------------------
@@ -1629,8 +1386,7 @@ chunksOf = coerce JSS.chunksOf
1629-- returns the first element matching the predicate, or 'Nothing' if
1386-- returns the first element matching the predicate, or 'Nothing' if
1630-- there is no such element.
1387-- there is no such element.
1631find :: (Char -> Bool) -> Text -> Maybe Char
1388find :: (Char -> Bool) -> Text -> Maybe Char
1632−find = coerce JSS.find
1633−-- find p t = S.findBy p (stream t)
1389+find p t = S.findBy p (stream t)
1634{-# INLINE find #-}
1390{-# INLINE find #-}
1636-- | /O(n)/ The 'partition' function takes a predicate and a 'Text',
1392-- | /O(n)/ The 'partition' function takes a predicate and a 'Text',
@@ -1639,16 +1395,14 @@ find = coerce JSS.find
1640-- > partition p t == (filter p t, filter (not . p) t)
1396-- > partition p t == (filter p t, filter (not . p) t)
1641partition :: (Char -> Bool) -> Text -> (Text, Text)
1397partition :: (Char -> Bool) -> Text -> (Text, Text)
1642−partition = coerce JSS.partition
1643−-- partition p t = (filter p t, filter (not . p) t)
1398+partition p t = (filter p t, filter (not . p) t)
1644{-# INLINE partition #-}
1399{-# INLINE partition #-}
1646-- | /O(n)/ 'filter', applied to a predicate and a 'Text',
1401-- | /O(n)/ 'filter', applied to a predicate and a 'Text',
1647-- returns a 'Text' containing those characters that satisfy the
1402-- returns a 'Text' containing those characters that satisfy the
1648-- predicate.
1403-- predicate.
1649filter :: (Char -> Bool) -> Text -> Text
1404filter :: (Char -> Bool) -> Text -> Text
1650−filter = coerce JSS.filter
1651−-- filter p t = unstream (S.filter p (stream t))
1405+filter p t = unstream (S.filter p (stream t))
1652{-# INLINE filter #-}
1406{-# INLINE filter #-}
1654-- | /O(n+m)/ Find the first instance of @needle@ (which must be
1408-- | /O(n+m)/ Find the first instance of @needle@ (which must be
@@ -1658,11 +1412,8 @@ filter = coerce JSS.filter
1659-- Examples:
1413-- Examples:
1661−-- >>> breakOn "::" "a::b::c"
1415+-- > breakOn "::" "a::b::c" ==> ("a", "::b::c")
1664−-- >>> breakOn "/" "foobar"
1416+-- > breakOn "/" "foobar" ==> ("foobar", "")
@@ -1676,12 +1427,11 @@ filter = coerce JSS.filter
1676-- In (unlikely) bad cases, this function's time complexity degrades
1427-- In (unlikely) bad cases, this function's time complexity degrades
1677-- towards /O(n*m)/.
1428-- towards /O(n*m)/.
1678breakOn :: Text -> Text -> (Text, Text)
1429breakOn :: Text -> Text -> (Text, Text)
1679−breakOn = coerce JSS.breakOn
1680−-- breakOn pat src@(Text arr off len)
1430+breakOn pat src@(Text arr off len)
1681−-- | null pat = emptyError "breakOn"
1431+ | null pat = emptyError "breakOn"
1682−-- | otherwise = case indices pat src of
1432+ | otherwise = case indices pat src of
1683−-- [] -> (src, empty)
1433+ [] -> (src, empty)
1684−-- (x:_) -> (text arr off x, text arr (off+x) (len-x))
1434+ (x:_) -> (text arr off x, text arr (off+x) (len-x))
1685{-# INLINE breakOn #-}
1435{-# INLINE breakOn #-}
1687-- | /O(n+m)/ Similar to 'breakOn', but searches from the end of the
1437-- | /O(n+m)/ Similar to 'breakOn', but searches from the end of the
@@ -1691,12 +1441,10 @@ breakOn = coerce JSS.breakOn
1691-- up to and including the last match of @needle@. The second is the
1441-- up to and including the last match of @needle@. The second is the
1692-- remainder of @haystack@, following the match.
1442-- remainder of @haystack@, following the match.
1694−-- >>> breakOnEnd "::" "a::b::c"
1444+-- > breakOnEnd "::" "a::b::c" ==> ("a::b::", "c")
1696breakOnEnd :: Text -> Text -> (Text, Text)
1445breakOnEnd :: Text -> Text -> (Text, Text)
1697−breakOnEnd = coerce JSS.breakOnEnd
1698−-- breakOnEnd pat src = (reverse b, reverse a)
1446+breakOnEnd pat src = (reverse b, reverse a)
1699−-- where (a,b) = breakOn (reverse pat) (reverse src)
1447+ where (a,b) = breakOn (reverse pat) (reverse src)
1700{-# INLINE breakOnEnd #-}
1448{-# INLINE breakOnEnd #-}
1702-- | /O(n+m)/ Find all non-overlapping instances of @needle@ in
1450-- | /O(n+m)/ Find all non-overlapping instances of @needle@ in
@@ -1708,11 +1456,10 @@ breakOnEnd = coerce JSS.breakOnEnd
1709-- Examples:
1457-- Examples:
1711−-- >>> breakOnAll "::" ""
1459+-- > breakOnAll "::" ""
1712−-- []
1460+-- > ==> []
1714−-- >>> breakOnAll "/" "a/b/c/"
1461+-- > breakOnAll "/" "a/b/c/"
1715−-- [("a","/b/c/"),("a/b","/c/"),("a/b/c","/")]
1462+-- > ==> [("a", "/b/c/"), ("a/b", "/c/"), ("a/b/c", "/")]
1717-- In (unlikely) bad cases, this function's time complexity degrades
1464-- In (unlikely) bad cases, this function's time complexity degrades
1718-- towards /O(n*m)/.
1465-- towards /O(n*m)/.
@@ -1721,13 +1468,12 @@ breakOnEnd = coerce JSS.breakOnEnd
1721breakOnAll :: Text -- ^ @needle@ to search for
1468breakOnAll :: Text -- ^ @needle@ to search for
1722 -> Text -- ^ @haystack@ in which to search
1469 -> Text -- ^ @haystack@ in which to search
1723 -> [(Text, Text)]
1470 -> [(Text, Text)]
1724−breakOnAll = coerce JSS.breakOnAll
1725−-- breakOnAll pat src@(Text arr off slen)
1471+breakOnAll pat src@(Text arr off slen)
1726−-- | null pat = emptyError "breakOnAll"
1472+ | null pat = emptyError "breakOnAll"
1727−-- | otherwise = L.map step (indices pat src)
1473+ | otherwise = L.map step (indices pat src)
1729−-- step x = (chunk 0 x, chunk x (slen-x))
1475+ step x = (chunk 0 x, chunk x (slen-x))
1730−-- chunk !n !l = text arr (n+off) l
1476+ chunk !n !l = text arr (n+off) l
1731{-# INLINE breakOnAll #-}
1477{-# INLINE breakOnAll #-}
1733-------------------------------------------------------------------------------
1479-------------------------------------------------------------------------------
@@ -1751,16 +1497,14 @@ breakOnAll = coerce JSS.breakOnAll
1752-- | /O(n)/ 'Text' index (subscript) operator, starting from 0.
1498-- | /O(n)/ 'Text' index (subscript) operator, starting from 0.
1753index :: Text -> Int -> Char
1499index :: Text -> Int -> Char
1754−index = coerce JSS.index
1755−-- index t n = S.index (stream t) n
1500+index t n = S.index (stream t) n
1756{-# INLINE index #-}
1501{-# INLINE index #-}
1758-- | /O(n)/ The 'findIndex' function takes a predicate and a 'Text'
1503-- | /O(n)/ The 'findIndex' function takes a predicate and a 'Text'
1759-- and returns the index of the first element in the 'Text' satisfying
1504-- and returns the index of the first element in the 'Text' satisfying
1760-- the predicate. Subject to fusion.
1505-- the predicate. Subject to fusion.
1761findIndex :: (Char -> Bool) -> Text -> Maybe Int
1506findIndex :: (Char -> Bool) -> Text -> Maybe Int
1762−findIndex = coerce JSS.findIndex
1763−-- findIndex p t = S.findIndex p (stream t)
1507+findIndex p t = S.findIndex p (stream t)
1764{-# INLINE findIndex #-}
1508{-# INLINE findIndex #-}
1766-- | /O(n+m)/ The 'count' function returns the number of times the
1510-- | /O(n+m)/ The 'count' function returns the number of times the
@@ -1770,11 +1514,10 @@ findIndex = coerce JSS.findIndex
1770-- In (unlikely) bad cases, this function's time complexity degrades
1514-- In (unlikely) bad cases, this function's time complexity degrades
1771-- towards /O(n*m)/.
1515-- towards /O(n*m)/.
1772count :: Text -> Text -> Int
1516count :: Text -> Text -> Int
1773−count = coerce JSS.count
1774−-- count pat src
1517+count pat src
1775−-- | null pat = emptyError "count"
1518+ | null pat = emptyError "count"
1776−-- | isSingleton pat = countChar (unsafeHead pat) src
1519+ | isSingleton pat = countChar (unsafeHead pat) src
1777−-- | otherwise = L.length (indices pat src)
1520+ | otherwise = L.length (indices pat src)
1778{-# INLINE [1] count #-}
1521{-# INLINE [1] count #-}
1780{-# RULES
1523{-# RULES
@@ -1796,46 +1539,42 @@ countChar c t = S.countChar c (stream t)
1796-- excess elements of the longer 'Text' are discarded. This is
1539-- excess elements of the longer 'Text' are discarded. This is
1797-- equivalent to a pair of 'unpack' operations.
1540-- equivalent to a pair of 'unpack' operations.
1798zip :: Text -> Text -> [(Char,Char)]
1541zip :: Text -> Text -> [(Char,Char)]
1799−zip = coerce JSS.zip
1800−-- zip a b = S.unstreamList $ S.zipWith (,) (stream a) (stream b)
1542+zip a b = S.unstreamList $ S.zipWith (,) (stream a) (stream b)
1801{-# INLINE zip #-}
1543{-# INLINE zip #-}
1803-- | /O(n)/ 'zipWith' generalises 'zip' by zipping with the function
1545-- | /O(n)/ 'zipWith' generalises 'zip' by zipping with the function
1804-- given as the first argument, instead of a tupling function.
1546-- given as the first argument, instead of a tupling function.
1805-- Performs replacement on invalid scalar values.
1547-- Performs replacement on invalid scalar values.
1806zipWith :: (Char -> Char -> Char) -> Text -> Text -> Text
1548zipWith :: (Char -> Char -> Char) -> Text -> Text -> Text
1807−zipWith = coerce JSS.zipWith
1808−-- zipWith f t1 t2 = unstream (S.zipWith g (stream t1) (stream t2))
1549+zipWith f t1 t2 = unstream (S.zipWith g (stream t1) (stream t2))
1809−-- where g a b = safe (f a b)
1550+ where g a b = safe (f a b)
1810{-# INLINE zipWith #-}
1551{-# INLINE zipWith #-}
1812-- | /O(n)/ Breaks a 'Text' up into a list of words, delimited by 'Char's
1553-- | /O(n)/ Breaks a 'Text' up into a list of words, delimited by 'Char's
1813-- representing white space.
1554-- representing white space.
1814words :: Text -> [Text]
1555words :: Text -> [Text]
1815−words = coerce JSS.words
1816−-- words t@(Text arr off len) = loop 0 0
1556+words t@(Text arr off len) = loop 0 0
1818−-- loop !start !n
1558+ loop !start !n
1819−-- | n >= len = if start == n
1559+ | n >= len = if start == n
1820−-- then []
1560+ then []
1821−-- else [Text arr (start+off) (n-start)]
1561+ else [Text arr (start+off) (n-start)]
1822−-- | isSpace c =
1562+ | isSpace c =
1823−-- if start == n
1563+ if start == n
1824−-- then loop (start+1) (start+1)
1564+ then loop (start+1) (start+1)
1825−-- else Text arr (start+off) (n-start) : loop (n+d) (n+d)
1565+ else Text arr (start+off) (n-start) : loop (n+d) (n+d)
1826−-- | otherwise = loop start (n+d)
1566+ | otherwise = loop start (n+d)
1827−-- where Iter c d = iter t n
1567+ where Iter c d = iter t n
1828{-# INLINE words #-}
1568{-# INLINE words #-}
1830-- | /O(n)/ Breaks a 'Text' up into a list of 'Text's at
1570-- | /O(n)/ Breaks a 'Text' up into a list of 'Text's at
1831-- newline 'Char's. The resulting strings do not contain newlines.
1571-- newline 'Char's. The resulting strings do not contain newlines.
1832lines :: Text -> [Text]
1572lines :: Text -> [Text]
1833−lines = coerce JSS.lines
1834−-- lines ps | null ps = []
1573+lines ps | null ps = []
1835−-- | otherwise = h : if null t
1574+ | otherwise = h : if null t
1836−-- then []
1575+ then []
1837−-- else lines (unsafeTail t)
1576+ else lines (unsafeTail t)
1838−-- where (# h,t #) = span_ (/= '\n') ps
1577+ where (# h,t #) = span_ (/= '\n') ps
1839{-# INLINE lines #-}
1578{-# INLINE lines #-}
@@ -1863,40 +1602,34 @@ lines' ps | null ps = []
1863-- | /O(n)/ Joins lines, after appending a terminating newline to
1602-- | /O(n)/ Joins lines, after appending a terminating newline to
1865unlines :: [Text] -> Text
1604unlines :: [Text] -> Text
1866−unlines = coerce JSS.unlines
1867−-- unlines = concat . L.map (`snoc` '\n')
1605+unlines = concat . L.map (`snoc` '\n')
1868{-# INLINE unlines #-}
1606{-# INLINE unlines #-}
1870-- | /O(n)/ Joins words using single space characters.
1608-- | /O(n)/ Joins words using single space characters.
1871unwords :: [Text] -> Text
1609unwords :: [Text] -> Text
1872−unwords = coerce JSS.unwords
1873−-- unwords = intercalate (singleton ' ')
1610+unwords = intercalate (singleton ' ')
1874{-# INLINE unwords #-}
1611{-# INLINE unwords #-}
1876-- | /O(n)/ The 'isPrefixOf' function takes two 'Text's and returns
1613-- | /O(n)/ The 'isPrefixOf' function takes two 'Text's and returns
1877-- 'True' iff the first is a prefix of the second. Subject to fusion.
1614-- 'True' iff the first is a prefix of the second. Subject to fusion.
1878isPrefixOf :: Text -> Text -> Bool
1615isPrefixOf :: Text -> Text -> Bool
1879−isPrefixOf = coerce JSS.isPrefixOf
1880−-- isPrefixOf a@(Text _ _ alen) b@(Text _ _ blen) =
1616+isPrefixOf a@(Text _ _ alen) b@(Text _ _ blen) =
1881−-- alen <= blen && S.isPrefixOf (stream a) (stream b)
1617+ alen <= blen && S.isPrefixOf (stream a) (stream b)
1882{-# INLINE [1] isPrefixOf #-}
1618{-# INLINE [1] isPrefixOf #-}
1884{-# RULES
1620{-# RULES
1885"TEXT isPrefixOf -> fused" [~1] forall s t.
1621"TEXT isPrefixOf -> fused" [~1] forall s t.
1886 isPrefixOf s t = S.isPrefixOf (stream s) (stream t)
1622 isPrefixOf s t = S.isPrefixOf (stream s) (stream t)
1887−"JSSTRING isPrefixOf -> unfused" [1] forall x y.
1888− S.isPrefixOf (stream x) (stream y) = isPrefixOf x y
1891-- | /O(n)/ The 'isSuffixOf' function takes two 'Text's and returns
1625-- | /O(n)/ The 'isSuffixOf' function takes two 'Text's and returns
1892-- 'True' iff the first is a suffix of the second.
1626-- 'True' iff the first is a suffix of the second.
1893isSuffixOf :: Text -> Text -> Bool
1627isSuffixOf :: Text -> Text -> Bool
1894−isSuffixOf = coerce JSS.isSuffixOf
1895−-- isSuffixOf a@(Text _aarr _aoff alen) b@(Text barr boff blen) =
1628+isSuffixOf a@(Text _aarr _aoff alen) b@(Text barr boff blen) =
1896−-- d >= 0 && a == b'
1629+ d >= 0 && a == b'
1897−-- where d = blen - alen
1630+ where d = blen - alen
1898−-- b' | d == 0 = b
1631+ b' | d == 0 = b
1899−-- | otherwise = Text barr (boff+d) alen
1632+ | otherwise = Text barr (boff+d) alen
1900{-# INLINE isSuffixOf #-}
1633{-# INLINE isSuffixOf #-}
1902-- | /O(n+m)/ The 'isInfixOf' function takes two 'Text's and returns
1635-- | /O(n+m)/ The 'isInfixOf' function takes two 'Text's and returns
@@ -1906,11 +1639,10 @@ isSuffixOf = coerce JSS.isSuffixOf
1906-- In (unlikely) bad cases, this function's time complexity degrades
1639-- In (unlikely) bad cases, this function's time complexity degrades
1907-- towards /O(n*m)/.
1640-- towards /O(n*m)/.
1908isInfixOf :: Text -> Text -> Bool
1641isInfixOf :: Text -> Text -> Bool
1909−isInfixOf = coerce JSS.isInfixOf
1910−-- isInfixOf needle haystack
1642+isInfixOf needle haystack
1911−-- | null needle = True
1643+ | null needle = True
1912−-- | isSingleton needle = S.elem (unsafeHead needle) . S.stream $ haystack
1644+ | isSingleton needle = S.elem (unsafeHead needle) . S.stream $ haystack
1913−-- | otherwise = not . L.null . indices needle $ haystack
1645+ | otherwise = not . L.null . indices needle $ haystack
1914{-# INLINE [1] isInfixOf #-}
1646{-# INLINE [1] isInfixOf #-}
1916{-# RULES
1648{-# RULES
@@ -1926,14 +1658,9 @@ isInfixOf = coerce JSS.isInfixOf
1927-- Examples:
1659-- Examples:
1929−-- >>> stripPrefix "foo" "foobar"
1661+-- > stripPrefix "foo" "foobar" == Just "bar"
1932−-- >>> stripPrefix "" "baz"
1662+-- > stripPrefix "" "baz" == Just "baz"
1935−-- >>> stripPrefix "foo" "quux"
1663+-- > stripPrefix "foo" "quux" == Nothing
1938-- This is particularly useful with the @ViewPatterns@ extension to
1665-- This is particularly useful with the @ViewPatterns@ extension to
1939-- GHC, as follows:
1666-- GHC, as follows:
@@ -1945,10 +1672,9 @@ isInfixOf = coerce JSS.isInfixOf
1945-- > fnordLength (stripPrefix "fnord" -> Just suf) = T.length suf
1672-- > fnordLength (stripPrefix "fnord" -> Just suf) = T.length suf
1946-- > fnordLength _ = -1
1673-- > fnordLength _ = -1
1947stripPrefix :: Text -> Text -> Maybe Text
1674stripPrefix :: Text -> Text -> Maybe Text
1948−stripPrefix = coerce JSS.stripPrefix
1949−-- stripPrefix p@(Text _arr _off plen) t@(Text arr off len)
1675+stripPrefix p@(Text _arr _off plen) t@(Text arr off len)
1950−-- | p `isPrefixOf` t = Just $! text arr (off+plen) (len-plen)
1676+ | p `isPrefixOf` t = Just $! text arr (off+plen) (len-plen)
1951−-- | otherwise = Nothing
1677+ | otherwise = Nothing
1953-- | /O(n)/ Find the longest non-empty common prefix of two strings
1679-- | /O(n)/ Find the longest non-empty common prefix of two strings
1954-- and return it, along with the suffixes of each string at which they
1680-- and return it, along with the suffixes of each string at which they
@@ -1959,39 +1685,28 @@ stripPrefix = coerce JSS.stripPrefix
1960-- Examples:
1686-- Examples:
1962−-- >>> commonPrefixes "foobar" "fooquux"
1688+-- > commonPrefixes "foobar" "fooquux" == Just ("foo","bar","quux")
1963−-- Just ("foo","bar","quux")
1965−-- >>> commonPrefixes "veeble" "fetzer"
1689+-- > commonPrefixes "veeble" "fetzer" == Nothing
1968−-- >>> commonPrefixes "" "baz"
1690+-- > commonPrefixes "" "baz" == Nothing
1970commonPrefixes :: Text -> Text -> Maybe (Text,Text,Text)
1691commonPrefixes :: Text -> Text -> Maybe (Text,Text,Text)
1971−commonPrefixes = coerce JSS.commonPrefixes
1972−-- commonPrefixes t0@(Text arr0 off0 len0) t1@(Text arr1 off1 len1) = go 0 0
1692+commonPrefixes t0@(Text arr0 off0 len0) t1@(Text arr1 off1 len1) = go 0 0
1974−-- go !i !j | i < len0 && j < len1 && a == b = go (i+d0) (j+d1)
1694+ go !i !j | i < len0 && j < len1 && a == b = go (i+d0) (j+d1)
1975−-- | i > 0 = Just (Text arr0 off0 i,
1695+ | i > 0 = Just (Text arr0 off0 i,
1976−-- text arr0 (off0+i) (len0-i),
1696+ text arr0 (off0+i) (len0-i),
1977−-- text arr1 (off1+j) (len1-j))
1697+ text arr1 (off1+j) (len1-j))
1978−-- | otherwise = Nothing
1698+ | otherwise = Nothing
1979−-- where Iter a d0 = iter t0 i
1699+ where Iter a d0 = iter t0 i
1980−-- Iter b d1 = iter t1 j
1700+ Iter b d1 = iter t1 j
1982-- | /O(n)/ Return the prefix of the second string if its suffix
1702-- | /O(n)/ Return the prefix of the second string if its suffix
1983-- matches the entire first string.
1703-- matches the entire first string.
1985-- Examples:
1705-- Examples:
1987−-- >>> stripSuffix "bar" "foobar"
1707+-- > stripSuffix "bar" "foobar" == Just "foo"
1990−-- >>> stripSuffix "" "baz"
1708+-- > stripSuffix "" "baz" == Just "baz"
1993−-- >>> stripSuffix "foo" "quux"
1709+-- > stripSuffix "foo" "quux" == Nothing
1996-- This is particularly useful with the @ViewPatterns@ extension to
1711-- This is particularly useful with the @ViewPatterns@ extension to
1997-- GHC, as follows:
1712-- GHC, as follows:
@@ -2003,22 +1718,21 @@ commonPrefixes = coerce JSS.commonPrefixes
2003-- > quuxLength (stripSuffix "quux" -> Just pre) = T.length pre
1718-- > quuxLength (stripSuffix "quux" -> Just pre) = T.length pre
2004-- > quuxLength _ = -1
1719-- > quuxLength _ = -1
2005stripSuffix :: Text -> Text -> Maybe Text
1720stripSuffix :: Text -> Text -> Maybe Text
2006−stripSuffix = coerce JSS.stripSuffix
2007−-- stripSuffix p@(Text _arr _off plen) t@(Text arr off len)
1721+stripSuffix p@(Text _arr _off plen) t@(Text arr off len)
2008−-- | p `isSuffixOf` t = Just $! text arr off (len-plen)
1722+ | p `isSuffixOf` t = Just $! text arr off (len-plen)
2009−-- | otherwise = Nothing
1723+ | otherwise = Nothing
2011−-- -- | Add a list of non-negative numbers. Errors out on overflow.
1725+-- | Add a list of non-negative numbers. Errors out on overflow.
2012−-- sumP :: String -> [Int] -> Int
1726+sumP :: String -> [Int] -> Int
2013−-- sumP fun = go 0
1727+sumP fun = go 0
2014−-- where go !a (x:xs)
1728+ where go !a (x:xs)
2015−-- | ax >= 0 = go ax xs
1729+ | ax >= 0 = go ax xs
2016−-- | otherwise = overflowError fun
1730+ | otherwise = overflowError fun
2017−-- where ax = a + x
1731+ where ax = a + x
2018−-- go a _ = a
1732+ go a _ = a
2020−-- emptyError :: String -> a
1734+emptyError :: String -> a
2021−-- emptyError fun = P.error $ "Data.Text." ++ fun ++ ": empty input"
1735+emptyError fun = P.error $ "Data.Text." ++ fun ++ ": empty input"
2023overflowError :: String -> a
1737overflowError :: String -> a
2024overflowError fun = P.error $ "Data.Text." ++ fun ++ ": size overflow"
1738overflowError fun = P.error $ "Data.Text." ++ fun ++ ": size overflow"
@@ -2032,22 +1746,10 @@ overflowError fun = P.error $ "Data.Text." ++ fun ++ ": size overflow"
2032-- copy \"breaks the link\" to the original array, allowing it to be
1746-- copy \"breaks the link\" to the original array, allowing it to be
2033-- garbage collected if there are no other live references to it.
1747-- garbage collected if there are no other live references to it.
2034copy :: Text -> Text
1748copy :: Text -> Text
2036−-- copy (Text arr off len) = Text (A.run go) 0 len
1749+copy (Text arr off len) = Text (A.run go) 0 len
2038−-- go :: ST s (A.MArray s)
1751+ go :: ST s (A.MArray s)
2039−-- go = do
1752+ go = do
2040−-- marr <- A.new len
1753+ marr <- A.new len
2041−
1754+ A.copyI marr 0 arr off len
2042−foreign import javascript unsafe
1755+ return marr
2043− "h$jsstringReplicateChar" js_replicateChar :: Int -> Char -> JSString
2044−foreign import javascript unsafe
2045− "$2.substr($1)" js_substr1 :: Int -> JSString -> JSString
2047−-------------------------------------------------
2048−-- NOTE: the named chunk below used by doctest;
2049−-- verify the doctests via `doctest -fobject-code Data/Text.hs`
2052−-- >>> :set -XOverloadedStrings
2053−-- >>> import qualified Data.Text as T