aeson-0.9.0.1: Fast JSON parsing and encoding

Copyright | (c) 2012 Bryan O'Sullivan (c) 2011 MailRank, Inc.
License | Apache
Maintainer | Bryan O'Sullivan <bos@serpentine.com>
Stability | experimental
Portability | portable
Safe Haskell | None
Language | Haskell98

Data.Aeson.Encode

Contents

- Encoding to Builders
- Deprecated

Description

Efficiently serialize a JSON value.

Most frequently, you'll probably want to encode straight to UTF-8 (the standard JSON encoding) using `encode`.

You can use the conversions to `Builder`s when embedding JSON messages as parts of a protocol.

Synopsis

- encode :: ToJSON a => a -> ByteString
- encodeToBuilder :: Value -> Builder
- encodeToByteStringBuilder :: Value -> Builder
- encodeToTextBuilder :: Value -> Builder
- fromValue :: Value -> Builder

# Documentation

encode :: ToJSON a => a -> ByteString

Efficiently serialize a JSON value as a lazy `ByteString`.

# Encoding to Builders

encodeToBuilder :: Value -> Builder

Encode a JSON value to a ByteString `Builder`. Use this function if you must prepend or append further bytes to the encoded JSON value.

encodeToByteStringBuilder :: Value -> Builder

Deprecated: Use encodeToBuilder instead.

This function is an alias for `encodeToBuilder`.

encodeToTextBuilder :: Value -> Builder

Encode a JSON `Value` to a Data.Text `Builder`, which can be embedded efficiently in a text-based protocol.

# Deprecated

fromValue :: Value -> Builder

Deprecated: Use `encodeToTextBuilder` instead