;       !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~                                  ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~                                                                                                                                 ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~                                                                                                                        ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w xyz{|}~      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~      non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au> portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au> Box monad Identity monad  GDelay inlining a function until late in the game (simplifier phase 0). ! inlined in phase 0      portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>  Size hint  Unknown size Upper bound on the size  Exact size Minimum of two size hints Maximum of two size hints &Convert a size hint to an upper bound "*Compute the minimum size from a size hint 6Compute the maximum size from a size hint if possible       non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>#$%&'()    non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>~*+,- Monadic streams !"+Result of taking a single step in a stream #end of stream $just a new seed %a new element and a new seed ./0&  hint of a !  ' Attach a   hint to a !  ( Length of a !  ) Check if a !  is empty *Empty !  + Singleton !  ,$Replicate a value to a given length -Yield a ! 9 of values obtained by performing the monadic action the  given number of times ./#Generate a stream from its indices 0Prepend an element 1Append an element 2Concatenate two ! s 3First element of the !  or error if empty 4Last element of the !  or error if empty 5Element at the given position 6HExtract a substream of the given length starting at the given position. starting index length 7All but the last element 8All but the first element 9 The first n elements :All but the first n elements ;Map a function over a !  <Map a monadic function over a !  1=1Execute a monadic action for each element of the !  > Transform a !  to use a different monad ?@Pair each element in a !  with its index APair each element in a ! ) with its index, starting from the right  and counting down BZip two ! "s with the given monadic function CDEFGHIJKLMNOPQR1Drop elements which do not satisfy the predicate S9Drop elements which do not satisfy the monadic predicate T6Longest prefix of elements that satisfy the predicate U>Longest prefix of elements that satisfy the monadic predicate V?Drop the longest prefix of elements that satisfy the predicate WGDrop the longest prefix of elements that satisfy the monadic predicate XCheck whether the !  contains an element Y Inverse of X ZYield 23 the first element that satisfies the predicate or 3  if no such element exists. [Yield 2; the first element that satisfies the monadic predicate or  3 if no such element exists. \Yield 2= the index of the first element that satisfies the predicate  or 3 if no such element exists. ]Yield 2; the index of the first element that satisfies the monadic  predicate or 3 if no such element exists. ^ Left fold _"Left fold with a monadic operator `Same as _ aLeft fold over a non-empty !  bLeft fold over a non-empty !  with a monadic operator cSame as b d$Left fold with a strict accumulator e;Left fold with a strict accumulator and a monadic operator fSame as e gLeft fold over a non-empty !  with a strict accumulator hLeft fold over a non-empty ! ! with a strict accumulator and a  monadic operator iSame as h j Right fold k#Right fold with a monadic operator l#Right fold over a non-empty stream m;Right fold over a non-empty stream with a monadic operator nopqr Create a !  of values from a !  of streamable things sUnfold tUnfold with a monadic function uUnfold at most n elements vUnfold at most n# elements with a monadic functions wKApply monadic function n times to value. Zeroth element is original value. xCApply function n times to value. Zeroth element is original value. y Prefix scan z$Prefix scan with a monadic operator {$Prefix scan with strict accumulator |;Prefix scan with strict accumulator and a monadic operator } Suffix scan ~$Suffix scan with a monadic operator $Suffix scan with strict accumulator <Suffix scan with strict acccumulator and a monadic operator Haskell-style scan +Haskell-style scan with a monadic operator +Haskell-style scan with strict accumulator BHaskell-style scan with strict accumulator and a monadic operator Scan over a non-empty !  Scan over a non-empty !  with a monadic operator Scan over a non-empty !  with a strict accumulator Scan over a non-empty ! ) with a strict accumulator and a monadic  operator Yield a ! + of the given length containing the values x, x+y,  x+y+y etc. Enumerate values WARNING:A This operation can be very inefficient. If at all possible, use   instead. 456789$Enumerate values with a given step. WARNING:= This operation is very inefficient. If at all possible, use   instead.  Convert a !  to a list Convert a list to a !  Convert the first n elements of a list to a !  Convert a list to a !  with the given   hint. p !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~p !"%$#&'()*+01,-./23456789:;<=>?pr@ACBDEFGHIJKLMNOPQRSTUVWXYZ[\]^_ab`cdeghfijklmnoqstuvxwyz{|}~p !!"%$##$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>T%Alternative name for monadic streams The type of pure streams *Convert a pure stream to a monadic stream   hint of a   Attach a   hint to a   Length of a   Check if a  is empty Empty   Singleton  $Replicate a value to a given length #Generate a stream from its indices Prepend an element Append an element Concatenate two s First element of the  or error if empty Last element of the  or error if empty Element at the given position HExtract a substream of the given length starting at the given position. starting index length All but the last element All but the first element  The first n elements All but the first n elements Map a function over a  Pair each element in a  with its index Pair each element in a ) with its index, starting from the right  and counting down Zip two s with the given function  Zip three s with the given function 1Drop elements which do not satisfy the predicate 6Longest prefix of elements that satisfy the predicate ?Drop the longest prefix of elements that satisfy the predicate Check whether the  contains an element  Inverse of  Yield 2- the first element matching the predicate or 3 if no  such element exists. Yield 2: the index of the first element matching the predicate or  3 if no such element exists.  Left fold Left fold on non-empty s "Left fold with strict accumulator Left fold on non-empty s with strict accumulator  Right fold Right fold on non-empty s Unfold Unfold at most n elements EApply function n-1 times to value. Zeroth element is original value.  Prefix scan $Prefix scan with strict accumulator  Suffix scan $Suffix scan with strict accumulator Haskell-style scan +Haskell-style scan with strict accumulator Scan over a non-empty  Scan over a non-empty  with a strict accumulator  Check if two  s are equal Lexicographically compare two s JApply a monadic action to each element of the stream, producing a monadic  stream of results 5Apply a monadic action to each element of the stream FYield a monadic stream of elements that satisfy the monadic predicate  Monadic fold #Monadic fold over non-empty stream %Monadic fold with strict accumulator 9Monad fold over non-empty stream with strict accumulator Yield a + of the given length containing the values x, x+y,  x+y+y etc. Enumerate values WARNING:B This operations can be very inefficient. If at all possible, use   instead. $Enumerate values with a given step. WARNING:> This operations is very inefficient. If at all possible, use   instead.  Convert a  to a list : Create a  from a list  Create a  from the first n elements of a list ' fromListN n xs = fromList (take n xs)  Create a  of values from a  of streamable things W"#$%W"%$#S  non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>RDClass of mutable vectors parametrised with a primitive state token. 8Length of the mutable vector. This method should not be  called directly, use  instead. CYield a part of the mutable vector without copying it. This method $ should not be called directly, use  instead. starting index length of the slice GCreate a mutable vector of the given length. This method should not be  called directly, use  instead. @Create a mutable vector of the given length and fill it with an ? initial value. This method should not be called directly, use    instead. CYield the element at the given position. This method should not be  called directly, use  instead. EReplace the element at the given position. This method should not be  called directly, use  instead. GReset all elements of the vector to some undefined value, clearing all D references to external objects. This is usually a noop for unboxed 9 vectors. This method should not be called directly, use  instead. FSet all elements of the vector to the given value. This method should  not be called directly, use  instead. GCopy a vector. The two vectors may not overlap. This method should not  be called directly, use  instead. target source HMove the contents of a vector. The two vectors may overlap. This method $ should not be called directly, use  instead. target source IGrow a vector by the given number of elements. This method should not be  called directly, use   instead.  DEPRECATED in favour of  ;<=>?Create a new mutable vector and fill it with elements from the . ? The vector will grow exponentially if the maximum size of the  is  unknown. GCreate a new mutable vector and fill it with elements from the monadic N stream. The vector will grow exponentially if the maximum size of the stream  is unknown. ?@?Create a new mutable vector and fill it with elements from the  L from right to left. The vector will grow exponentially if the maximum size  of the  is unknown. GCreate a new mutable vector and fill it with elements from the monadic N stream from right to left. The vector will grow exponentially if the maximum  size of the stream is unknown. ABLength of the mutable vector. "Check whether the vector is empty 7Yield a part of the mutable vector without copying it. HYield a part of the mutable vector without copying it. No bounds checks  are performed. starting index length of the slice -Create a mutable vector of the given length. HCreate a mutable vector of the given length. The length is not checked.  JCreate a mutable vector of the given length (0 if the length is negative) $ and fill it with an initial value.  JCreate a mutable vector of the given length (0 if the length is negative) N and fill it with values produced by repeatedly executing the monadic action.  #Create a copy of a mutable vector.  BGrow a vector by the given number of elements. The number must be  positive. CDGrow a vector logarithmically E BGrow a vector by the given number of elements. The number must be # positive but this is not checked. FGReset all elements of the vector to some undefined value, clearing all N references to external objects. This is usually a noop for unboxed vectors. )Yield the element at the given position. +Replace the element at the given position. *Swap the elements at the given positions. GEReplace the element at the give position and return the old element. IYield the element at the given position. No bounds checks are performed. KReplace the element at the given position. No bounds checks are performed. JSwap the elements at the given positions. No bounds checks are performed. HHReplace the element at the give position and return the old element. No  bounds checks are performed. 3Set all elements of the vector to the given value. ECopy a vector. The two vectors must have the same length and may not  overlap. BMove the contents of a vector. The two vectors must have the same  length. :If the vectors do not overlap, then this is equivalent to . B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. ECopy a vector. The two vectors must have the same length and may not  overlap. This is not checked. target source BMove the contents of a vector. The two vectors must have the same " length, but this is not checked. :If the vectors do not overlap, then this is equivalent to . B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. target source  I!JK" DEPRECATED Use   instead # DEPRECATED Use   instead A      !"#A      !"#A       !"# non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au> $JClass of immutable vectors. Every immutable vector is associated with its  mutable version through the ,$ type family. Methods of this class ' should not be used directly. Instead, Data.Vector.Generic and other 8 Data.Vector modules provide safe and fusible wrappers. !Minimum complete implementation:  %  &  '  (  ) %Assumed complexity: O(1) ;Unsafely convert a mutable vector to its immutable version ; without copying. The mutable vector may not be used after  this operation. &Assumed complexity: O(1) DUnsafely convert an immutable vector to its mutable version without E copying. The immutable vector may not be used after this operation. 'Assumed complexity: O(1)  Yield the length of the vector. (Assumed complexity: O(1) DYield a slice of the vector without copying it. No range checks are  performed. starting index length )Assumed complexity: O(1) HYield the element at the given position in a monad. No range checks are  performed. JThe monad allows us to be strict in the vector if we want. Suppose we had   unsafeIndex :: v a -> Int -> a /instead. Now, if we wanted to copy a vector, we'd do something like  < copy mv v ... = ... unsafeWrite mv i (unsafeIndex v i) ... JFor lazy vectors, the indexing would not be evaluated which means that we K would retain a reference to the original vector in each element we write.  This is not what we want! With ) , we can do  3 copy mv v ... = ... case basicUnsafeIndexM v i of 7 Box x -> unsafeWrite mv i x ... Hwhich does not have this problem because indexing (but not the returned % element!) is evaluated immediately. *Assumed complexity: O(n) GCopy an immutable vector into a mutable one. The two vectors must have * the same length but this is not checked.  Instances of $5 should redefine this method if they wish to support $ an efficient block copy operation. %Default definition: copying basic on ) and  basicUnsafeWrite. + Evaluate a2 as far as storing it in a vector would and yield b.  The v a@ argument only fixes the type and is not touched. The method is H only used for optimisation purposes. Thus, it is safe for instances of  $ to evaluate a/ less than it would be when stored in a vector 0 although this might result in suboptimal code.  4 elemseq v x y = (singleton x `asTypeOf` v) `seq` y Default defintion: a is not evaluated at all , Mutable v s a0 is the mutable version of the pure vector type v a with  the state token s $%&'()*+, $%&'()*+%&'()*+,  non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>-./0123456789:;<=>?-./0123456789:;<=>?-./0123456789:;<=>?-../0123456789:;<=>?  non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>@O(1)! Yield the length of the vector. AO(1) Test whether a vector if empty BO(1) Indexing CO(1) Safe indexing DO(1) First element EO(1) Last element FO(1)) Unsafe indexing without bounds checking GO(1)7 First element without checking if the vector is empty HO(1)6 Last element without checking if the vector is empty IO(1) Indexing in a monad. GThe monad allows operations to be strict in the vector when necessary. 2 Suppose vector copying is implemented like this:  ( copy mv v = ... write mv i (v ! i) ... For lazy vectors, v ! i) would not be evaluated which means that mv + would unnecessarily retain a reference to v in each element written. With I0, copying can be implemented like this instead:   copy mv v = ... do # x <- indexM v i  write mv i x Here, no references to v$ are retained because indexing (but not the ! elements) is evaluated eagerly. JO(1)+ First element of a vector in a monad. See I for an $ explanation of why this is useful. KO(1)* Last element of a vector in a monad. See I for an $ explanation of why this is useful. LO(1)0 Indexing in a monad without bounds checks. See I for an $ explanation of why this is useful. MO(1)> First element in a monad without checking for empty vectors.  See I+ for an explanation of why this is useful. NO(1)= Last element in a monad without checking for empty vectors.  See I+ for an explanation of why this is useful. OO(1)A Yield a slice of the vector without copying it. The vector must  contain at least i+n elements. i starting index n length PO(1)D Yield all but the last element without copying. The vector may not  be empty. QO(1)E Yield all but the first element without copying. The vector may not  be empty. RO(1) Yield the first n* elements without copying. The vector may  contain less than n2 elements in which case it is returned unchanged. SO(1) Yield all but the first n* elements without copying. The vector may  contain less than n5 elements in which case an empty vector is returned. TO(1) Yield the first n5 elements paired with the remainder without copying.  Note that T n v is equivalent to (R n v, S n v)  but slightly more efficient. UO(1)> Yield a slice of the vector without copying. The vector must  contain at least i+n# elements but this is not checked. i starting index n length VO(1)D Yield all but the last element without copying. The vector may not # be empty but this is not checked. WO(1)E Yield all but the first element without copying. The vector may not # be empty but this is not checked. XO(1) Yield the first n+ elements without copying. The vector must  contain at least n# elements but this is not checked. YO(1) Yield all but the first n& elements without copying. The vector  must contain at least n# elements but this is not checked. ZO(1) Empty vector [O(1)! Vector with exactly one element \O(n)A Vector of the given length with the same value in each position ]O(n)D Construct a vector of the given length by applying the function to  each index ^O(n)D Apply function n times to value. Zeroth element is original value. _O(n)B Construct a vector by repeatedly applying the generator function * to a seed. The generator function yields 2 the next element and the  new seed or 3 if there are no more elements. = unfoldr (\n -> if n == 0 then Nothing else Just (n,n-1)) 10  = <10,9,8,7,6,5,4,3,2,1> `O(n)! Construct a vector with at most n by repeatedly applying the A generator function to the a seed. The generator function yields 2 the " next element and the new seed or 3 if there are no more elements. / unfoldrN 3 (\n -> Just (n,n-1)) 10 = <10,9,8> aO(n): Yield a vector of the given length containing the values x, x+1 4 etc. This operation is usually more efficient than c.  enumFromN 5 3 = <5,6,7> bO(n): Yield a vector of the given length containing the values x, x+y,  x+y+y5 etc. This operations is usually more efficient than d. - enumFromStepN 1 0.1 5 = <1,1.1,1.2,1.3,1.4> cO(n) Enumerate values from x to y. WARNING:A This operation can be very inefficient. If at all possible, use  a instead. dO(n) Enumerate values from x to y with a specific step z. WARNING:A This operation can be very inefficient. If at all possible, use  b instead. eO(n) Prepend an element fO(n) Append an element gO(m+n) Concatenate two vectors hO(n)% Concatenate all vectors in the list iO(n)D Execute the monadic action the given number of times and store the  results in a vector. jO(n)@ Construct a vector of the given length by applying the monadic  action to each index k<Execute the monadic action and freeze the resulting vector.   create (do { v <-  2;  v 0 'a';  v 1 'b' }) = <a,b> lO(n)A Yield the argument but force it not to retain any extra memory,  possibly by copying it. AThis is especially useful when dealing with slices. For example:  ! force (slice 0 2 <huge vector>) KHere, the slice retains a reference to the huge vector. Forcing it creates J a copy of just the elements that belong to the slice and allows the huge ! vector to be garbage collected. mO(m+n) For each pair (i,a)# from the list, replace the vector  element at position i by a. . <5,9,2,7> // [(2,1),(0,3),(2,8)] = <3,9,8,7> initial vector (of length m)  list of index/value pairs (of length n) nO(m+n) For each pair (i,a) from the vector of index/ value pairs, ( replace the vector element at position i by a. 2 update <5,9,2,7> <(2,1),(0,3),(2,8)> = <3,9,8,7> initial vector (of length m) vector of index/value pairs (of length n) oO(m+min(n1,n2)) For each index i from the index vector and the  corresponding value a3 from the value vector, replace the element of the  initial vector at position i by a.  0 update_ <5,9,2,7> <2,0,2> <1,3,8> = <3,9,8,7> )This function is useful for instances of $ that cannot store pairs.  Otherwise, n is probably more convenient.   update_ xs is ys = n xs ( is ys) initial vector (of length m) index vector (of length n1) value vector (of length n2) Lp Same as (m) but without bounds checking. qSame as n but without bounds checking. rSame as o but without bounds checking. MsO(m+n) For each pair (i,b)+ from the list, replace the vector element  a at position i by f a b. A accum (+) <5,9,2> [(2,4),(1,6),(0,3),(1,7)] = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m)  list of index/value pairs (of length n) tO(m+n) For each pair (i,b). from the vector of pairs, replace the vector  element a at position i by f a b. F accumulate (+) <5,9,2> <(2,4),(1,6),(0,3),(1,7)> = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m) vector of index/value pairs (of length n) uO(m+min(n1,n2)) For each index i from the index vector and the  corresponding value b from the the value vector, . replace the element of the initial vector at  position i by f a b.  A accumulate_ (+) <5,9,2> <2,1,0,1> <4,6,3,7> = <5+3, 9+6+7, 2+4> )This function is useful for instances of $ that cannot store pairs.  Otherwise, t is probably more convenient:   accumulate_ f as is bs = t f as ( is bs) accumulating function f initial vector (of length m) index vector (of length n1) value vector (of length n2) NvSame as s but without bounds checking. wSame as t but without bounds checking. xSame as u but without bounds checking. OyO(n) Reverse a vector zO(n)5 Yield the vector obtained by replacing each element i of the  index vector by xsBi. This is equivalent to ~ (xsB) is but is  often much more efficient. 5 backpermute <a,b,c,d> <0,3,2,3,1,0> = <a,d,c,d,b,a> xs value vector is index vector (of length n) {Same as z but without bounds checking. |AApply a destructive operation to a vector. The operation will be I performed in place if it is safe to do so and will modify a copy of the  vector otherwise.   modify (\v ->  v 0 'x') (\ 3 'a') = <'x','a','a'> P}O(n). Pair each element in a vector with its index ~O(n) Map a function over a vector O(n)= Apply a function to every element of a vector and its index :Map a function over a vector and concatenate the results. O(n)D Apply the monadic action to all elements of the vector, yielding a  vector of results O(n)E Apply the monadic action to all elements of a vector and ignore the  results O(n)D Apply the monadic action to all elements of the vector, yielding a ! vector of results. Equvalent to flip . O(n)E Apply the monadic action to all elements of a vector and ignore the  results. Equivalent to flip .  O(min(m,n))* Zip two vectors with the given function. +Zip three vectors with the given function.  O(min(m,n))5 Zip two vectors with a function that also takes the  elements' indices.  O(min(m,n)) Zip two vectors  O(min(m,n))9 Zip the two vectors with the monadic action and yield a  vector of results  O(min(m,n))< Zip the two vectors with the monadic action and ignore the  results  O(min(m,n)) Unzip a vector of pairs. O(n)1 Drop elements that do not satisfy the predicate O(n)E Drop elements that do not satisfy the predicate which is applied to  values and their indices O(n)9 Drop elements that do not satisfy the monadic predicate O(n)? Yield the longest prefix of elements satisfying the predicate  without copying. O(n)@ Drop the longest prefix of elements that satisfy the predicate  without copying. O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. The H relative order of the elements is preserved at the cost of a sometimes ! reduced performance compared to . QO(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. G The order of the elements is not preserved but the operation is often  faster than . RSO(n)C Split the vector into the longest prefix of elements that satisfy - the predicate and the rest without copying. O(n)B Split the vector into the longest prefix of elements that do not 5 satisfy the predicate and the rest without copying. O(n)) Check if the vector contains an element O(n)= Check if the vector does not contain an element (inverse of ) O(n) Yield 2- the first element matching the predicate or 3  if no such element exists. O(n) Yield 27 the index of the first element matching the predicate  or 3 if no such element exists. O(n)E Yield the indices of elements satisfying the predicate in ascending  order. O(n) Yield 2: the index of the first occurence of the given element or  3C if the vector does not contain the element. This is a specialised  version of . O(n)= Yield the indices of all occurences of the given element in 3 ascending order. This is a specialised version of . O(n) Left fold O(n) Left fold on non-empty vectors O(n)# Left fold with strict accumulator O(n)8 Left fold on non-empty vectors with strict accumulator O(n) Right fold O(n)! Right fold on non-empty vectors O(n)& Right fold with a strict accumulator O(n)9 Right fold on non-empty vectors with strict accumulator O(n)< Left fold (function applied to each element and its index) O(n)E Left fold with strict accumulator (function applied to each element  and its index) O(n)= Right fold (function applied to each element and its index) O(n)> Right fold with strict accumulator (function applied to each  element and its index) O(n). Check if all elements satisfy the predicate. O(n)/ Check if any element satisfies the predicate. O(n) Check if all elements are T O(n) Check if any element is T O(n)! Compute the sum of the elements O(n)% Compute the produce of the elements O(n)@ Yield the maximum element of the vector. The vector may not be  empty. O(n)@ Yield the maximum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)@ Yield the minimum element of the vector. The vector may not be  empty. O(n)@ Yield the minimum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)B Yield the index of the maximum element of the vector. The vector  may not be empty. O(n)C Yield the index of the maximum element of the vector according to = the given comparison function. The vector may not be empty. O(n)B Yield the index of the minimum element of the vector. The vector  may not be empty. O(n)C Yield the index of the minimum element of the vector according to = the given comparison function. The vector may not be empty. O(n) Monadic fold O(n)% Monadic fold over non-empty vectors O(n)& Monadic fold with strict accumulator O(n)= Monadic fold over non-empty vectors with strict accumulator UO(n)' Monadic fold that discards the result O(n)> Monadic fold over non-empty vectors that discards the result O(n)? Monadic fold with strict accumulator that discards the result O(n); Monad fold over non-empty vectors with strict accumulator  that discards the result -Evaluate each action and collect the results -Evaluate each action and discard the results O(n) Prescan    prescanl f z = P .  f z  Example: prescanl (+) 0 <1,2,3,4> = <0,1,3,6> O(n)! Prescan with strict accumulator O(n) Scan    postscanl f z = Q .  f z  Example: postscanl (+) 0 <1,2,3,4> = <1,3,6,10> O(n) Scan with strict accumulator O(n) Haskell-style scan  ) scanl f z <x1,...,xn> = <y1,...,y(n+1)>  where y1 = z  yi = f y(i-1) x(i-1)  Example:  scanl (+) 0 <1,2,3,4> = < 0,1,3,6,10> O(n), Haskell-style scan with strict accumulator O(n) Scan over a non-empty vector # scanl f <x1,...,xn> = <y1,...,yn>  where y1 = x1  yi = f y(i-1) xi O(n)8 Scan over a non-empty vector with a strict accumulator O(n) Right-to-left prescan   prescanr f z = y .  (flip f) z . y O(n)/ Right-to-left prescan with strict accumulator O(n) Right-to-left scan O(n), Right-to-left scan with strict accumulator O(n)" Right-to-left Haskell-style scan O(n): Right-to-left Haskell-style scan with strict accumulator O(n), Right-to-left scan over a non-empty vector O(n): Right-to-left scan over a non-empty vector with a strict  accumulator O(n) Convert a vector to a list O(n) Convert a list to a vector O(n) Convert the first n elements of a list to a vector   fromListN n xs =  (R n xs) O(n) Convert different vector types O(1)= Unsafe convert a mutable vector to an immutable one without C copying. The mutable vector may not be used after this operation. O(1)? Unsafely convert an immutable vector to a mutable one without E copying. The immutable vector may not be used after this operation. O(n)/ Yield a mutable copy of the immutable vector. O(n)0 Yield an immutable copy of the mutable vector. O(n)C Copy an immutable vector into a mutable one. The two vectors must  have the same length. O(n)C Copy an immutable vector into a mutable one. The two vectors must , have the same length. This is not checked. O(1) Convert a vector to a  O(n) Construct a vector from a  O(1) Convert a vector to a  , proceeding from right to left O(n) Construct a vector from a  , proceeding from right to left VWXY/Construct a vector from a monadic initialiser. GConvert a vector to an initialiser which, when run, produces a copy of  the vector. O(n)% Check if two vectors are equal. All $ instances are also  instances of Z7 and it is usually more appropriate to use those. This 1 function is primarily intended for implementing Z instances for new  vector types. O(n), Compare two vectors lexicographically. All $ instances are  also instances of [7 and it is usually more appropriate to use those. This 1 function is primarily intended for implementing [ instances for new  vector types. Generic definion of Data.Data.gfoldl that views a $ as a  list. $%&'()*+,@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~$%&'()*+,@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^ijk_`abcdefghlmnopqrstuvwxyz{|}~@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>'$Mutable vectors of primitive types. Length of the mutable vector. "Check whether the vector is empty 7Yield a part of the mutable vector without copying it. HYield a part of the mutable vector without copying it. No bounds checks  are performed. starting index length of the slice -Create a mutable vector of the given length. HCreate a mutable vector of the given length. The length is not checked. JCreate a mutable vector of the given length (0 if the length is negative) $ and fill it with an initial value.  JCreate a mutable vector of the given length (0 if the length is negative) N and fill it with values produced by repeatedly executing the monadic action.  #Create a copy of a mutable vector.  BGrow a vector by the given number of elements. The number must be  positive.  BGrow a vector by the given number of elements. The number must be # positive but this is not checked.  GReset all elements of the vector to some undefined value, clearing all N references to external objects. This is usually a noop for unboxed vectors. )Yield the element at the given position. +Replace the element at the given position. *Swap the elements at the given positions. IYield the element at the given position. No bounds checks are performed. KReplace the element at the given position. No bounds checks are performed. JSwap the elements at the given positions. No bounds checks are performed. 3Set all elements of the vector to the given value. ECopy a vector. The two vectors must have the same length and may not  overlap. ECopy a vector. The two vectors must have the same length and may not  overlap. This is not checked. target source BMove the contents of a vector. The two vectors must have the same  length. :If the vectors do not overlap, then this is equivalent to . B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. BMove the contents of a vector. The two vectors must have the same " length, but this is not checked. :If the vectors do not overlap, then this is equivalent to . B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. target source  DEPRECATED Use  instead  DEPRECATED Use  instead (     (     '       non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>#Unboxed vectors of primitive types \O(1)! Yield the length of the vector. O(1) Test whether a vector if empty O(1) Indexing O(1) Safe indexing  O(1) First element !O(1) Last element "O(1)) Unsafe indexing without bounds checking #O(1)7 First element without checking if the vector is empty $O(1)6 Last element without checking if the vector is empty %O(1) Indexing in a monad. GThe monad allows operations to be strict in the vector when necessary. 2 Suppose vector copying is implemented like this:  ( copy mv v = ... write mv i (v ! i) ... For lazy vectors, v ! i) would not be evaluated which means that mv + would unnecessarily retain a reference to v in each element written. With %0, copying can be implemented like this instead:   copy mv v = ... do # x <- indexM v i  write mv i x Here, no references to v$ are retained because indexing (but not the ! elements) is evaluated eagerly. &O(1)+ First element of a vector in a monad. See % for an $ explanation of why this is useful. 'O(1)* Last element of a vector in a monad. See % for an $ explanation of why this is useful. (O(1)0 Indexing in a monad without bounds checks. See % for an $ explanation of why this is useful. )O(1)> First element in a monad without checking for empty vectors.  See %+ for an explanation of why this is useful. *O(1)= Last element in a monad without checking for empty vectors.  See %+ for an explanation of why this is useful. +O(1)A Yield a slice of the vector without copying it. The vector must  contain at least i+n elements. i starting index n length ,O(1)D Yield all but the last element without copying. The vector may not  be empty. -O(1)E Yield all but the first element without copying. The vector may not  be empty. .O(1) Yield at the first n* elements without copying. The vector may  contain less than n2 elements in which case it is returned unchanged. /O(1) Yield all but the first n* elements without copying. The vector may  contain less than n5 elements in which case an empty vector is returned. 0O(1) Yield the first n5 elements paired with the remainder without copying.  Note that 0 n v is equivalent to (. n v, / n v)  but slightly more efficient. 1O(1)> Yield a slice of the vector without copying. The vector must  contain at least i+n# elements but this is not checked. i starting index n length 2O(1)D Yield all but the last element without copying. The vector may not # be empty but this is not checked. 3O(1)E Yield all but the first element without copying. The vector may not # be empty but this is not checked. 4O(1) Yield the first n+ elements without copying. The vector must  contain at least n# elements but this is not checked. 5O(1) Yield all but the first n& elements without copying. The vector  must contain at least n# elements but this is not checked. 6O(1) Empty vector 7O(1)! Vector with exactly one element 8O(n)A Vector of the given length with the same value in each position 9O(n)D Construct a vector of the given length by applying the function to  each index :O(n)D Apply function n times to value. Zeroth element is original value. ;O(n)B Construct a vector by repeatedly applying the generator function * to a seed. The generator function yields 2 the next element and the  new seed or 3 if there are no more elements. = unfoldr (\n -> if n == 0 then Nothing else Just (n,n-1)) 10  = <10,9,8,7,6,5,4,3,2,1> <O(n)! Construct a vector with at most n by repeatedly applying the A generator function to the a seed. The generator function yields 2 the " next element and the new seed or 3 if there are no more elements. / unfoldrN 3 (\n -> Just (n,n-1)) 10 = <10,9,8> =O(n): Yield a vector of the given length containing the values x, x+1 4 etc. This operation is usually more efficient than ?.  enumFromN 5 3 = <5,6,7> >O(n): Yield a vector of the given length containing the values x, x+y,  x+y+y5 etc. This operations is usually more efficient than @. - enumFromStepN 1 0.1 5 = <1,1.1,1.2,1.3,1.4> ?O(n) Enumerate values from x to y. WARNING:A This operation can be very inefficient. If at all possible, use  = instead. @O(n) Enumerate values from x to y with a specific step z. WARNING:A This operation can be very inefficient. If at all possible, use  > instead. AO(n) Prepend an element BO(n) Append an element CO(m+n) Concatenate two vectors DO(n)% Concatenate all vectors in the list EO(n)D Execute the monadic action the given number of times and store the  results in a vector. FO(n)@ Construct a vector of the given length by applying the monadic  action to each index G<Execute the monadic action and freeze the resulting vector.   create (do { v <- new 2; write v 0 'a' ; write v 1 'b' }) = <a,b> HO(n)A Yield the argument but force it not to retain any extra memory,  possibly by copying it. AThis is especially useful when dealing with slices. For example:  ! force (slice 0 2 <huge vector>) KHere, the slice retains a reference to the huge vector. Forcing it creates J a copy of just the elements that belong to the slice and allows the huge ! vector to be garbage collected. IO(m+n) For each pair (i,a)# from the list, replace the vector  element at position i by a. . <5,9,2,7> // [(2,1),(0,3),(2,8)] = <3,9,8,7> initial vector (of length m)  list of index/value pairs (of length n) JO(m+min(n1,n2)) For each index i from the index vector and the  corresponding value a3 from the value vector, replace the element of the  initial vector at position i by a. 0 update_ <5,9,2,7> <2,0,2> <1,3,8> = <3,9,8,7> initial vector (of length m) index vector (of length n1) value vector (of length n2) K Same as (I) but without bounds checking. LSame as J but without bounds checking. MO(m+n) For each pair (i,b)+ from the list, replace the vector element  a at position i by f a b. A accum (+) <5,9,2> [(2,4),(1,6),(0,3),(1,7)] = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m)  list of index/value pairs (of length n) NO(m+min(n1,n2)) For each index i from the index vector and the  corresponding value b from the the value vector, . replace the element of the initial vector at  position i by f a b. A accumulate_ (+) <5,9,2> <2,1,0,1> <4,6,3,7> = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m) index vector (of length n1) value vector (of length n2) OSame as M but without bounds checking. PSame as N but without bounds checking. QO(n) Reverse a vector RO(n)5 Yield the vector obtained by replacing each element i of the  index vector by xsi. This is equivalent to U (xs) is but is  often much more efficient. 5 backpermute <a,b,c,d> <0,3,2,3,1,0> = <a,d,c,d,b,a> SSame as R but without bounds checking. TAApply a destructive operation to a vector. The operation will be I performed in place if it is safe to do so and will modify a copy of the  vector otherwise.   modify (\v -> write v 0 'x') (8 3 'a') = <'x','a','a'> UO(n) Map a function over a vector VO(n)= Apply a function to every element of a vector and its index W:Map a function over a vector and concatenate the results. XO(n)D Apply the monadic action to all elements of the vector, yielding a  vector of results YO(n)E Apply the monadic action to all elements of a vector and ignore the  results ZO(n)D Apply the monadic action to all elements of the vector, yielding a ! vector of results. Equvalent to flip X. [O(n)E Apply the monadic action to all elements of a vector and ignore the  results. Equivalent to flip Y. \ O(min(m,n))* Zip two vectors with the given function. ]+Zip three vectors with the given function. ^_`a O(min(m,n))5 Zip two vectors with a function that also takes the  elements' indices. b=Zip three vectors and their indices with the given function. cdef O(min(m,n))9 Zip the two vectors with the monadic action and yield a  vector of results g O(min(m,n))< Zip the two vectors with the monadic action and ignore the  results hO(n)1 Drop elements that do not satisfy the predicate iO(n)E Drop elements that do not satisfy the predicate which is applied to  values and their indices jO(n)9 Drop elements that do not satisfy the monadic predicate kO(n)? Yield the longest prefix of elements satisfying the predicate  without copying. lO(n)@ Drop the longest prefix of elements that satisfy the predicate  without copying. mO(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. The H relative order of the elements is preserved at the cost of a sometimes ! reduced performance compared to n. nO(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. G The order of the elements is not preserved but the operation is often  faster than m. oO(n)C Split the vector into the longest prefix of elements that satisfy - the predicate and the rest without copying. pO(n)B Split the vector into the longest prefix of elements that do not 5 satisfy the predicate and the rest without copying. qO(n)) Check if the vector contains an element rO(n)= Check if the vector does not contain an element (inverse of q) sO(n) Yield 2- the first element matching the predicate or 3  if no such element exists. tO(n) Yield 27 the index of the first element matching the predicate  or 3 if no such element exists. uO(n)E Yield the indices of elements satisfying the predicate in ascending  order. vO(n) Yield 2: the index of the first occurence of the given element or  3C if the vector does not contain the element. This is a specialised  version of t. wO(n)= Yield the indices of all occurences of the given element in 3 ascending order. This is a specialised version of u. xO(n) Left fold yO(n) Left fold on non-empty vectors zO(n)# Left fold with strict accumulator {O(n)8 Left fold on non-empty vectors with strict accumulator |O(n) Right fold }O(n)! Right fold on non-empty vectors ~O(n)& Right fold with a strict accumulator O(n)9 Right fold on non-empty vectors with strict accumulator O(n)< Left fold (function applied to each element and its index) O(n)E Left fold with strict accumulator (function applied to each element  and its index) O(n)= Right fold (function applied to each element and its index) O(n)> Right fold with strict accumulator (function applied to each  element and its index) O(n). Check if all elements satisfy the predicate. O(n)/ Check if any element satisfies the predicate. O(n)! Compute the sum of the elements O(n)% Compute the produce of the elements O(n)@ Yield the maximum element of the vector. The vector may not be  empty. O(n)@ Yield the maximum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)@ Yield the minimum element of the vector. The vector may not be  empty. O(n)@ Yield the minimum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)B Yield the index of the maximum element of the vector. The vector  may not be empty. O(n)C Yield the index of the maximum element of the vector according to = the given comparison function. The vector may not be empty. O(n)B Yield the index of the minimum element of the vector. The vector  may not be empty. O(n)C Yield the index of the minimum element of the vector according to = the given comparison function. The vector may not be empty. O(n) Monadic fold O(n)% Monadic fold over non-empty vectors O(n)& Monadic fold with strict accumulator O(n)= Monadic fold over non-empty vectors with strict accumulator O(n)' Monadic fold that discards the result O(n)> Monadic fold over non-empty vectors that discards the result O(n)? Monadic fold with strict accumulator that discards the result O(n)= Monadic fold over non-empty vectors with strict accumulator  that discards the result O(n) Prescan    prescanl f z = , .  f z  Example: prescanl (+) 0 <1,2,3,4> = <0,1,3,6> O(n)! Prescan with strict accumulator O(n) Scan    postscanl f z = - .  f z  Example: postscanl (+) 0 <1,2,3,4> = <1,3,6,10> O(n) Scan with strict accumulator O(n) Haskell-style scan  ) scanl f z <x1,...,xn> = <y1,...,y(n+1)>  where y1 = z  yi = f y(i-1) x(i-1)  Example:  scanl (+) 0 <1,2,3,4> = < 0,1,3,6,10> O(n), Haskell-style scan with strict accumulator O(n) Scan over a non-empty vector # scanl f <x1,...,xn> = <y1,...,yn>  where y1 = x1  yi = f y(i-1) xi O(n)8 Scan over a non-empty vector with a strict accumulator O(n) Right-to-left prescan   prescanr f z = Q .  (flip f) z . Q O(n)/ Right-to-left prescan with strict accumulator O(n) Right-to-left scan O(n), Right-to-left scan with strict accumulator O(n)" Right-to-left Haskell-style scan O(n): Right-to-left Haskell-style scan with strict accumulator O(n), Right-to-left scan over a non-empty vector O(n): Right-to-left scan over a non-empty vector with a strict  accumulator O(n) Convert a vector to a list O(n) Convert a list to a vector O(n) Convert the first n elements of a list to a vector   fromListN n xs =  (. n xs) O(1)= Unsafe convert a mutable vector to an immutable one without C copying. The mutable vector may not be used after this operation. O(1)? Unsafely convert an immutable vector to a mutable one without E copying. The immutable vector may not be used after this operation. O(n)/ Yield a mutable copy of the immutable vector. O(n)0 Yield an immutable copy of the mutable vector. O(n)C Copy an immutable vector into a mutable one. The two vectors must , have the same length. This is not checked. O(n)C Copy an immutable vector into a mutable one. The two vectors must  have the same length.  !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ !"#$%&'()*+,-./0123456789:EFG;<=>?@ABCDHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>,Mutable -based vectors ]Length of the mutable vector. "Check whether the vector is empty 7Yield a part of the mutable vector without copying it. HYield a part of the mutable vector without copying it. No bounds checks  are performed. starting index length of the slice -Create a mutable vector of the given length. HCreate a mutable vector of the given length. The length is not checked. JCreate a mutable vector of the given length (0 if the length is negative) $ and fill it with an initial value. JCreate a mutable vector of the given length (0 if the length is negative) N and fill it with values produced by repeatedly executing the monadic action. #Create a copy of a mutable vector. BGrow a vector by the given number of elements. The number must be  positive. BGrow a vector by the given number of elements. The number must be # positive but this is not checked. GReset all elements of the vector to some undefined value, clearing all N references to external objects. This is usually a noop for unboxed vectors. )Yield the element at the given position. +Replace the element at the given position. *Swap the elements at the given positions. IYield the element at the given position. No bounds checks are performed. KReplace the element at the given position. No bounds checks are performed. JSwap the elements at the given positions. No bounds checks are performed. 3Set all elements of the vector to the given value. ECopy a vector. The two vectors must have the same length and may not  overlap. ECopy a vector. The two vectors must have the same length and may not  overlap. This is not checked. target source BMove the contents of a vector. The two vectors must have the same  length. :If the vectors do not overlap, then this is equivalent to . B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. BMove the contents of a vector. The two vectors must have the same " length, but this is not checked. :If the vectors do not overlap, then this is equivalent to . B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. target source O(1)B Unsafely cast a mutable vector from one element type to another. L The operation just changes the type of the underlying pointer and does not  modify the elements. CThe resulting vector contains as many elements as can fit into the  underlying memory block. Create a mutable vector from a ^ with an offset and a length.  Modifying data through the ^$ afterwards is unsafe if the vector 1 could have been frozen before the modification. pointer offset length Yield the underlying ^& together with the offset to the data 0 and its length. Modifying the data through the ^ is A unsafe if the vector could have frozen before the modification. Pass a pointer to the vector'(s data to the IO action. Modifying data K through the pointer is unsafe if the vector could have been frozen before  the modification.  DEPRECATED Use  instead  DEPRECATED Use  instead ,,+  non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>-based vectors _O(1)! Yield the length of the vector. O(1) Test whether a vector if empty O(1) Indexing O(1) Safe indexing O(1) First element O(1) Last element O(1)) Unsafe indexing without bounds checking O(1)7 First element without checking if the vector is empty O(1)6 Last element without checking if the vector is empty O(1) Indexing in a monad. GThe monad allows operations to be strict in the vector when necessary. 2 Suppose vector copying is implemented like this:  ( copy mv v = ... write mv i (v ! i) ... For lazy vectors, v ! i) would not be evaluated which means that mv + would unnecessarily retain a reference to v in each element written. With 0, copying can be implemented like this instead:   copy mv v = ... do # x <- indexM v i  write mv i x Here, no references to v$ are retained because indexing (but not the ! elements) is evaluated eagerly. O(1)+ First element of a vector in a monad. See  for an $ explanation of why this is useful. O(1)* Last element of a vector in a monad. See  for an $ explanation of why this is useful. O(1)0 Indexing in a monad without bounds checks. See  for an $ explanation of why this is useful. O(1)> First element in a monad without checking for empty vectors.  See + for an explanation of why this is useful. O(1)= Last element in a monad without checking for empty vectors.  See + for an explanation of why this is useful. O(1)A Yield a slice of the vector without copying it. The vector must  contain at least i+n elements. i starting index n length O(1)D Yield all but the last element without copying. The vector may not  be empty. O(1)E Yield all but the first element without copying. The vector may not  be empty. O(1) Yield at the first n* elements without copying. The vector may  contain less than n2 elements in which case it is returned unchanged. O(1) Yield all but the first n* elements without copying. The vector may  contain less than n5 elements in which case an empty vector is returned. O(1) Yield the first n5 elements paired with the remainder without copying.  Note that  n v is equivalent to ( n v,  n v)  but slightly more efficient. O(1)> Yield a slice of the vector without copying. The vector must  contain at least i+n# elements but this is not checked. i starting index n length O(1)D Yield all but the last element without copying. The vector may not # be empty but this is not checked. O(1)E Yield all but the first element without copying. The vector may not # be empty but this is not checked. O(1) Yield the first n+ elements without copying. The vector must  contain at least n# elements but this is not checked. O(1) Yield all but the first n& elements without copying. The vector  must contain at least n# elements but this is not checked. O(1) Empty vector O(1)! Vector with exactly one element O(n)A Vector of the given length with the same value in each position O(n)D Construct a vector of the given length by applying the function to  each index O(n)D Apply function n times to value. Zeroth element is original value. O(n)B Construct a vector by repeatedly applying the generator function * to a seed. The generator function yields 2 the next element and the  new seed or 3 if there are no more elements. = unfoldr (\n -> if n == 0 then Nothing else Just (n,n-1)) 10  = <10,9,8,7,6,5,4,3,2,1> O(n)! Construct a vector with at most n by repeatedly applying the A generator function to the a seed. The generator function yields 2 the " next element and the new seed or 3 if there are no more elements. / unfoldrN 3 (\n -> Just (n,n-1)) 10 = <10,9,8> O(n): Yield a vector of the given length containing the values x, x+1 4 etc. This operation is usually more efficient than .  enumFromN 5 3 = <5,6,7> O(n): Yield a vector of the given length containing the values x, x+y,  x+y+y5 etc. This operations is usually more efficient than . - enumFromStepN 1 0.1 5 = <1,1.1,1.2,1.3,1.4> O(n) Enumerate values from x to y. WARNING:A This operation can be very inefficient. If at all possible, use   instead. O(n) Enumerate values from x to y with a specific step z. WARNING:A This operation can be very inefficient. If at all possible, use   instead. O(n) Prepend an element O(n) Append an element O(m+n) Concatenate two vectors O(n)% Concatenate all vectors in the list O(n)D Execute the monadic action the given number of times and store the  results in a vector. O(n)@ Construct a vector of the given length by applying the monadic  action to each index <Execute the monadic action and freeze the resulting vector.   create (do { v <- new 2; write v 0 'a' ; write v 1 'b' }) = <a,b>  O(n)A Yield the argument but force it not to retain any extra memory,  possibly by copying it. AThis is especially useful when dealing with slices. For example:  ! force (slice 0 2 <huge vector>) KHere, the slice retains a reference to the huge vector. Forcing it creates J a copy of just the elements that belong to the slice and allows the huge ! vector to be garbage collected.  O(m+n) For each pair (i,a)# from the list, replace the vector  element at position i by a. . <5,9,2,7> // [(2,1),(0,3),(2,8)] = <3,9,8,7> initial vector (of length m)  list of index/value pairs (of length n)  O(m+min(n1,n2)) For each index i from the index vector and the  corresponding value a3 from the value vector, replace the element of the  initial vector at position i by a. 0 update_ <5,9,2,7> <2,0,2> <1,3,8> = <3,9,8,7> initial vector (of length m) index vector (of length n1) value vector (of length n2)   Same as ( ) but without bounds checking.  Same as   but without bounds checking. O(m+n) For each pair (i,b)+ from the list, replace the vector element  a at position i by f a b. A accum (+) <5,9,2> [(2,4),(1,6),(0,3),(1,7)] = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m)  list of index/value pairs (of length n) O(m+min(n1,n2)) For each index i from the index vector and the  corresponding value b from the the value vector, . replace the element of the initial vector at  position i by f a b. A accumulate_ (+) <5,9,2> <2,1,0,1> <4,6,3,7> = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m) index vector (of length n1) value vector (of length n2) Same as  but without bounds checking. Same as  but without bounds checking. O(n) Reverse a vector O(n)5 Yield the vector obtained by replacing each element i of the  index vector by xsi. This is equivalent to  (xs) is but is  often much more efficient. 5 backpermute <a,b,c,d> <0,3,2,3,1,0> = <a,d,c,d,b,a> Same as  but without bounds checking. AApply a destructive operation to a vector. The operation will be I performed in place if it is safe to do so and will modify a copy of the  vector otherwise.   modify (\v -> write v 0 'x') ( 3 'a') = <'x','a','a'> O(n) Map a function over a vector O(n)= Apply a function to every element of a vector and its index :Map a function over a vector and concatenate the results. O(n)D Apply the monadic action to all elements of the vector, yielding a  vector of results O(n)E Apply the monadic action to all elements of a vector and ignore the  results O(n)D Apply the monadic action to all elements of the vector, yielding a ! vector of results. Equvalent to flip . O(n)E Apply the monadic action to all elements of a vector and ignore the  results. Equivalent to flip .  O(min(m,n))* Zip two vectors with the given function. +Zip three vectors with the given function.  !" O(min(m,n))5 Zip two vectors with a function that also takes the  elements' indices. #=Zip three vectors and their indices with the given function. $%&' O(min(m,n))9 Zip the two vectors with the monadic action and yield a  vector of results ( O(min(m,n))< Zip the two vectors with the monadic action and ignore the  results )O(n)1 Drop elements that do not satisfy the predicate *O(n)E Drop elements that do not satisfy the predicate which is applied to  values and their indices +O(n)9 Drop elements that do not satisfy the monadic predicate ,O(n)? Yield the longest prefix of elements satisfying the predicate  without copying. -O(n)@ Drop the longest prefix of elements that satisfy the predicate  without copying. .O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. The H relative order of the elements is preserved at the cost of a sometimes ! reduced performance compared to /. /O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. G The order of the elements is not preserved but the operation is often  faster than .. 0O(n)C Split the vector into the longest prefix of elements that satisfy - the predicate and the rest without copying. 1O(n)B Split the vector into the longest prefix of elements that do not 5 satisfy the predicate and the rest without copying. 2O(n)) Check if the vector contains an element 3O(n)= Check if the vector does not contain an element (inverse of 2) 4O(n) Yield 2- the first element matching the predicate or 3  if no such element exists. 5O(n) Yield 27 the index of the first element matching the predicate  or 3 if no such element exists. 6O(n)E Yield the indices of elements satisfying the predicate in ascending  order. 7O(n) Yield 2: the index of the first occurence of the given element or  3C if the vector does not contain the element. This is a specialised  version of 5. 8O(n)= Yield the indices of all occurences of the given element in 3 ascending order. This is a specialised version of 6. 9O(n) Left fold :O(n) Left fold on non-empty vectors ;O(n)# Left fold with strict accumulator <O(n)8 Left fold on non-empty vectors with strict accumulator =O(n) Right fold >O(n)! Right fold on non-empty vectors ?O(n)& Right fold with a strict accumulator @O(n)9 Right fold on non-empty vectors with strict accumulator AO(n)< Left fold (function applied to each element and its index) BO(n)E Left fold with strict accumulator (function applied to each element  and its index) CO(n)= Right fold (function applied to each element and its index) DO(n)> Right fold with strict accumulator (function applied to each  element and its index) EO(n). Check if all elements satisfy the predicate. FO(n)/ Check if any element satisfies the predicate. GO(n) Check if all elements are T HO(n) Check if any element is T IO(n)! Compute the sum of the elements JO(n)% Compute the produce of the elements KO(n)@ Yield the maximum element of the vector. The vector may not be  empty. LO(n)@ Yield the maximum element of the vector according to the given 3 comparison function. The vector may not be empty. MO(n)@ Yield the minimum element of the vector. The vector may not be  empty. NO(n)@ Yield the minimum element of the vector according to the given 3 comparison function. The vector may not be empty. OO(n)B Yield the index of the maximum element of the vector. The vector  may not be empty. PO(n)C Yield the index of the maximum element of the vector according to = the given comparison function. The vector may not be empty. QO(n)B Yield the index of the minimum element of the vector. The vector  may not be empty. RO(n)C Yield the index of the minimum element of the vector according to = the given comparison function. The vector may not be empty. SO(n) Monadic fold TO(n)% Monadic fold over non-empty vectors UO(n)& Monadic fold with strict accumulator VO(n)= Monadic fold over non-empty vectors with strict accumulator WO(n)' Monadic fold that discards the result XO(n)> Monadic fold over non-empty vectors that discards the result YO(n)? Monadic fold with strict accumulator that discards the result ZO(n)= Monadic fold over non-empty vectors with strict accumulator  that discards the result [O(n) Prescan    prescanl f z =  . _ f z  Example: prescanl (+) 0 <1,2,3,4> = <0,1,3,6> \O(n)! Prescan with strict accumulator ]O(n) Scan    postscanl f z =  . _ f z  Example: postscanl (+) 0 <1,2,3,4> = <1,3,6,10> ^O(n) Scan with strict accumulator _O(n) Haskell-style scan  ) scanl f z <x1,...,xn> = <y1,...,y(n+1)>  where y1 = z  yi = f y(i-1) x(i-1)  Example:  scanl (+) 0 <1,2,3,4> = < 0,1,3,6,10> `O(n), Haskell-style scan with strict accumulator aO(n) Scan over a non-empty vector # scanl f <x1,...,xn> = <y1,...,yn>  where y1 = x1  yi = f y(i-1) xi bO(n)8 Scan over a non-empty vector with a strict accumulator cO(n) Right-to-left prescan   prescanr f z =  . [ (flip f) z .  dO(n)/ Right-to-left prescan with strict accumulator eO(n) Right-to-left scan fO(n), Right-to-left scan with strict accumulator gO(n)" Right-to-left Haskell-style scan hO(n): Right-to-left Haskell-style scan with strict accumulator iO(n), Right-to-left scan over a non-empty vector jO(n): Right-to-left scan over a non-empty vector with a strict  accumulator kO(n) Convert a vector to a list lO(n) Convert a list to a vector mO(n) Convert the first n elements of a list to a vector   fromListN n xs = l ( n xs) nO(1): Unsafely cast a vector from one element type to another. L The operation just changes the type of the underlying pointer and does not  modify the elements. CThe resulting vector contains as many elements as can fit into the  underlying memory block. oO(1)= Unsafe convert a mutable vector to an immutable one without C copying. The mutable vector may not be used after this operation. pO(1)? Unsafely convert an immutable vector to a mutable one without E copying. The immutable vector may not be used after this operation. qO(n)/ Yield a mutable copy of the immutable vector. rO(n)0 Yield an immutable copy of the mutable vector. sO(n)C Copy an immutable vector into a mutable one. The two vectors must , have the same length. This is not checked. tO(n)C Copy an immutable vector into a mutable one. The two vectors must  have the same length. uO(1) Create a vector from a ^ with an offset and a length. * The data may not be modified through the ^ afterwards. pointer offset length vO(1) Yield the underlying ^! together with the offset to the ? data and its length. The data may not be modified through the ^. wPass a pointer to the vector'-s data to the IO action. The data may not be  modified through the 'Ptr.       !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvw      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNQROPSUTVWYXZ[\]^_`abcdefghijklmnrqtopsuvw      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvw non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>xyz{|`ab/xyz{|cdefghijklmnopqrstuvwxyz{|}~xyz{| non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>}O(1)! Yield the length of the vector. ~O(1) Test whether a vector if empty O(1) Indexing O(1) Safe indexing O(1) First element O(1) Last element O(1)) Unsafe indexing without bounds checking O(1)7 First element without checking if the vector is empty O(1)6 Last element without checking if the vector is empty O(1) Indexing in a monad. GThe monad allows operations to be strict in the vector when necessary. 2 Suppose vector copying is implemented like this:  ( copy mv v = ... write mv i (v ! i) ... For lazy vectors, v ! i) would not be evaluated which means that mv + would unnecessarily retain a reference to v in each element written. With 0, copying can be implemented like this instead:   copy mv v = ... do # x <- indexM v i  write mv i x Here, no references to v$ are retained because indexing (but not the ! elements) is evaluated eagerly. O(1)+ First element of a vector in a monad. See  for an $ explanation of why this is useful. O(1)* Last element of a vector in a monad. See  for an $ explanation of why this is useful. O(1)0 Indexing in a monad without bounds checks. See  for an $ explanation of why this is useful. O(1)> First element in a monad without checking for empty vectors.  See + for an explanation of why this is useful. O(1)= Last element in a monad without checking for empty vectors.  See + for an explanation of why this is useful. O(1)A Yield a slice of the vector without copying it. The vector must  contain at least i+n elements. i starting index n length O(1)D Yield all but the last element without copying. The vector may not  be empty. O(1)E Yield all but the first element without copying. The vector may not  be empty. O(1) Yield at the first n* elements without copying. The vector may  contain less than n2 elements in which case it is returned unchanged. O(1) Yield all but the first n* elements without copying. The vector may  contain less than n5 elements in which case an empty vector is returned. O(1) Yield the first n5 elements paired with the remainder without copying.  Note that  n v is equivalent to ( n v,  n v)  but slightly more efficient. O(1)> Yield a slice of the vector without copying. The vector must  contain at least i+n# elements but this is not checked. i starting index n length O(1)D Yield all but the last element without copying. The vector may not # be empty but this is not checked. O(1)E Yield all but the first element without copying. The vector may not # be empty but this is not checked. O(1) Yield the first n+ elements without copying. The vector must  contain at least n# elements but this is not checked. O(1) Yield all but the first n& elements without copying. The vector  must contain at least n# elements but this is not checked. O(1) Empty vector O(1)! Vector with exactly one element O(n)A Vector of the given length with the same value in each position O(n)D Construct a vector of the given length by applying the function to  each index O(n)D Apply function n times to value. Zeroth element is original value. O(n)B Construct a vector by repeatedly applying the generator function * to a seed. The generator function yields 2 the next element and the  new seed or 3 if there are no more elements. = unfoldr (\n -> if n == 0 then Nothing else Just (n,n-1)) 10  = <10,9,8,7,6,5,4,3,2,1> O(n)! Construct a vector with at most n by repeatedly applying the A generator function to the a seed. The generator function yields 2 the " next element and the new seed or 3 if there are no more elements. / unfoldrN 3 (\n -> Just (n,n-1)) 10 = <10,9,8> O(n): Yield a vector of the given length containing the values x, x+1 4 etc. This operation is usually more efficient than .  enumFromN 5 3 = <5,6,7> O(n): Yield a vector of the given length containing the values x, x+y,  x+y+y5 etc. This operations is usually more efficient than . - enumFromStepN 1 0.1 5 = <1,1.1,1.2,1.3,1.4> O(n) Enumerate values from x to y. WARNING:A This operation can be very inefficient. If at all possible, use   instead. O(n) Enumerate values from x to y with a specific step z. WARNING:A This operation can be very inefficient. If at all possible, use   instead. O(n) Prepend an element O(n) Append an element O(m+n) Concatenate two vectors O(n)% Concatenate all vectors in the list O(n)D Execute the monadic action the given number of times and store the  results in a vector. O(n)@ Construct a vector of the given length by applying the monadic  action to each index <Execute the monadic action and freeze the resulting vector.   create (do { v <- new 2; write v 0 'a' ; write v 1 'b' }) = <a,b> O(n)A Yield the argument but force it not to retain any extra memory,  possibly by copying it. AThis is especially useful when dealing with slices. For example:  ! force (slice 0 2 <huge vector>) KHere, the slice retains a reference to the huge vector. Forcing it creates J a copy of just the elements that belong to the slice and allows the huge ! vector to be garbage collected. O(m+n) For each pair (i,a)# from the list, replace the vector  element at position i by a. . <5,9,2,7> // [(2,1),(0,3),(2,8)] = <3,9,8,7> initial vector (of length m)  list of index/value pairs (of length n) O(m+n) For each pair (i,a) from the vector of index/ value pairs, ( replace the vector element at position i by a. 2 update <5,9,2,7> <(2,1),(0,3),(2,8)> = <3,9,8,7> initial vector (of length m) vector of index/value pairs (of length n) O(m+min(n1,n2)) For each index i from the index vector and the  corresponding value a3 from the value vector, replace the element of the  initial vector at position i by a.  0 update_ <5,9,2,7> <2,0,2> <1,3,8> = <3,9,8,7>  The function 5 provides the same functionality and is usually more  convenient.   update_ xs is ys =  xs ( is ys) initial vector (of length m) index vector (of length n1) value vector (of length n2)  Same as () but without bounds checking. Same as  but without bounds checking. Same as  but without bounds checking. O(m+n) For each pair (i,b)+ from the list, replace the vector element  a at position i by f a b. A accum (+) <5,9,2> [(2,4),(1,6),(0,3),(1,7)] = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m)  list of index/value pairs (of length n) O(m+n) For each pair (i,b). from the vector of pairs, replace the vector  element a at position i by f a b. F accumulate (+) <5,9,2> <(2,4),(1,6),(0,3),(1,7)> = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m) vector of index/value pairs (of length n) O(m+min(n1,n2)) For each index i from the index vector and the  corresponding value b from the the value vector, . replace the element of the initial vector at  position i by f a b.  A accumulate_ (+) <5,9,2> <2,1,0,1> <4,6,3,7> = <5+3, 9+6+7, 2+4>  The function 5 provides the same functionality and is usually more  convenient.   accumulate_ f as is bs =  f as ( is bs) accumulating function f initial vector (of length m) index vector (of length n1) value vector (of length n2) Same as  but without bounds checking. Same as  but without bounds checking. Same as  but without bounds checking. O(n) Reverse a vector O(n)5 Yield the vector obtained by replacing each element i of the  index vector by xsi. This is equivalent to  (xs) is but is  often much more efficient. 5 backpermute <a,b,c,d> <0,3,2,3,1,0> = <a,d,c,d,b,a> Same as  but without bounds checking. AApply a destructive operation to a vector. The operation will be I performed in place if it is safe to do so and will modify a copy of the  vector otherwise.   modify (\v -> write v 0 'x') ( 3 'a') = <'x','a','a'> O(n). Pair each element in a vector with its index O(n) Map a function over a vector O(n)= Apply a function to every element of a vector and its index :Map a function over a vector and concatenate the results. O(n)D Apply the monadic action to all elements of the vector, yielding a  vector of results O(n)E Apply the monadic action to all elements of a vector and ignore the  results O(n)D Apply the monadic action to all elements of the vector, yielding a ! vector of results. Equvalent to flip . O(n)E Apply the monadic action to all elements of a vector and ignore the  results. Equivalent to flip .  O(min(m,n))* Zip two vectors with the given function. +Zip three vectors with the given function.  O(min(m,n))5 Zip two vectors with a function that also takes the  elements' indices. =Zip three vectors and their indices with the given function.  O(min(m,n))9 Zip the two vectors with the monadic action and yield a  vector of results  O(min(m,n))< Zip the two vectors with the monadic action and ignore the  results O(n)1 Drop elements that do not satisfy the predicate O(n)E Drop elements that do not satisfy the predicate which is applied to  values and their indices O(n)9 Drop elements that do not satisfy the monadic predicate O(n)? Yield the longest prefix of elements satisfying the predicate  without copying. O(n)@ Drop the longest prefix of elements that satisfy the predicate  without copying. O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. The H relative order of the elements is preserved at the cost of a sometimes ! reduced performance compared to . O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. G The order of the elements is not preserved but the operation is often  faster than . O(n)C Split the vector into the longest prefix of elements that satisfy - the predicate and the rest without copying. O(n)B Split the vector into the longest prefix of elements that do not 5 satisfy the predicate and the rest without copying. O(n)) Check if the vector contains an element O(n)= Check if the vector does not contain an element (inverse of ) O(n) Yield 2- the first element matching the predicate or 3  if no such element exists. O(n) Yield 27 the index of the first element matching the predicate  or 3 if no such element exists. O(n)E Yield the indices of elements satisfying the predicate in ascending  order. O(n) Yield 2: the index of the first occurence of the given element or  3C if the vector does not contain the element. This is a specialised  version of . O(n)= Yield the indices of all occurences of the given element in 3 ascending order. This is a specialised version of . O(n) Left fold O(n) Left fold on non-empty vectors O(n)# Left fold with strict accumulator O(n)8 Left fold on non-empty vectors with strict accumulator O(n) Right fold O(n)! Right fold on non-empty vectors O(n)& Right fold with a strict accumulator O(n)9 Right fold on non-empty vectors with strict accumulator O(n)< Left fold (function applied to each element and its index) O(n)E Left fold with strict accumulator (function applied to each element  and its index) O(n)= Right fold (function applied to each element and its index) O(n)> Right fold with strict accumulator (function applied to each  element and its index) O(n). Check if all elements satisfy the predicate. O(n)/ Check if any element satisfies the predicate. O(n) Check if all elements are T O(n) Check if any element is T O(n)! Compute the sum of the elements O(n)% Compute the produce of the elements O(n)@ Yield the maximum element of the vector. The vector may not be  empty. O(n)@ Yield the maximum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)@ Yield the minimum element of the vector. The vector may not be  empty. O(n)@ Yield the minimum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)B Yield the index of the maximum element of the vector. The vector  may not be empty. O(n)C Yield the index of the maximum element of the vector according to = the given comparison function. The vector may not be empty. O(n)B Yield the index of the minimum element of the vector. The vector  may not be empty. O(n)C Yield the index of the minimum element of the vector according to = the given comparison function. The vector may not be empty. O(n) Monadic fold O(n)% Monadic fold over non-empty vectors O(n)& Monadic fold with strict accumulator O(n)= Monadic fold over non-empty vectors with strict accumulator O(n)' Monadic fold that discards the result O(n)> Monadic fold over non-empty vectors that discards the result O(n)? Monadic fold with strict accumulator that discards the result O(n)= Monadic fold over non-empty vectors with strict accumulator  that discards the result O(n) Prescan    prescanl f z =  .  f z  Example: prescanl (+) 0 <1,2,3,4> = <0,1,3,6> O(n)! Prescan with strict accumulator O(n) Scan    postscanl f z =  .  f z  Example: postscanl (+) 0 <1,2,3,4> = <1,3,6,10> O(n) Scan with strict accumulator O(n) Haskell-style scan  ) scanl f z <x1,...,xn> = <y1,...,y(n+1)>  where y1 = z  yi = f y(i-1) x(i-1)  Example:  scanl (+) 0 <1,2,3,4> = < 0,1,3,6,10> O(n), Haskell-style scan with strict accumulator O(n) Scan over a non-empty vector # scanl f <x1,...,xn> = <y1,...,yn>  where y1 = x1  yi = f y(i-1) xi O(n)8 Scan over a non-empty vector with a strict accumulator O(n) Right-to-left prescan   prescanr f z =  .  (flip f) z .   O(n)/ Right-to-left prescan with strict accumulator  O(n) Right-to-left scan  O(n), Right-to-left scan with strict accumulator  O(n)" Right-to-left Haskell-style scan  O(n): Right-to-left Haskell-style scan with strict accumulator O(n), Right-to-left scan over a non-empty vector O(n): Right-to-left scan over a non-empty vector with a strict  accumulator O(n) Convert a vector to a list O(n) Convert a list to a vector O(n) Convert the first n elements of a list to a vector   fromListN n xs =  ( n xs) O(1)= Unsafe convert a mutable vector to an immutable one without C copying. The mutable vector may not be used after this operation. O(1)? Unsafely convert an immutable vector to a mutable one without E copying. The immutable vector may not be used after this operation. O(n)/ Yield a mutable copy of the immutable vector. O(n)0 Yield an immutable copy of the mutable vector. O(n)C Copy an immutable vector into a mutable one. The two vectors must , have the same length. This is not checked. O(n)C Copy an immutable vector into a mutable one. The two vectors must  have the same length. O(1) Zip 2 vectors O(1) Unzip 2 vectors O(1) Zip 3 vectors O(1) Unzip 3 vectors O(1) Zip 4 vectors O(1) Unzip 4 vectors O(1) Zip 5 vectors  O(1) Unzip 5 vectors !O(1) Zip 6 vectors "O(1) Unzip 6 vectors x{|dfhjlnprtvxz|~}~      !"{|x}~! "     }~      !" non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>-#Length of the mutable vector. $"Check whether the vector is empty %7Yield a part of the mutable vector without copying it. &'()*+HYield a part of the mutable vector without copying it. No bounds checks  are performed. starting index length of the slice ,-./01-Create a mutable vector of the given length. 2HCreate a mutable vector of the given length. The length is not checked. 3JCreate a mutable vector of the given length (0 if the length is negative) $ and fill it with an initial value. 4JCreate a mutable vector of the given length (0 if the length is negative) N and fill it with values produced by repeatedly executing the monadic action. 5#Create a copy of a mutable vector. 6BGrow a vector by the given number of elements. The number must be  positive. 7BGrow a vector by the given number of elements. The number must be # positive but this is not checked. 8GReset all elements of the vector to some undefined value, clearing all N references to external objects. This is usually a noop for unboxed vectors. 9)Yield the element at the given position. :+Replace the element at the given position. ;*Swap the elements at the given positions. <IYield the element at the given position. No bounds checks are performed. =KReplace the element at the given position. No bounds checks are performed. >JSwap the elements at the given positions. No bounds checks are performed. ?3Set all elements of the vector to the given value. @ECopy a vector. The two vectors must have the same length and may not  overlap. AECopy a vector. The two vectors must have the same length and may not  overlap. This is not checked. target source BBMove the contents of a vector. The two vectors must have the same  length. :If the vectors do not overlap, then this is equivalent to @. B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. CBMove the contents of a vector. The two vectors must have the same " length, but this is not checked. :If the vectors do not overlap, then this is equivalent to A. B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. target source D DEPRECATED Use 3 instead E DEPRECATED Use 3 instead FO(1) Zip 2 vectors GO(1) Unzip 2 vectors HO(1) Zip 3 vectors IO(1) Unzip 3 vectors JO(1) Zip 4 vectors KO(1) Unzip 4 vectors LO(1) Zip 5 vectors MO(1) Unzip 5 vectors NO(1) Zip 6 vectors OO(1) Unzip 6 vectors Fxyz|dfhjlnprtvxz|~#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNO1|zyx#$%)*&'(+./,-012345678FHJLNGIKMO9:;<=>?@BACDE-#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNO non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>,PQR7Mutable boxed vectors keyed on the monad they live in ( or ST s). STLength of the mutable vector. U"Check whether the vector is empty V7Yield a part of the mutable vector without copying it. WXYZ[\HYield a part of the mutable vector without copying it. No bounds checks  are performed. starting index length of the slice ]^_`ab-Create a mutable vector of the given length. cHCreate a mutable vector of the given length. The length is not checked. dJCreate a mutable vector of the given length (0 if the length is negative) $ and fill it with an initial value. eJCreate a mutable vector of the given length (0 if the length is negative) N and fill it with values produced by repeatedly executing the monadic action. f#Create a copy of a mutable vector. gBGrow a vector by the given number of elements. The number must be  positive. hBGrow a vector by the given number of elements. The number must be # positive but this is not checked. iGReset all elements of the vector to some undefined value, clearing all N references to external objects. This is usually a noop for unboxed vectors. j)Yield the element at the given position. k+Replace the element at the given position. l*Swap the elements at the given positions. mIYield the element at the given position. No bounds checks are performed. nKReplace the element at the given position. No bounds checks are performed. oJSwap the elements at the given positions. No bounds checks are performed. p3Set all elements of the vector to the given value. qECopy a vector. The two vectors must have the same length and may not  overlap. rECopy a vector. The two vectors must have the same length and may not  overlap. This is not checked. target source sBMove the contents of a vector. The two vectors must have the same  length. :If the vectors do not overlap, then this is equivalent to q. B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. tBMove the contents of a vector. The two vectors must have the same " length, but this is not checked. :If the vectors do not overlap, then this is equivalent to r. B Otherwise, the copying is performed as if the source vector were G copied to a temporary vector and then the temporary vector was copied  to the target vector. target source u DEPRECATED Use d instead v DEPRECATED Use d instead 'PQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuv'RSQPTUVZ[WXY\_`]^abcdefghijklmnopqsrtuv'PQRSSTUVWXYZ[\]^_`abcdefghijklmnopqrstuv non-portable experimental'Roman Leshchinskiy <rl@cse.unsw.edu.au>w-Boxed vectors, supporting efficient slicing. xO(1)! Yield the length of the vector. yO(1) Test whether a vector if empty zO(1) Indexing {O(1) Safe indexing |O(1) First element }O(1) Last element ~O(1)) Unsafe indexing without bounds checking O(1)7 First element without checking if the vector is empty O(1)6 Last element without checking if the vector is empty O(1) Indexing in a monad. GThe monad allows operations to be strict in the vector when necessary. 2 Suppose vector copying is implemented like this:  ( copy mv v = ... write mv i (v ! i) ... For lazy vectors, v ! i) would not be evaluated which means that mv + would unnecessarily retain a reference to v in each element written. With 0, copying can be implemented like this instead:   copy mv v = ... do # x <- indexM v i  write mv i x Here, no references to v$ are retained because indexing (but not the ! elements) is evaluated eagerly. O(1)+ First element of a vector in a monad. See  for an $ explanation of why this is useful. O(1)* Last element of a vector in a monad. See  for an $ explanation of why this is useful. O(1)0 Indexing in a monad without bounds checks. See  for an $ explanation of why this is useful. O(1)> First element in a monad without checking for empty vectors.  See + for an explanation of why this is useful. O(1)= Last element in a monad without checking for empty vectors.  See + for an explanation of why this is useful. O(1)A Yield a slice of the vector without copying it. The vector must  contain at least i+n elements. i starting index n length O(1)D Yield all but the last element without copying. The vector may not  be empty. O(1)E Yield all but the first element without copying. The vector may not  be empty. O(1) Yield at the first n* elements without copying. The vector may  contain less than n2 elements in which case it is returned unchanged. O(1) Yield all but the first n* elements without copying. The vector may  contain less than n5 elements in which case an empty vector is returned. O(1) Yield the first n5 elements paired with the remainder without copying.  Note that  n v is equivalent to ( n v,  n v)  but slightly more efficient. O(1)> Yield a slice of the vector without copying. The vector must  contain at least i+n# elements but this is not checked. i starting index n length O(1)D Yield all but the last element without copying. The vector may not # be empty but this is not checked. O(1)E Yield all but the first element without copying. The vector may not # be empty but this is not checked. O(1) Yield the first n+ elements without copying. The vector must  contain at least n# elements but this is not checked. O(1) Yield all but the first n& elements without copying. The vector  must contain at least n# elements but this is not checked. O(1) Empty vector O(1)! Vector with exactly one element O(n)A Vector of the given length with the same value in each position O(n)D Construct a vector of the given length by applying the function to  each index O(n)D Apply function n times to value. Zeroth element is original value. O(n)B Construct a vector by repeatedly applying the generator function * to a seed. The generator function yields 2 the next element and the  new seed or 3 if there are no more elements. = unfoldr (\n -> if n == 0 then Nothing else Just (n,n-1)) 10  = <10,9,8,7,6,5,4,3,2,1> O(n)! Construct a vector with at most n by repeatedly applying the A generator function to the a seed. The generator function yields 2 the " next element and the new seed or 3 if there are no more elements. / unfoldrN 3 (\n -> Just (n,n-1)) 10 = <10,9,8> O(n): Yield a vector of the given length containing the values x, x+1 4 etc. This operation is usually more efficient than .  enumFromN 5 3 = <5,6,7> O(n): Yield a vector of the given length containing the values x, x+y,  x+y+y5 etc. This operations is usually more efficient than . - enumFromStepN 1 0.1 5 = <1,1.1,1.2,1.3,1.4> O(n) Enumerate values from x to y. WARNING:A This operation can be very inefficient. If at all possible, use   instead. O(n) Enumerate values from x to y with a specific step z. WARNING:A This operation can be very inefficient. If at all possible, use   instead. O(n) Prepend an element O(n) Append an element O(m+n) Concatenate two vectors O(n)% Concatenate all vectors in the list O(n)D Execute the monadic action the given number of times and store the  results in a vector. O(n)@ Construct a vector of the given length by applying the monadic  action to each index <Execute the monadic action and freeze the resulting vector.   create (do { v <- new 2; write v 0 'a' ; write v 1 'b' }) = <a,b> O(n)A Yield the argument but force it not to retain any extra memory,  possibly by copying it. AThis is especially useful when dealing with slices. For example:  ! force (slice 0 2 <huge vector>) KHere, the slice retains a reference to the huge vector. Forcing it creates J a copy of just the elements that belong to the slice and allows the huge ! vector to be garbage collected. O(m+n) For each pair (i,a)# from the list, replace the vector  element at position i by a. . <5,9,2,7> // [(2,1),(0,3),(2,8)] = <3,9,8,7> initial vector (of length m)  list of index/value pairs (of length n) O(m+n) For each pair (i,a) from the vector of index/ value pairs, ( replace the vector element at position i by a. 2 update <5,9,2,7> <(2,1),(0,3),(2,8)> = <3,9,8,7> initial vector (of length m) vector of index/value pairs (of length n) O(m+min(n1,n2)) For each index i from the index vector and the  corresponding value a3 from the value vector, replace the element of the  initial vector at position i by a.  0 update_ <5,9,2,7> <2,0,2> <1,3,8> = <3,9,8,7>  The function 5 provides the same functionality and is usually more  convenient.   update_ xs is ys =  xs ( is ys) initial vector (of length m) index vector (of length n1) value vector (of length n2)  Same as () but without bounds checking. Same as  but without bounds checking. Same as  but without bounds checking. O(m+n) For each pair (i,b)+ from the list, replace the vector element  a at position i by f a b. A accum (+) <5,9,2> [(2,4),(1,6),(0,3),(1,7)] = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m)  list of index/value pairs (of length n) O(m+n) For each pair (i,b). from the vector of pairs, replace the vector  element a at position i by f a b. F accumulate (+) <5,9,2> <(2,4),(1,6),(0,3),(1,7)> = <5+3, 9+6+7, 2+4> accumulating function f initial vector (of length m) vector of index/value pairs (of length n) O(m+min(n1,n2)) For each index i from the index vector and the  corresponding value b from the the value vector, . replace the element of the initial vector at  position i by f a b.  A accumulate_ (+) <5,9,2> <2,1,0,1> <4,6,3,7> = <5+3, 9+6+7, 2+4>  The function 5 provides the same functionality and is usually more  convenient.   accumulate_ f as is bs =  f as ( is bs) accumulating function f initial vector (of length m) index vector (of length n1) value vector (of length n2) Same as  but without bounds checking. Same as  but without bounds checking. Same as  but without bounds checking. O(n) Reverse a vector O(n)5 Yield the vector obtained by replacing each element i of the  index vector by xszi. This is equivalent to  (xsz) is but is  often much more efficient. 5 backpermute <a,b,c,d> <0,3,2,3,1,0> = <a,d,c,d,b,a> Same as  but without bounds checking. AApply a destructive operation to a vector. The operation will be I performed in place if it is safe to do so and will modify a copy of the  vector otherwise.   modify (\v -> write v 0 'x') ( 3 'a') = <'x','a','a'> O(n). Pair each element in a vector with its index O(n) Map a function over a vector O(n)= Apply a function to every element of a vector and its index :Map a function over a vector and concatenate the results. O(n)D Apply the monadic action to all elements of the vector, yielding a  vector of results O(n)E Apply the monadic action to all elements of a vector and ignore the  results O(n)D Apply the monadic action to all elements of the vector, yielding a ! vector of results. Equvalent to flip . O(n)E Apply the monadic action to all elements of a vector and ignore the  results. Equivalent to flip .  O(min(m,n))* Zip two vectors with the given function. +Zip three vectors with the given function.  O(min(m,n))5 Zip two vectors with a function that also takes the  elements' indices. =Zip three vectors and their indices with the given function. (Elementwise pairing of array elements. 4zip together three vectors into a vector of triples  O(min(m,n)) Unzip a vector of pairs.  O(min(m,n))9 Zip the two vectors with the monadic action and yield a  vector of results  O(min(m,n))< Zip the two vectors with the monadic action and ignore the  results O(n)1 Drop elements that do not satisfy the predicate O(n)E Drop elements that do not satisfy the predicate which is applied to  values and their indices O(n)9 Drop elements that do not satisfy the monadic predicate O(n)? Yield the longest prefix of elements satisfying the predicate  without copying. O(n)@ Drop the longest prefix of elements that satisfy the predicate  without copying. O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. The H relative order of the elements is preserved at the cost of a sometimes ! reduced performance compared to . O(n)? Split the vector in two parts, the first one containing those F elements that satisfy the predicate and the second one those that don't. G The order of the elements is not preserved but the operation is often  faster than . O(n)C Split the vector into the longest prefix of elements that satisfy - the predicate and the rest without copying. O(n)B Split the vector into the longest prefix of elements that do not 5 satisfy the predicate and the rest without copying. O(n)) Check if the vector contains an element O(n)= Check if the vector does not contain an element (inverse of ) O(n) Yield 2- the first element matching the predicate or 3  if no such element exists. O(n) Yield 27 the index of the first element matching the predicate  or 3 if no such element exists. O(n)E Yield the indices of elements satisfying the predicate in ascending  order. O(n) Yield 2: the index of the first occurence of the given element or  3C if the vector does not contain the element. This is a specialised  version of . O(n)= Yield the indices of all occurences of the given element in 3 ascending order. This is a specialised version of . O(n) Left fold O(n) Left fold on non-empty vectors O(n)# Left fold with strict accumulator O(n)8 Left fold on non-empty vectors with strict accumulator O(n) Right fold O(n)! Right fold on non-empty vectors O(n)& Right fold with a strict accumulator O(n)9 Right fold on non-empty vectors with strict accumulator O(n)< Left fold (function applied to each element and its index) O(n)E Left fold with strict accumulator (function applied to each element  and its index) O(n)= Right fold (function applied to each element and its index) O(n)> Right fold with strict accumulator (function applied to each  element and its index) O(n). Check if all elements satisfy the predicate. O(n)/ Check if any element satisfies the predicate. O(n) Check if all elements are T O(n) Check if any element is T O(n)! Compute the sum of the elements O(n)% Compute the produce of the elements O(n)@ Yield the maximum element of the vector. The vector may not be  empty. O(n)@ Yield the maximum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)@ Yield the minimum element of the vector. The vector may not be  empty. O(n)@ Yield the minimum element of the vector according to the given 3 comparison function. The vector may not be empty. O(n)B Yield the index of the maximum element of the vector. The vector  may not be empty. O(n)C Yield the index of the maximum element of the vector according to = the given comparison function. The vector may not be empty. O(n)B Yield the index of the minimum element of the vector. The vector  may not be empty. O(n)C Yield the index of the minimum element of the vector according to = the given comparison function. The vector may not be empty. O(n) Monadic fold O(n)% Monadic fold over non-empty vectors O(n)& Monadic fold with strict accumulator O(n)= Monadic fold over non-empty vectors with strict accumulator O(n)' Monadic fold that discards the result O(n)> Monadic fold over non-empty vectors that discards the result O(n)? Monadic fold with strict accumulator that discards the result O(n)= Monadic fold over non-empty vectors with strict accumulator  that discards the result -Evaluate each action and collect the results -Evaluate each action and discard the results O(n) Prescan    prescanl f z =  .   f z  Example: prescanl (+) 0 <1,2,3,4> = <0,1,3,6> O(n)! Prescan with strict accumulator  O(n) Scan    postscanl f z =  .   f z  Example: postscanl (+) 0 <1,2,3,4> = <1,3,6,10>  O(n) Scan with strict accumulator  O(n) Haskell-style scan  ) scanl f z <x1,...,xn> = <y1,...,y(n+1)>  where y1 = z  yi = f y(i-1) x(i-1)  Example:  scanl (+) 0 <1,2,3,4> = < 0,1,3,6,10>  O(n), Haskell-style scan with strict accumulator  O(n) Scan over a non-empty vector # scanl f <x1,...,xn> = <y1,...,yn>  where y1 = x1  yi = f y(i-1) xi O(n)8 Scan over a non-empty vector with a strict accumulator O(n) Right-to-left prescan   prescanr f z =  .  (flip f) z .  O(n)/ Right-to-left prescan with strict accumulator O(n) Right-to-left scan O(n), Right-to-left scan with strict accumulator O(n)" Right-to-left Haskell-style scan O(n): Right-to-left Haskell-style scan with strict accumulator O(n), Right-to-left scan over a non-empty vector O(n): Right-to-left scan over a non-empty vector with a strict  accumulator O(n) Convert a vector to a list O(n) Convert a list to a vector O(n) Convert the first n elements of a list to a vector   fromListN n xs =  ( n xs) O(1)= Unsafe convert a mutable vector to an immutable one without C copying. The mutable vector may not be used after this operation. O(1)? Unsafely convert an immutable vector to a mutable one without E copying. The immutable vector may not be used after this operation. O(n)/ Yield a mutable copy of the immutable vector. O(n)0 Yield an immutable copy of the mutable vector. O(n)C Copy an immutable vector into a mutable one. The two vectors must , have the same length. This is not checked. O(n)C Copy an immutable vector into a mutable one. The two vectors must  have the same length. Rwxyz{|}~     wRxyz{|}~     wxyz{|}~      !"#$%&'()*+,-./01234566789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~6;<=>?@ACEFGHIJKLMNOPTUV]^_`abcdefgikmnoqsvy|QRWXhux{~  = > K N O L M A B    K L M N O = > H I K L M N O ? @ A C E F G B D       U P  Q R   ] ^ _ ` a      b c d e f W X      g  h i k    m n o q    s v y |         ! " # $ % & ' ( ) * + u x { ~ , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B CDE=>KNOLMAB  = > H I K L M N O ? @ A C E F G B D     P  Q R   ] ^ _ ` a      W X g  h i k    m n o q    s v y |         ! " # $ % & ' ( ) * + u x { ~ , - . / 2 3 4 5 6 7 8 9 ; < = > DE=>KNOLMABFGHI  = > H I K L M N O ? @ A C E F G B D     P  Q R   ] ^ _ ` a      W X g  h i k    m n o q    s v y |         ! " # $ % & ' ( ) * + u x { ~ , - . / 2 3 4 5 6 7 8 9 F ; < = > G H IJDE=>HIKLMNO?@ACEFGBDUPQR]^_`a     WXghikmnoqsvy| !"#$%&'()*+ux{~,-./23456789;<=>bcdef=>KNOLMABbcdefDE=>KNOLMAB=>HIKLMNO?@ACEFGBDUPQR]^_`a     bcdefWXghikmnoqsvy| !"#$%&'()*+ux{~,-./0123456789;<=>KLMNOPQRSTUVWXYZ[Z\]^]_`abcdef g h i j k l m n o p q r s t u v w x y z { | } ~     LL   vector-0.7.1Data.Vector.Storable.MutableData.Vector.Primitive.MutableData.Vector.Storable.InternalData.Vector.Fusion.UtilData.Vector.Fusion.Stream.SizeData.Vector.Internal.Check!Data.Vector.Fusion.Stream.MonadicData.Vector.Fusion.StreamData.Vector.Generic.MutableData.Vector.GenericData.Vector.Generic.NewData.Vector.PrimitiveData.Vector.StorableData.Vector.UnboxedData.Vector.Unboxed.MutableData.Vector.Mutable Data.VectorData.Vector.Generic.BaseData.Vector.Unboxed.BasebaseForeign.StorableStorableprimitive-0.3.1Data.Primitive.TypesPrim ptrToOffset offsetToPtrBoxunBoxIdunId delay_inline delayed_minSizeUnknownMaxExactsmallerlargertoMax upperBoundChecksInternalUnsafeBoundsdoCheckserror emptyStreamcheckassert checkIndex checkLength checkSliceStreamStepDoneSkipYieldsizesizedlengthnullempty singleton replicate replicateMgenerate generateMconssnoc++headlast!!sliceinittailtakedropmapmapMmapM_transunboxindexedindexedRzipWithM zipWithM_ zipWith3M zipWith4M zipWith5M zipWith6MzipWithzipWith3zipWith4zipWith5zipWith6zipzip3zip4zip5zip6filterfilterM takeWhile takeWhileM dropWhile dropWhileMelemnotElemfindfindM findIndex findIndexMfoldlfoldlMfoldMfoldl1foldl1Mfold1Mfoldl'foldlM'foldM'foldl1'foldl1M'fold1M'foldrfoldrMfoldr1foldr1Mandor concatMap concatMapMflattenunfoldrunfoldrMunfoldrN unfoldrNM iterateNMiterateNprescanl prescanlM prescanl' prescanlM' postscanl postscanlM postscanl' postscanlM'scanlscanlMscanl'scanlM'scanl1scanl1Mscanl1'scanl1M' enumFromStepN enumFromToenumFromThenTotoListfromList fromListNunsafeFromListMStreaminplace liftStreameqcmpMVector basicLengthbasicUnsafeSlice basicOverlapsbasicUnsafeNewbasicUnsafeReplicatebasicUnsafeReadbasicUnsafeWrite basicClearbasicSetbasicUnsafeCopybasicUnsafeMovebasicUnsafeGrowbasicUnsafeNewWithfill transformfillR transformRunstream munstream unstreamR munstreamRsplitAt unsafeSlice unsafeInit unsafeTail unsafeTake unsafeDropoverlapsnew unsafeNewclonegrow unsafeGrowclearreadwriteswap unsafeRead unsafeWrite unsafeSwapsetcopymove unsafeCopy unsafeMoveaccumupdate unsafeAccum unsafeUpdatereverseunstablePartitionunstablePartitionStreampartitionStreamnewWith unsafeNewWithVectorbasicUnsafeFreezebasicUnsafeThawbasicUnsafeIndexMelemseqMutableNewcreaterunapplymodifymodifyWithStream!!? unsafeIndex unsafeHead unsafeLastindexMheadMlastM unsafeIndexM unsafeHeadM unsafeLastM enumFromNconcatforce//update_ unsafeUpd unsafeUpdate_ accumulate accumulate_unsafeAccumulateunsafeAccumulate_ backpermuteunsafeBackpermuteimapforMforM_izipWith izipWith3 izipWith4 izipWith5 izipWith6unzipunzip3unzip4unzip5unzip6ifilter partitionspanbreak findIndices elemIndex elemIndicesfoldr'foldr1'ifoldlifoldl'ifoldrifoldr'allanysumproductmaximum maximumByminimum minimumBymaxIndex maxIndexByminIndex minIndexByfoldM_fold1M_foldM'_fold1M'_sequence sequence_prescanr prescanr' postscanr postscanr'scanrscanr'scanr1scanr1'convert unsafeFreeze unsafeThawthawfreezestreamstreamRgfoldlmkTypedataCastSTVectorIOVector unsafeCastunsafeFromForeignPtrunsafeToForeignPtr unsafeWithUnboxdistance GHC.Classesmin lowerBounddoBoundsChecksdoUnsafeChecksdoInternalChecks assert_msgcheckIndex_msgcheckLength_msgcheckSlice_msg DropWhileDropWhile_NextDropWhile_YieldDropWhile_DropSPECSPEC2consume Data.MaybeJustNothingenumFromTo_smallenumFromTo_intenumFromTo_big_wordenumFromTo_big_intenumFromTo_charenumFromTo_doubletoListFB unsafeAppend1unsafePrepend1mstreammstreamR munstreamMaxmunstreamUnknown munstreamRMaxmunstreamRUnknown growFrontenlarge enlargeFrontunsafeGrowFrontexchangeunsafeExchangeunstablePartitionMax partitionMaxpartitionUnknown update_streamunsafeUpdate_stream accum_streamunsafeAccum_streampartition_streamunstablePartition_streamunstablePartition_newghc-prim GHC.TypesTruediscard unstreamM unstreamPrimMunstreamPrimM_IOunstreamPrimM_STEqOrd mallocVectorGHC.ForeignPtr ForeignPtrvectorTyfromBooltoBoolV_6MV_6V_5MV_5V_4MV_4V_3MV_3V_2MV_2 V_Complex MV_ComplexV_BoolMV_BoolV_CharMV_CharV_Double MV_DoubleV_FloatMV_FloatV_Word64 MV_Word64V_Word32 MV_Word32V_Word16 MV_Word16V_Word8MV_Word8V_WordMV_WordV_Int64MV_Int64V_Int32MV_Int32V_Int16MV_Int16V_Int8MV_Int8V_IntMV_IntV_UnitMV_UnitIO moveBackwardsmoveForwardsSmallOverlapmoveForwardsLargeOverlaploopM uninitialised