array-0.3.0.3: Mutable and immutable arrays

Portabilitynon-portable (uses Data.Array.MArray)
Stabilityexperimental
Maintainerlibraries@haskell.org

Data.Array.IO

Contents

Description

Mutable boxed and unboxed arrays in the IO monad.

Synopsis

IO arrays with boxed elements

data IOArray i e

An IOArray is a mutable, boxed, non-strict array in the IO monad. The type arguments are as follows:

  • i: the index type of the array (should be an instance of Ix)
  • e: the element type of the array.

Instances

IO arrays with unboxed elements

data IOUArray i e Source

Mutable, unboxed, strict arrays in the IO monad. The type arguments are as follows:

  • i: the index type of the array (should be an instance of Ix)
  • e: the element type of the array. Only certain element types are supported: see Data.Array.MArray for a list of instances.

castIOUArray :: IOUArray ix a -> IO (IOUArray ix b)Source

Casts an IOUArray with one element type into one with a different element type. All the elements of the resulting array are undefined (unless you know what you're doing...).

Overloaded mutable array interface

Doing I/O with IOUArrays

hGetArraySource

Arguments

:: Handle

Handle to read from

-> IOUArray Int Word8

Array in which to place the values

-> Int

Number of Word8s to read

-> IO Int

Returns: the number of Word8s actually read, which might be smaller than the number requested if the end of file was reached.

Reads a number of Word8s from the specified Handle directly into an array.

hPutArraySource

Arguments

:: Handle

Handle to write to

-> IOUArray Int Word8

Array to write from

-> Int

Number of Word8s to write

-> IO () 

Writes an array of Word8 to the specified Handle.