import Foreign.Ptr
import Foreign.Storable
-import GHC.List ( null )
import GHC.Base
import GHC.IOBase
import GHC.STRef ( STRef(..) )
-- attached to is kept alive.
data ForeignPtrContents
- = PlainForeignPtr !(IORef [IO ()])
- | MallocPtr (MutableByteArray# RealWorld) !(IORef [IO ()])
+ = PlainNoFinalizer
+ | PlainWithFinalizer !(IORef [IO ()])
+ | MallocPtrNoFinalizer (MutableByteArray# RealWorld)
+ | MallocPtrWithFinalizer (MutableByteArray# RealWorld) !(IORef [IO ()])
+ -- we optimise the no-finalizer case, which is especially common
+ -- with a MallocPtr. mallocForeignPtr doesn't have to create an
+ -- IORef, or set up a weak pointer.
instance Eq (ForeignPtr a) where
p == q = unsafeForeignPtrToPtr p == unsafeForeignPtrToPtr q
mallocForeignPtr = doMalloc undefined
where doMalloc :: Storable b => b -> IO (ForeignPtr b)
doMalloc a = do
- r <- newIORef []
IO $ \s ->
case newPinnedByteArray# size s of { (# s, mbarr# #) ->
(# s, ForeignPtr (byteArrayContents# (unsafeCoerce# mbarr#))
- (MallocPtr mbarr# r) #)
+ (MallocPtrNoFinalizer mbarr#) #)
}
where (I# size) = sizeOf a
-- size of the memory required is given explicitly as a number of bytes.
mallocForeignPtrBytes :: Int -> IO (ForeignPtr a)
mallocForeignPtrBytes (I# size) = do
- r <- newIORef []
IO $ \s ->
case newPinnedByteArray# size s of { (# s, mbarr# #) ->
(# s, ForeignPtr (byteArrayContents# (unsafeCoerce# mbarr#))
- (MallocPtr mbarr# r) #)
+ (MallocPtrNoFinalizer mbarr#) #)
}
addForeignPtrFinalizer :: FinalizerPtr a -> ForeignPtr a -> IO ()
addForeignPtrConcFinalizer (ForeignPtr a c) finalizer =
addForeignPtrConcFinalizer_ c finalizer
-addForeignPtrConcFinalizer_ f@(PlainForeignPtr r) finalizer = do
- fs <- readIORef r
- writeIORef r (finalizer : fs)
- if (null fs)
- then IO $ \s ->
- case r of { IORef (STRef r#) ->
+addForeignPtrConcFinalizer_ PlainNoFinalizer finalizer = do
+ r <- newIORef []
+ IO $ \s -> case r of { IORef (STRef r#) ->
case mkWeak# r# () (foreignPtrFinalizer r) s of { (# s1, w #) ->
(# s1, () #) }}
- else return ()
-addForeignPtrConcFinalizer_ f@(MallocPtr fo r) finalizer = do
+ addForeignPtrConcFinalizer_ (PlainWithFinalizer r) finalizer
+
+addForeignPtrConcFinalizer_ f@(PlainWithFinalizer r) finalizer = do
fs <- readIORef r
writeIORef r (finalizer : fs)
- if (null fs)
- then IO $ \s ->
- case mkWeak# fo () (do foreignPtrFinalizer r; touch f) s of
+
+addForeignPtrConcFinalizer_ f@(MallocPtrNoFinalizer fo) finalizer = do
+ r <- newIORef []
+ IO $ \s -> case mkWeak# fo () (do foreignPtrFinalizer r; touch f) s of
(# s1, w #) -> (# s1, () #)
- else return ()
+ addForeignPtrConcFinalizer_ (MallocPtrWithFinalizer fo r) finalizer
+
+addForeignPtrConcFinalizer_ f@(MallocPtrWithFinalizer fo r) finalizer = do
+ fs <- readIORef r
+ writeIORef r (finalizer : fs)
foreign import ccall "dynamic"
mkFinalizer :: FinalizerPtr a -> Ptr a -> IO ()
newForeignPtr_ :: Ptr a -> IO (ForeignPtr a)
-- ^Turns a plain memory reference into a foreign pointer that may be
-- associated with finalizers by using 'addForeignPtrFinalizer'.
-newForeignPtr_ (Ptr obj) = do
- r <- newIORef []
- return (ForeignPtr obj (PlainForeignPtr r))
+newForeignPtr_ (Ptr obj) = return (ForeignPtr obj PlainNoFinalizer)
touchForeignPtr :: ForeignPtr a -> IO ()
-- ^This function ensures that the foreign object in
-- | Causes the finalizers associated with a foreign pointer to be run
-- immediately.
finalizeForeignPtr :: ForeignPtr a -> IO ()
-finalizeForeignPtr (ForeignPtr _ foreignPtr) = do
- finalizers <- readIORef refFinalizers
- sequence_ finalizers
- writeIORef refFinalizers []
- where
- refFinalizers = case foreignPtr of
- (PlainForeignPtr ref) -> ref
- (MallocPtr _ ref) -> ref
+finalizeForeignPtr (ForeignPtr _ contents) = do
+ case contents of
+ PlainNoFinalizer -> return ()
+ PlainWithFinalizer r -> runFinalizers r
+ MallocPtrNoFinalizer _ -> return ()
+ MallocPtrWithFinalizer _ r -> runFinalizers r
+ where
+ runFinalizers r = do
+ fs <- readIORef r
+ sequence_ fs
+ writeIORef r []