@@ -16,6 +16,8 @@ module Data.Aeson
1616 -- * Encoding and decoding
1717 decode
1818 , decode'
19+ , eitherDecode
20+ , eitherDecode'
1921 , encode
2022 -- * Core JSON types
2123 , Value(..)
@@ -40,7 +42,7 @@ module Data.Aeson
4042 ) where
4143
4244import Data.Aeson.Encode (encode)
43−import Data.Aeson.Parser.Internal (decodeWith, json, json')
45+import Data.Aeson.Parser.Internal (decodeWith, eitherDecodeWith, json, json')
4446import Data.Aeson.Types
4547import qualified Data.ByteString.Lazy as L
4648
@@ -63,3 +65,13 @@ decode = decodeWith json fromJSON
6365decode' :: (FromJSON a) => L.ByteString -> Maybe a
6466decode' = decodeWith json' fromJSON
6567{-# INLINE decode' #-}
68+
69+-- | Like 'decode' but returns an error message when decoding fails.
70+eitherDecode :: (FromJSON a) => L.ByteString -> Either String a
71+eitherDecode = eitherDecodeWith json fromJSON
72+{-# INLINE eitherDecode #-}
73+
74+-- | Like 'decode'' but returns an error message when decoding fails.
75+eitherDecode' :: (FromJSON a) => L.ByteString -> Either String a
76+eitherDecode' = eitherDecodeWith json' fromJSON
77+{-# INLINE eitherDecode' #-}