------------------------------------------------------------------------------- |-- Module : Data.Array.Storable-- Copyright : (c) The University of Glasgow 2001-- License : BSD-style (see the file libraries/base/LICENSE)---- Maintainer : libraries@haskell.org-- Stability : experimental-- Portability : non-portable (uses Data.Array.MArray)---- A storable array is an IO-mutable array which stores its-- contents in a contiguous memory block living in the C-- heap. Elements are stored according to the class 'Storable'.-- You can obtain the pointer to the array contents to manipulate-- elements from languages like C.---- It is similar to 'Data.Array.IO.IOUArray' but slower.-- Its advantage is that it's compatible with C.-------------------------------------------------------------------------------moduleData.Array.Storable(-- * Arrays of 'Storable' things.StorableArray,-- data StorableArray index element-- + index type must be in class Ix-- + element type must be in class Storable-- * Overloaded mutable array interface-- | Module "Data.Array.MArray" provides the interface of storable arrays.-- They are instances of class 'MArray' (with the 'IO' monad).moduleData.Array.MArray,-- * Accessing the pointer to the array contentswithStorableArray,-- :: StorableArray i e -> (Ptr e -> IO a) -> IO atouchStorableArray,-- :: StorableArray i e -> IO ()unsafeForeignPtrToStorableArray)whereimportForeignhiding(newArray)importData.Array.MArrayimportData.Array.Storable.Internalshiding(unsafeForeignPtrToStorableArray)importqualifiedData.Array.UnsafeasU(unsafeForeignPtrToStorableArray){-# DEPRECATED unsafeForeignPtrToStorableArray
"Please import from Data.Array.Unsafe instead; This will be removed in the next release"
#-}-- |Construct a 'StorableArray' from an arbitrary 'ForeignPtr'. It is-- the caller's responsibility to ensure that the 'ForeignPtr' points to-- an area of memory sufficient for the specified bounds.{-# INLINE unsafeForeignPtrToStorableArray #-}unsafeForeignPtrToStorableArray::Ixi=>ForeignPtre->(i,i)->IO(StorableArrayie)unsafeForeignPtrToStorableArray=U.unsafeForeignPtrToStorableArray