regions: Provides the region monad for safely opening and working with scarce resources.

[ bsd3, control, library, monadic-regions ] [ Propose Tags ] [ Report a vulnerability ]

This package provides the region monad transformer. Scarce resources like files, memory pointers or USB devices for example can be opened in a region. When the region terminates, all opened resources will be automatically closed. The main advantage of regions is that the opened resources can not be returned from the region which ensures no I/O with closed resources is possible.

The primary technique used in this package is called "Lightweight monadic regions" which was invented by Oleg Kiselyov and Chung-chieh Shan. See:

http://okmij.org/ftp/Haskell/regions.html#light-weight

Also see the regions-mtl and regions-monadstf packages which provide instances for the classes in the respected monad transformers packages.

For an example on how to use this library see the safer-file-handles, usb-safe or regional-pointers packages.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1, 0.1.0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.6.0.1, 0.7, 0.7.0.1, 0.8, 0.8.1, 0.9, 0.10, 0.11
Change log NEWS
Dependencies base (>=4 && <4.5), base-unicode-symbols (>=0.1.1 && <0.3), monad-control (>=0.2 && <0.3), transformers (>=0.2 && <0.3) [details]
License BSD-3-Clause
Copyright 2009-2011 Bas van Dijk
Author Bas van Dijk
Maintainer Bas van Dijk <v.dijk.bas@gmail.com>
Category Control, Monadic Regions
Home page https://github.com/basvandijk/regions/
Bug tracker https://github.com/basvandijk/regions/issues
Source repo head: git clone git://github.com/basvandijk/regions.git
Uploaded by BasVanDijk at 2011-09-23T10:09:53Z
Distributions
Reverse Dependencies 10 direct, 0 indirect [details]
Downloads 12474 total (7 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]

Readme for regions-0.11

[back to package description]

This package provides the region monad transformer. Scarce resources like files, memory pointers or USB devices for example can be opened in a region. When the region terminates, all opened resources will be automatically closed. The main advantage of regions is that the opened resources can not be returned from the region which ensures no I/O with closed resources is possible.

The primary technique used in this package is called "Lightweight monadic regions" which was invented by Oleg Kiselyov and Chung-chieh Shan.

Also see the regions-mtl and regions-monadstf packages which provide instances for the classes in the respected monad transformers packages.

For an example on how to use this library see the safer-file-handles, usb-safe or regional-pointers packages.