json-0.9.1: Support for serialising Haskell to and from JSON

Copyright | (c) Galois, Inc. 2007-2009
License | BSD3
Maintainer | Sigbjorn Finne <sof@galois.com>
Stability | provisional
Portability | portable
Safe Haskell | Safe
Language | Haskell98

Text.JSON.String

Contents

- Parsing
  - Reading JSON
  - Writing JSON

Description

Synopsis

- data GetJSON a
- runGetJSON :: GetJSON a -> String -> Either String a
- readJSNull :: GetJSON JSValue
- readJSBool :: GetJSON JSValue
- readJSString :: GetJSON JSValue
- readJSRational :: GetJSON Rational
- readJSArray :: GetJSON JSValue
- readJSObject :: GetJSON JSValue
- readJSValue :: GetJSON JSValue
- readJSTopType :: GetJSON JSValue
- showJSNull :: ShowS
- showJSBool :: Bool -> ShowS
- showJSArray :: [JSValue] -> ShowS
- showJSObject :: JSObject JSValue -> ShowS
- showJSRational :: Rational -> ShowS
- showJSRational' :: Bool -> Rational -> ShowS
- showJSValue :: JSValue -> ShowS
- showJSTopType :: JSValue -> ShowS

# Parsing

data GetJSON a

Parsing JSON

The type of JSON parsers for String

Instances

Monad GetJSON |
Functor GetJSON |
Applicative GetJSON |

runGetJSON :: GetJSON a -> String -> Either String a

Run a JSON reader on an input String, returning some Haskell value. All input will be consumed.

## Reading JSON

readJSNull :: GetJSON JSValue

Read the JSON null type

readJSBool :: GetJSON JSValue

Read the JSON Bool type

readJSString :: GetJSON JSValue

Read the JSON String type

readJSRational :: GetJSON Rational

Read an Integer or Double in JSON format, returning a Rational

readJSArray :: GetJSON JSValue

Read a list in JSON format

readJSObject :: GetJSON JSValue

Read an object in JSON format

readJSValue :: GetJSON JSValue

Read one of several possible JS types

readJSTopType :: GetJSON JSValue

Top level JSON can only be Arrays or Objects

## Writing JSON

showJSNull :: ShowS

Write the JSON null type

showJSBool :: Bool -> ShowS

Write the JSON Bool type

showJSArray :: [JSValue] -> ShowS

Show a list in JSON format

showJSObject :: JSObject JSValue -> ShowS

Show an association list in JSON format

showJSRational :: Rational -> ShowS

Show a Rational in JSON format

showJSRational' :: Bool -> Rational -> ShowS

showJSValue :: JSValue -> ShowS

Show JSON values

showJSTopType :: JSValue -> ShowS

Writing JSON

Show strict JSON top level types. Values not permitted at the top level are wrapped in a singleton array.