Allocate an Array of the given size and run an IO action passing the array start pointer.

Allocate an array that can hold count items. The memory of the array is uninitialized.

Note that this is internal routine, the reference to this array cannot be given out until the array has been written to and frozen.

Create an Array from a list. The list must be of finite size.

Since: 0.7.0

Create an Array from the first N elements of a list. The array is allocated to size N, if the list terminates before N elements then the array may hold less than N elements.

Since: 0.7.0

fromStreamArraysOf n stream groups the input stream into a stream of arrays of size n.

Coalesce adjacent arrays in incoming stream to form bigger arrays of a maximum specified size. Note that if a single array is bigger than the specified size we do not split it to fit. When we coalesce multiple arrays if the size would exceed the specified size we do not coalesce therefore the actual array size may be less than the specified chunk size.

Since: 0.7.0

groupIOVecsOf maxBytes maxEntries groups arrays in the incoming stream to create a stream of IOVec arrays with a maximum of maxBytes bytes in each array and a maximum of maxEntries entries in each array.

Since: 0.7.0

Split a stream of arrays on a given separator byte, dropping the separator and coalescing all the arrays between two separators into a single array.

Since: 0.7.0

Return element at the specified index without checking the bounds.

Unsafe because it does not check the bounds of the array.

Return element at the specified index without checking the bounds.

O(1) Get the length of the array i.e. the number of elements in the array.

Since: 0.7.0

O(1) Get the byte length of the array.

Since: 0.7.0

Create two slices of an array without copying the original array. The specified index i is the first index of the second slice.

Since: 0.7.0

Convert an Array into a list.

Since: 0.7.0

writeN n folds a maximum of n elements from the input stream to an Array.

Since: 0.7.0

Like writeN but does not check the array bounds when writing. The fold driver must not call the step function more than n times otherwise it will corrupt the memory and crash. This function exists mainly because any conditional in the step function blocks fusion causing 10x performance slowdown.

Since: 0.7.0

writeNAligned alignment n folds a maximum of n elements from the input stream to an Array aligned to the given size.

Internal

writeNAlignedUnmanaged n folds a maximum of n elements from the input stream to an Array aligned to the given size and using unmanaged memory. This could be useful to allocate memory that we need to allocate only once in the lifetime of the program.

Internal

Fold the whole input to a single array.

Caution! Do not use this on infinite streams.

Since: 0.7.0

Like write but the array memory is aligned according to the specified alignment size. This could be useful when we have specific alignment, for example, cache aligned arrays for lookup table etc.

Caution! Do not use this on infinite streams.

Since: 0.7.0

Default maximum buffer size in bytes, for reading from and writing to IO devices, the value is 32KB minus GHC allocation overhead, which is a few bytes, so that the actual allocation is 32KB.

Remove the free space from an Array.