<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>Control/Exception/Lifted.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE CPP <a name="line-2"></a> , UnicodeSyntax <a name="line-3"></a> , NoImplicitPrelude <a name="line-4"></a> , ExistentialQuantification <a name="line-5"></a> , FlexibleContexts <a name="line-6"></a> #-}</span> <a name="line-7"></a> <a name="line-8"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0)</span> <a name="line-9"></a><span class='hs-comment'>{-# LANGUAGE RankNTypes #-}</span> <span class='hs-comment'>-- for mask</span> <a name="line-10"></a><span class='hs-cpp'>#endif</span> <a name="line-11"></a> <a name="line-12"></a><span class='hs-comment'>{- | <a name="line-13"></a>Module : Control.Exception.Lifted <a name="line-14"></a>Copyright : Bas van Dijk, Anders Kaseorg <a name="line-15"></a>License : BSD-style <a name="line-16"></a> <a name="line-17"></a>Maintainer : Bas van Dijk <v.dijk.bas@gmail.com> <a name="line-18"></a>Stability : experimental <a name="line-19"></a>Portability : non-portable (extended exceptions) <a name="line-20"></a> <a name="line-21"></a>This is a wrapped version of @Control.Exception@ with types generalized <a name="line-22"></a>from @IO@ to all monads in either 'MonadBase' or 'MonadBaseControl'. <a name="line-23"></a>-}</span> <a name="line-24"></a> <a name="line-25"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span><span class='hs-varop'>.</span><span class='hs-conid'>Lifted</span> <a name="line-26"></a> <span class='hs-layout'>(</span> <span class='hs-keyword'>module</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <a name="line-27"></a> <a name="line-28"></a> <span class='hs-comment'>-- * Throwing exceptions</span> <a name="line-29"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>throwIO</span><span class='hs-layout'>,</span> <span class='hs-varid'>ioError</span> <a name="line-30"></a> <a name="line-31"></a> <span class='hs-comment'>-- * Catching exceptions</span> <a name="line-32"></a> <span class='hs-comment'>-- ** The @catch@ functions</span> <a name="line-33"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>catch</span><span class='hs-layout'>,</span> <span class='hs-varid'>catches</span><span class='hs-layout'>,</span> <span class='hs-conid'>Handler</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>catchJust</span> <a name="line-34"></a> <a name="line-35"></a> <span class='hs-comment'>-- ** The @handle@ functions</span> <a name="line-36"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>handle</span><span class='hs-layout'>,</span> <span class='hs-varid'>handleJust</span> <a name="line-37"></a> <a name="line-38"></a> <span class='hs-comment'>-- ** The @try@ functions</span> <a name="line-39"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>try</span><span class='hs-layout'>,</span> <span class='hs-varid'>tryJust</span> <a name="line-40"></a> <a name="line-41"></a> <span class='hs-comment'>-- ** The @evaluate@ function</span> <a name="line-42"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>evaluate</span> <a name="line-43"></a> <a name="line-44"></a> <span class='hs-comment'>-- * Asynchronous Exceptions</span> <a name="line-45"></a> <span class='hs-comment'>-- ** Asynchronous exception control</span> <a name="line-46"></a> <span class='hs-comment'>-- |The following functions allow a thread to control delivery of</span> <a name="line-47"></a> <span class='hs-comment'>-- asynchronous exceptions during a critical region.</span> <a name="line-48"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0)</span> <a name="line-49"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>mask</span><span class='hs-layout'>,</span> <span class='hs-varid'>mask_</span> <a name="line-50"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>uninterruptibleMask</span><span class='hs-layout'>,</span> <span class='hs-varid'>uninterruptibleMask_</span> <a name="line-51"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getMaskingState</span> <a name="line-52"></a><span class='hs-cpp'>#else</span> <a name="line-53"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>block</span><span class='hs-layout'>,</span> <span class='hs-varid'>unblock</span> <a name="line-54"></a><span class='hs-cpp'>#endif</span> <a name="line-55"></a> <a name="line-56"></a><span class='hs-cpp'>#if !MIN_VERSION_base(4,4,0)</span> <a name="line-57"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>blocked</span> <a name="line-58"></a><span class='hs-cpp'>#endif</span> <a name="line-59"></a> <span class='hs-comment'>-- * Brackets</span> <a name="line-60"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>bracket</span><span class='hs-layout'>,</span> <span class='hs-varid'>bracket_</span><span class='hs-layout'>,</span> <span class='hs-varid'>bracketOnError</span> <a name="line-61"></a> <a name="line-62"></a> <span class='hs-comment'>-- * Utilities</span> <a name="line-63"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>finally</span><span class='hs-layout'>,</span> <span class='hs-varid'>onException</span> <a name="line-64"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-65"></a> <a name="line-66"></a> <a name="line-67"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-68"></a><span class='hs-comment'>-- Imports</span> <a name="line-69"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-70"></a> <a name="line-71"></a><span class='hs-comment'>-- from base:</span> <a name="line-72"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Function</span> <span class='hs-layout'>(</span> <span class='hs-layout'>(</span><span class='hs-varop'>$</span><span class='hs-layout'>)</span> <span class='hs-layout'>)</span> <a name="line-73"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Either</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Either</span><span class='hs-layout'>(</span><span class='hs-conid'>Left</span><span class='hs-layout'>,</span> <span class='hs-conid'>Right</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>either</span> <span class='hs-layout'>)</span> <a name="line-74"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Maybe</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Maybe</span> <span class='hs-layout'>)</span> <a name="line-75"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Monad</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>>>=</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>return</span><span class='hs-layout'>,</span> <span class='hs-varid'>liftM</span> <span class='hs-layout'>)</span> <a name="line-76"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Error</span> <span class='hs-layout'>(</span> <span class='hs-conid'>IOError</span> <span class='hs-layout'>)</span> <a name="line-77"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span> <span class='hs-conid'>IO</span> <span class='hs-layout'>)</span> <a name="line-78"></a> <a name="line-79"></a><span class='hs-cpp'>#if __GLASGOW_HASKELL__ < 700</span> <a name="line-80"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span> <span class='hs-varid'>fail</span> <span class='hs-layout'>)</span> <a name="line-81"></a><span class='hs-cpp'>#endif</span> <a name="line-82"></a> <a name="line-83"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <span class='hs-varid'>hiding</span> <a name="line-84"></a> <span class='hs-layout'>(</span> <span class='hs-varid'>throwIO</span><span class='hs-layout'>,</span> <span class='hs-varid'>ioError</span> <a name="line-85"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>catch</span><span class='hs-layout'>,</span> <span class='hs-varid'>catches</span><span class='hs-layout'>,</span> <span class='hs-conid'>Handler</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>catchJust</span> <a name="line-86"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>handle</span><span class='hs-layout'>,</span> <span class='hs-varid'>handleJust</span> <a name="line-87"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>try</span><span class='hs-layout'>,</span> <span class='hs-varid'>tryJust</span> <a name="line-88"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>evaluate</span> <a name="line-89"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0)</span> <a name="line-90"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>mask</span><span class='hs-layout'>,</span> <span class='hs-varid'>mask_</span> <a name="line-91"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>uninterruptibleMask</span><span class='hs-layout'>,</span> <span class='hs-varid'>uninterruptibleMask_</span> <a name="line-92"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getMaskingState</span> <a name="line-93"></a><span class='hs-cpp'>#else</span> <a name="line-94"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>block</span><span class='hs-layout'>,</span> <span class='hs-varid'>unblock</span> <a name="line-95"></a><span class='hs-cpp'>#endif</span> <a name="line-96"></a><span class='hs-cpp'>#if !MIN_VERSION_base(4,4,0)</span> <a name="line-97"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>blocked</span> <a name="line-98"></a><span class='hs-cpp'>#endif</span> <a name="line-99"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>bracket</span><span class='hs-layout'>,</span> <span class='hs-varid'>bracket_</span><span class='hs-layout'>,</span> <span class='hs-varid'>bracketOnError</span> <a name="line-100"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>finally</span><span class='hs-layout'>,</span> <span class='hs-varid'>onException</span> <a name="line-101"></a> <span class='hs-layout'>)</span> <a name="line-102"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>E</span> <a name="line-103"></a> <a name="line-104"></a><span class='hs-cpp'>#if !MIN_VERSION_base(4,4,0)</span> <a name="line-105"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Bool</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Bool</span> <span class='hs-layout'>)</span> <a name="line-106"></a><span class='hs-cpp'>#endif</span> <a name="line-107"></a> <a name="line-108"></a><span class='hs-comment'>-- from base-unicode-symbols:</span> <a name="line-109"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Function</span><span class='hs-varop'>.</span><span class='hs-conid'>Unicode</span> <span class='hs-layout'>(</span> <span class='hs-layout'>(</span><span class='hs-sel'>∘</span><span class='hs-layout'>)</span> <span class='hs-layout'>)</span> <a name="line-110"></a> <a name="line-111"></a><span class='hs-comment'>-- from transformers-base:</span> <a name="line-112"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Base</span> <span class='hs-layout'>(</span> <span class='hs-conid'>MonadBase</span><span class='hs-layout'>,</span> <span class='hs-varid'>liftBase</span> <span class='hs-layout'>)</span> <a name="line-113"></a> <a name="line-114"></a><span class='hs-comment'>-- from monad-control:</span> <a name="line-115"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Trans</span><span class='hs-varop'>.</span><span class='hs-conid'>Control</span> <span class='hs-layout'>(</span> <span class='hs-conid'>MonadBaseControl</span><span class='hs-layout'>,</span> <span class='hs-conid'>StM</span> <a name="line-116"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>liftBaseWith</span><span class='hs-layout'>,</span> <span class='hs-varid'>restoreM</span> <a name="line-117"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>control</span><span class='hs-layout'>,</span> <span class='hs-varid'>liftBaseOp_</span> <a name="line-118"></a> <span class='hs-layout'>)</span> <a name="line-119"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0) || defined (__HADDOCK__)</span> <a name="line-120"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Trans</span><span class='hs-varop'>.</span><span class='hs-conid'>Control</span> <span class='hs-layout'>(</span> <span class='hs-varid'>liftBaseOp</span> <span class='hs-layout'>)</span> <a name="line-121"></a><span class='hs-cpp'>#endif</span> <a name="line-122"></a> <a name="line-123"></a><span class='hs-cpp'>#include "inlinable.h"</span> <a name="line-124"></a> <a name="line-125"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-126"></a><span class='hs-comment'>-- * Throwing exceptions</span> <a name="line-127"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-128"></a> <a name="line-129"></a><a name="throwIO"></a><span class='hs-comment'>-- |Generalized version of 'E.throwIO'.</span> <a name="line-130"></a><span class='hs-definition'>throwIO</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBase</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-131"></a><span class='hs-definition'>throwIO</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBase</span> <span class='hs-sel'>∘</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>throwIO</span> <a name="line-132"></a><span class='hs-comment'>{-# INLINABLE throwIO #-}</span> <a name="line-133"></a> <a name="line-134"></a><a name="ioError"></a><span class='hs-comment'>-- |Generalized version of 'E.ioError'.</span> <a name="line-135"></a><span class='hs-definition'>ioError</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBase</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-conid'>IOError</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-136"></a><span class='hs-definition'>ioError</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBase</span> <span class='hs-sel'>∘</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>ioError</span> <a name="line-137"></a><span class='hs-comment'>{-# INLINABLE ioError #-}</span> <a name="line-138"></a> <a name="line-139"></a> <a name="line-140"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-141"></a><span class='hs-comment'>-- * Catching exceptions</span> <a name="line-142"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-143"></a> <a name="line-144"></a><a name="catch"></a><span class='hs-comment'>-- |Generalized version of 'E.catch'.</span> <a name="line-145"></a><span class='hs-definition'>catch</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <a name="line-146"></a> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-comment'>-- ^ The computation to run</span> <a name="line-147"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ Handler to invoke if an exception is raised</span> <a name="line-148"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-149"></a><span class='hs-definition'>catch</span> <span class='hs-varid'>a</span> <span class='hs-varid'>handler</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-150"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>catch</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-151"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>handler</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <a name="line-152"></a><span class='hs-comment'>{-# INLINABLE catch #-}</span> <a name="line-153"></a> <a name="line-154"></a><a name="catches"></a><span class='hs-comment'>-- |Generalized version of 'E.catches'.</span> <a name="line-155"></a><span class='hs-definition'>catches</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Handler</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-keyglyph'>]</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-156"></a><span class='hs-definition'>catches</span> <span class='hs-varid'>a</span> <span class='hs-varid'>handlers</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-157"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>catches</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-158"></a> <span class='hs-keyglyph'>[</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-conid'>Handler</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>handler</span> <span class='hs-varid'>e</span> <a name="line-159"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Handler</span> <span class='hs-varid'>handler</span> <span class='hs-sel'>←</span> <span class='hs-varid'>handlers</span> <a name="line-160"></a> <span class='hs-keyglyph'>]</span> <a name="line-161"></a><span class='hs-comment'>{-# INLINABLE catches #-}</span> <a name="line-162"></a> <a name="line-163"></a><a name="Handler"></a><span class='hs-comment'>-- |Generalized version of 'E.Handler'.</span> <a name="line-164"></a><a name="Handler"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Handler</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-keyglyph'>=</span> <span class='hs-sel'>∀</span> <span class='hs-varid'>e</span><span class='hs-varop'>.</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span> <span class='hs-sel'>⇒</span> <span class='hs-conid'>Handler</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <a name="line-165"></a> <a name="line-166"></a><a name="catchJust"></a><span class='hs-comment'>-- |Generalized version of 'E.catchJust'.</span> <a name="line-167"></a><span class='hs-definition'>catchJust</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <a name="line-168"></a> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-conid'>Maybe</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ Predicate to select exceptions</span> <a name="line-169"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-comment'>-- ^ Computation to run</span> <a name="line-170"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>β</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ Handler</span> <a name="line-171"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-172"></a><span class='hs-definition'>catchJust</span> <span class='hs-varid'>p</span> <span class='hs-varid'>a</span> <span class='hs-varid'>handler</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-173"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>catchJust</span> <span class='hs-varid'>p</span> <a name="line-174"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-175"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>handler</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-176"></a><span class='hs-comment'>{-# INLINABLE catchJust #-}</span> <a name="line-177"></a> <a name="line-178"></a> <a name="line-179"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-180"></a><span class='hs-comment'>-- ** The @handle@ functions</span> <a name="line-181"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-182"></a> <a name="line-183"></a><a name="handle"></a><span class='hs-comment'>-- |Generalized version of 'E.handle'.</span> <a name="line-184"></a><span class='hs-definition'>handle</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-185"></a><span class='hs-definition'>handle</span> <span class='hs-varid'>handler</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-186"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>handle</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>handler</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-187"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-188"></a><span class='hs-comment'>{-# INLINABLE handle #-}</span> <a name="line-189"></a> <a name="line-190"></a><a name="handleJust"></a><span class='hs-comment'>-- |Generalized version of 'E.handleJust'.</span> <a name="line-191"></a><span class='hs-definition'>handleJust</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <a name="line-192"></a> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-conid'>Maybe</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>β</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-193"></a><span class='hs-definition'>handleJust</span> <span class='hs-varid'>p</span> <span class='hs-varid'>handler</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-194"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>handleJust</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-layout'>(</span><span class='hs-varid'>handler</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <a name="line-195"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-196"></a><span class='hs-comment'>{-# INLINABLE handleJust #-}</span> <a name="line-197"></a> <a name="line-198"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-199"></a><span class='hs-comment'>-- ** The @try@ functions</span> <a name="line-200"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-201"></a> <a name="line-202"></a><a name="sequenceEither"></a><span class='hs-definition'>sequenceEither</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-conid'>Either</span> <span class='hs-varid'>e</span> <span class='hs-layout'>(</span><span class='hs-conid'>StM</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Either</span> <span class='hs-varid'>e</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <a name="line-203"></a><span class='hs-definition'>sequenceEither</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>either</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-sel'>∘</span> <span class='hs-conid'>Left</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftM</span> <span class='hs-conid'>Right</span> <span class='hs-sel'>∘</span> <span class='hs-varid'>restoreM</span><span class='hs-layout'>)</span> <a name="line-204"></a><span class='hs-comment'>{-# INLINE sequenceEither #-}</span> <a name="line-205"></a> <a name="line-206"></a><a name="try"></a><span class='hs-comment'>-- |Generalized version of 'E.try'.</span> <a name="line-207"></a><span class='hs-definition'>try</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Either</span> <span class='hs-varid'>e</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <a name="line-208"></a><span class='hs-definition'>try</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseWith</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>try</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>sequenceEither</span> <a name="line-209"></a><span class='hs-comment'>{-# INLINABLE try #-}</span> <a name="line-210"></a> <a name="line-211"></a><a name="tryJust"></a><span class='hs-comment'>-- |Generalized version of 'E.tryJust'.</span> <a name="line-212"></a><span class='hs-definition'>tryJust</span> <span class='hs-sel'>∷</span> <span class='hs-layout'>(</span><span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span><span class='hs-layout'>,</span> <span class='hs-conid'>Exception</span> <span class='hs-varid'>e</span><span class='hs-layout'>)</span> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-varid'>e</span> <span class='hs-sel'>→</span> <span class='hs-conid'>Maybe</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-layout'>(</span><span class='hs-conid'>Either</span> <span class='hs-varid'>β</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <a name="line-213"></a><span class='hs-definition'>tryJust</span> <span class='hs-varid'>p</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseWith</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>tryJust</span> <span class='hs-varid'>p</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>sequenceEither</span> <a name="line-214"></a><span class='hs-comment'>{-# INLINABLE tryJust #-}</span> <a name="line-215"></a> <a name="line-216"></a> <a name="line-217"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-218"></a><span class='hs-comment'>-- ** The @evaluate@ function</span> <a name="line-219"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-220"></a> <a name="line-221"></a><a name="evaluate"></a><span class='hs-comment'>-- |Generalized version of 'E.evaluate'.</span> <a name="line-222"></a><span class='hs-definition'>evaluate</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBase</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-223"></a><span class='hs-definition'>evaluate</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBase</span> <span class='hs-sel'>∘</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>evaluate</span> <a name="line-224"></a><span class='hs-comment'>{-# INLINABLE evaluate #-}</span> <a name="line-225"></a> <a name="line-226"></a> <a name="line-227"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-228"></a><span class='hs-comment'>-- ** Asynchronous exception control</span> <a name="line-229"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-230"></a> <a name="line-231"></a><span class='hs-cpp'>#if MIN_VERSION_base(4,3,0)</span> <a name="line-232"></a><a name="mask"></a><span class='hs-comment'>-- |Generalized version of 'E.mask'.</span> <a name="line-233"></a><span class='hs-definition'>mask</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-sel'>∀</span> <span class='hs-varid'>α</span><span class='hs-varop'>.</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span> <a name="line-234"></a><span class='hs-definition'>mask</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseOp</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>mask</span> <span class='hs-sel'>∘</span> <span class='hs-varid'>liftRestore</span> <a name="line-235"></a><span class='hs-comment'>{-# INLINABLE mask #-}</span> <a name="line-236"></a> <a name="line-237"></a><a name="liftRestore"></a><span class='hs-definition'>liftRestore</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <a name="line-238"></a> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-sel'>∀</span> <span class='hs-varid'>α</span><span class='hs-varop'>.</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <a name="line-239"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-sel'>∀</span> <span class='hs-varid'>α</span><span class='hs-varop'>.</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <a name="line-240"></a><span class='hs-definition'>liftRestore</span> <span class='hs-varid'>f</span> <span class='hs-varid'>r</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-varid'>liftBaseOp_</span> <span class='hs-varid'>r</span> <a name="line-241"></a><span class='hs-comment'>{-# INLINE liftRestore #-}</span> <a name="line-242"></a> <a name="line-243"></a><a name="mask_"></a><span class='hs-comment'>-- |Generalized version of 'E.mask_'.</span> <a name="line-244"></a><span class='hs-definition'>mask_</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-245"></a><span class='hs-definition'>mask_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseOp_</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>mask_</span> <a name="line-246"></a><span class='hs-comment'>{-# INLINABLE mask_ #-}</span> <a name="line-247"></a> <a name="line-248"></a><a name="uninterruptibleMask"></a><span class='hs-comment'>-- |Generalized version of 'E.uninterruptibleMask'.</span> <a name="line-249"></a><span class='hs-definition'>uninterruptibleMask</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-sel'>∀</span> <span class='hs-varid'>α</span><span class='hs-varop'>.</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span> <a name="line-250"></a><span class='hs-definition'>uninterruptibleMask</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseOp</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>uninterruptibleMask</span> <span class='hs-sel'>∘</span> <span class='hs-varid'>liftRestore</span> <a name="line-251"></a><span class='hs-comment'>{-# INLINABLE uninterruptibleMask #-}</span> <a name="line-252"></a> <a name="line-253"></a><a name="uninterruptibleMask_"></a><span class='hs-comment'>-- |Generalized version of 'E.uninterruptibleMask_'.</span> <a name="line-254"></a><span class='hs-definition'>uninterruptibleMask_</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-255"></a><span class='hs-definition'>uninterruptibleMask_</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseOp_</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>uninterruptibleMask_</span> <a name="line-256"></a><span class='hs-comment'>{-# INLINABLE uninterruptibleMask_ #-}</span> <a name="line-257"></a> <a name="line-258"></a><a name="getMaskingState"></a><span class='hs-comment'>-- |Generalized version of 'E.getMaskingState'.</span> <a name="line-259"></a><span class='hs-definition'>getMaskingState</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBase</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-conid'>MaskingState</span> <a name="line-260"></a><span class='hs-definition'>getMaskingState</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBase</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>getMaskingState</span> <a name="line-261"></a><span class='hs-comment'>{-# INLINABLE getMaskingState #-}</span> <a name="line-262"></a><span class='hs-cpp'>#else</span> <a name="line-263"></a><a name="block"></a><span class='hs-comment'>-- |Generalized version of 'E.block'.</span> <a name="line-264"></a><span class='hs-definition'>block</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-265"></a><span class='hs-definition'>block</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseOp_</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>block</span> <a name="line-266"></a><span class='hs-comment'>{-# INLINABLE block #-}</span> <a name="line-267"></a> <a name="line-268"></a><a name="unblock"></a><span class='hs-comment'>-- |Generalized version of 'E.unblock'.</span> <a name="line-269"></a><span class='hs-definition'>unblock</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-270"></a><span class='hs-definition'>unblock</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBaseOp_</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>unblock</span> <a name="line-271"></a><span class='hs-comment'>{-# INLINABLE unblock #-}</span> <a name="line-272"></a><span class='hs-cpp'>#endif</span> <a name="line-273"></a> <a name="line-274"></a><span class='hs-cpp'>#if !MIN_VERSION_base(4,4,0)</span> <a name="line-275"></a><a name="blocked"></a><span class='hs-comment'>-- | Generalized version of 'E.blocked'.</span> <a name="line-276"></a><span class='hs-comment'>-- returns @True@ if asynchronous exceptions are blocked in the</span> <a name="line-277"></a><span class='hs-comment'>-- current thread.</span> <a name="line-278"></a><span class='hs-definition'>blocked</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBase</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-conid'>Bool</span> <a name="line-279"></a><span class='hs-definition'>blocked</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftBase</span> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>blocked</span> <a name="line-280"></a><span class='hs-comment'>{-# INLINABLE blocked #-}</span> <a name="line-281"></a><span class='hs-cpp'>#endif</span> <a name="line-282"></a> <a name="line-283"></a> <a name="line-284"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-285"></a><span class='hs-comment'>-- * Brackets</span> <a name="line-286"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-287"></a> <a name="line-288"></a><a name="bracket"></a><span class='hs-comment'>-- |Generalized version of 'E.bracket'. Note, any monadic side</span> <a name="line-289"></a><span class='hs-comment'>-- effects in @m@ of the \"release\" computation will be discarded; it</span> <a name="line-290"></a><span class='hs-comment'>-- is run only for its side effects in @IO@.</span> <a name="line-291"></a><span class='hs-comment'>--</span> <a name="line-292"></a><span class='hs-comment'>-- Note that when your @acquire@ and @release@ computations are of type 'IO'</span> <a name="line-293"></a><span class='hs-comment'>-- it will be more efficient to write:</span> <a name="line-294"></a><span class='hs-comment'>--</span> <a name="line-295"></a><span class='hs-comment'>-- @'liftBaseOp' ('E.bracket' acquire release)@</span> <a name="line-296"></a><span class='hs-definition'>bracket</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <a name="line-297"></a> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-comment'>-- ^ computation to run first (\"acquire resource\")</span> <a name="line-298"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ computation to run last (\"release resource\")</span> <a name="line-299"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>γ</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ computation to run in-between</span> <a name="line-300"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>γ</span> <a name="line-301"></a><span class='hs-definition'>bracket</span> <span class='hs-varid'>before</span> <span class='hs-varid'>after</span> <span class='hs-varid'>thing</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-302"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>bracket</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>before</span><span class='hs-layout'>)</span> <a name="line-303"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>st</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>restoreM</span> <span class='hs-varid'>st</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>after</span><span class='hs-layout'>)</span> <a name="line-304"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>st</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>restoreM</span> <span class='hs-varid'>st</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>thing</span><span class='hs-layout'>)</span> <a name="line-305"></a><span class='hs-comment'>{-# INLINABLE bracket #-}</span> <a name="line-306"></a> <a name="line-307"></a><a name="bracket_"></a><span class='hs-comment'>-- |Generalized version of 'E.bracket_'. Note, any monadic side</span> <a name="line-308"></a><span class='hs-comment'>-- effects in @m@ of /both/ the \"acquire\" and \"release\"</span> <a name="line-309"></a><span class='hs-comment'>-- computations will be discarded. To keep the monadic side effects</span> <a name="line-310"></a><span class='hs-comment'>-- of the \"acquire\" computation, use 'bracket' with constant</span> <a name="line-311"></a><span class='hs-comment'>-- functions instead.</span> <a name="line-312"></a><span class='hs-comment'>--</span> <a name="line-313"></a><span class='hs-comment'>-- Note that when your @acquire@ and @release@ computations are of type 'IO'</span> <a name="line-314"></a><span class='hs-comment'>-- it will be more efficient to write:</span> <a name="line-315"></a><span class='hs-comment'>--</span> <a name="line-316"></a><span class='hs-comment'>-- @'liftBaseOp_' ('E.bracket_' acquire release)@</span> <a name="line-317"></a><span class='hs-definition'>bracket_</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <a name="line-318"></a> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-comment'>-- ^ computation to run first (\"acquire resource\")</span> <a name="line-319"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span> <span class='hs-comment'>-- ^ computation to run last (\"release resource\")</span> <a name="line-320"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>γ</span> <span class='hs-comment'>-- ^ computation to run in-between</span> <a name="line-321"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>γ</span> <a name="line-322"></a><span class='hs-definition'>bracket_</span> <span class='hs-varid'>before</span> <span class='hs-varid'>after</span> <span class='hs-varid'>thing</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-323"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>bracket_</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>before</span><span class='hs-layout'>)</span> <a name="line-324"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>after</span><span class='hs-layout'>)</span> <a name="line-325"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>thing</span><span class='hs-layout'>)</span> <a name="line-326"></a><span class='hs-comment'>{-# INLINABLE bracket_ #-}</span> <a name="line-327"></a> <a name="line-328"></a><a name="bracketOnError"></a><span class='hs-comment'>-- |Generalized version of 'E.bracketOnError'. Note, any monadic side</span> <a name="line-329"></a><span class='hs-comment'>-- effects in @m@ of the \"release\" computation will be discarded.</span> <a name="line-330"></a><span class='hs-comment'>--</span> <a name="line-331"></a><span class='hs-comment'>-- Note that when your @acquire@ and @release@ computations are of type 'IO'</span> <a name="line-332"></a><span class='hs-comment'>-- it will be more efficient to write:</span> <a name="line-333"></a><span class='hs-comment'>--</span> <a name="line-334"></a><span class='hs-comment'>-- @'liftBaseOp' ('E.bracketOnError' acquire release)@</span> <a name="line-335"></a><span class='hs-definition'>bracketOnError</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <a name="line-336"></a> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-comment'>-- ^ computation to run first (\"acquire resource\")</span> <a name="line-337"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ computation to run last (\"release resource\")</span> <a name="line-338"></a> <span class='hs-sel'>→</span> <span class='hs-layout'>(</span><span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>γ</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ computation to run in-between</span> <a name="line-339"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>γ</span> <a name="line-340"></a><span class='hs-definition'>bracketOnError</span> <span class='hs-varid'>before</span> <span class='hs-varid'>after</span> <span class='hs-varid'>thing</span> <span class='hs-keyglyph'>=</span> <a name="line-341"></a> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-342"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>bracketOnError</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>before</span><span class='hs-layout'>)</span> <a name="line-343"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>st</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>restoreM</span> <span class='hs-varid'>st</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>after</span><span class='hs-layout'>)</span> <a name="line-344"></a> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-varid'>st</span> <span class='hs-sel'>→</span> <span class='hs-varid'>runInIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>restoreM</span> <span class='hs-varid'>st</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>thing</span><span class='hs-layout'>)</span> <a name="line-345"></a><span class='hs-comment'>{-# INLINABLE bracketOnError #-}</span> <a name="line-346"></a> <a name="line-347"></a> <a name="line-348"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-349"></a><span class='hs-comment'>-- * Utilities</span> <a name="line-350"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-351"></a> <a name="line-352"></a><a name="finally"></a><span class='hs-comment'>-- |Generalized version of 'E.finally'. Note, any monadic side</span> <a name="line-353"></a><span class='hs-comment'>-- effects in @m@ of the \"afterward\" computation will be discarded.</span> <a name="line-354"></a><span class='hs-definition'>finally</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <a name="line-355"></a> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-comment'>-- ^ computation to run first</span> <a name="line-356"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span> <span class='hs-comment'>-- ^ computation to run afterward (even if an exception was raised)</span> <a name="line-357"></a> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-358"></a><span class='hs-definition'>finally</span> <span class='hs-varid'>a</span> <span class='hs-varid'>sequel</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-359"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>finally</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-360"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>sequel</span><span class='hs-layout'>)</span> <a name="line-361"></a><span class='hs-comment'>{-# INLINABLE finally #-}</span> <a name="line-362"></a> <a name="line-363"></a><a name="onException"></a><span class='hs-comment'>-- |Generalized version of 'E.onException'. Note, any monadic side</span> <a name="line-364"></a><span class='hs-comment'>-- effects in @m@ of the \"afterward\" computation will be discarded.</span> <a name="line-365"></a><span class='hs-definition'>onException</span> <span class='hs-sel'>∷</span> <span class='hs-conid'>MonadBaseControl</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>m</span> <span class='hs-sel'>⇒</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>β</span> <span class='hs-sel'>→</span> <span class='hs-varid'>m</span> <span class='hs-varid'>α</span> <a name="line-366"></a><span class='hs-definition'>onException</span> <span class='hs-varid'>m</span> <span class='hs-varid'>what</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>control</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>runInIO</span> <span class='hs-sel'>→</span> <a name="line-367"></a> <span class='hs-conid'>E</span><span class='hs-varop'>.</span><span class='hs-varid'>onException</span> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>m</span><span class='hs-layout'>)</span> <a name="line-368"></a> <span class='hs-layout'>(</span><span class='hs-varid'>runInIO</span> <span class='hs-varid'>what</span><span class='hs-layout'>)</span> <a name="line-369"></a><span class='hs-comment'>{-# INLINABLE onException #-}</span> </pre></body> </html>