Moduleaeson-2.3.2.0Haskell2010

Data.Aeson.Decoding

Conversion to and from aeson Value.

valuedecode :: FromJSON a => ByteString -> Maybe a

Efficiently deserialize a JSON value from a lazy L.ByteString. If this fails due to incomplete or invalid input, Nothing is returned.

valueeitherDecode :: FromJSON a => ByteString -> Either String a

Like decode but returns an error message when decoding fails.

valuethrowDecode :: (FromJSON a, MonadThrow m) => ByteString -> m a

Like decode but throws an AesonException when decoding fails.

throwDecode is in aeson since 2.1.2.0, but this variant is added later.

valuedecodeStrict :: FromJSON a => ByteString -> Maybe a

Efficiently deserialize a JSON value from a strict B.ByteString. If this fails due to incomplete or invalid input, Nothing is returned.

valueeitherDecodeStrict :: FromJSON a => ByteString -> Either String a

Like decodeStrict but returns an error message when decoding fails.

valuethrowDecodeStrict :: (FromJSON a, MonadThrow m) => ByteString -> m a

Like decodeStrict but throws an AesonException when decoding fails.

valuedecodeStrictText :: FromJSON a => Text -> Maybe a

Efficiently deserialize a JSON value from a strict Text. If this fails due to incomplete or invalid input, Nothing is returned.

valueeitherDecodeStrictText :: FromJSON a => Text -> Either String a

Like decodeStrictText but returns an error message when decoding fails.

valuethrowDecodeStrictText :: (FromJSON a, MonadThrow m) => Text -> m a

Like decodeStrictText but throws an AesonException when decoding fails.

valuetoEitherValue

Convert Tokens to Value.

The resulting value will be in normal form if its forced. In other words, there shouldn't be thunks inside.

valueunescapeText :: ByteString -> Either UnicodeException Text

Unescape JSON text literal.

This function is exported mostly for testing and benchmarking purposes.