safe
Library of safe (exception free) functions
https://github.com/ndmitchell/safe#readme
| Version on this page: | 0.3.14 |
| LTS Haskell 23.24: | 0.3.21@rev:1 |
| Stackage Nightly 2025-05-28: | 0.3.21@rev:1 |
| Latest on Hackage: | 0.3.21@rev:1 |
This version can be pinned in stack with:
safe-0.3.14@sha256:0a70fb47f2dd6ac44a77bf99b2c41f5d4ceb23bab88f5654c2661e64ec550d55,2193Module documentation for 0.3.14
Depends on 1 package(full list with versions):
Used by 50 packages in lts-8.1(full list with versions):
avers, bake, basic-prelude, BlogLiterately-diagrams, conduit-parse, convert-annotation, cubicspline, dns, errors, fay, fay-builder, ghc-mod, ginger, graph-core, haskell-gi, haskell-tools-backend-ghc, hledger, hledger-api, hledger-lib, hledger-ui, hledger-web, hmt, hpc-coveralls, hw-bits, hw-excess, hw-rankselect-base, intro, jmacro, jose, kawhi, mbox, microformats2-parser, pager, protolude, pure-io, quickbench, rest-core, rest-gen, rest-snap, rss-conduit, and many more
Safe 
A library wrapping Prelude/Data.List functions that can throw exceptions, such as head and !!. Each unsafe function has up to four variants, e.g. with tail:
- tail :: [a] -> [a], raises an error on
tail []. - tailMay :: [a] -> Maybe [a], turns errors into
Nothing. - tailDef :: [a] -> [a] -> [a], takes a default to return on errors.
- tailNote :: String -> [a] -> [a], takes an extra argument which supplements the error message.
- tailSafe :: [a] -> [a], returns some sensible default if possible,
[]in the case oftail.
This package is divided into three modules:
Safecontains safe variants ofPreludeandData.Listfunctions.Safe.Foldablecontains safe variants ofFoldablefunctions.Safe.Exactcreates crashing versions of functions likezip(errors if the lists are not equal) andtake(errors if there are not enough elements), then wraps them to provide safe variants.