@spec decode(iodata(), Keyword.t()) :: {:ok, term()} | {:error, String.t()}

Parses a JSON value from input string.

Examples

iex> Jsonrs.decode("{\"x\":[1,2]}")
{:ok, %{"x" => [1, 2]}}

iex> Jsonrs.decode("invalid")
{:error, "expected value at line 1 column 1"}

@spec decode!(iodata(), Keyword.t()) :: term()

Parses a JSON value from input string.

Similar to decode/2 except it will raise in case of errors.

Examples

iex> Jsonrs.decode!("{\"x\":[1,2]}")
%{"x" => [1, 2]}

iex> Jsonrs.decode!("invalid")
** (ErlangError) Erlang error: "expected value at line 1 column 1"

@spec encode(
  term(),
  keyword()
) :: {:ok, String.t()} | {:error, String.t()}

Generates JSON corresponding to input.

Examples

iex> Jsonrs.encode(%{"x" => [1,2]})
{:ok, "{\"x\":[1,2]}"}

iex> Jsonrs.encode("\xFF")
{:error, "Expected to deserialize a UTF-8 stringable term"}

@spec encode!(
  term(),
  keyword()
) :: String.t()

Generates JSON corresponding to input.

Similar to encode/1 except it will raise in case of errors.

Examples

iex> Jsonrs.encode!(%{"x" => [1,2]})
"{\"x\":[1,2]}"

iex> Jsonrs.encode!("\xFF")
** (ErlangError) Erlang error: "Expected to deserialize a UTF-8 stringable term"

@spec encode_to_iodata(
  term(),
  keyword()
) :: {:ok, String.t()} | {:error, :encode_error}

Identical to encode/1. Exists to implement Phoenix interface and encodes to a single normal string.

@spec encode_to_iodata!(
  term(),
  keyword()
) :: String.t()

Identical to encode!/1. Exists to implement Phoenix interface and encodes to a single normal string.