Zen

Source string Source string

354/10000 · 354
English Actions
:ref:`__serialize parameter <json-serialize>`
Output structure specification
:ref:`json.cfg() <json-module_cfg>`
Change configuration
:ref:`json.NULL <json-null>`
Analog of Lua's "nil"
Convert a Lua object to a JSON string.
Parameters
either a scalar value or a Lua table value.
see :ref:`json.cfg <json-module_cfg>`
return
the original value reformatted as a JSON string.
rtype
string
**Example:**
tarantool> json=require('json')
---
...
tarantool> json.encode(123)
---
- '123'
...
tarantool> json.encode({123})
---
- '[123]'
...
tarantool> json.encode({123, 234, 345})
---
- '[123,234,345]'
...
tarantool> json.encode({abc = 234, cde = 345})
---
- '{"cde":345,"abc":234}'
...
tarantool> json.encode({hello = {'world'}})
---
- '{"hello":["world"]}'
...
Convert a JSON string to a Lua object.
a string formatted as JSON.
the original contents formatted as a Lua table.
table
tarantool> json = require('json')
---
...
tarantool> json.decode('123')
---
- 123
...
tarantool> json.decode('[123, "hello"]')
---
- [123, 'hello']
...
tarantool> json.decode('{"hello": "world"}').hello
---
- world
...
See the tutorial :ref:`Sum a JSON field for all tuples <c_lua_tutorial-sum_a_json_field>` to see how ``json.decode()`` can fit in an application.
**__serialize parameter:**
The JSON output structure can be specified with ``__serialize``:
'seq', 'sequence', 'array' - table encoded as an array
'map', 'mapping' - table encoded as a map
function - the meta-method called to unpack serializable representation of table, cdata or userdata objects
Serializing 'A' and 'B' with different ``__serialize`` values brings different results:
tarantool> json.encode(setmetatable({'A', 'B'}, { __serialize="seq"}))
---
- '["A","B"]'
...
tarantool> json.encode(setmetatable({'A', 'B'}, { __serialize="map"}))
---
- '{"1":"A","2":"B"}'
...
tarantool> json.encode({setmetatable({f1 = 'A', f2 = 'B'}, { __serialize="map"})})
---
- '[{"f2":"B","f1":"A"}]'
...
tarantool> json.encode({setmetatable({f1 = 'A', f2 = 'B'}, { __serialize="seq"})})
---
- '[[]]'
...
Set values that affect the behavior of :ref:`json.encode <json-encode>` and :ref:`json.decode <json-decode>`.
The values are all either integers or boolean ``true``/``false``.

Loading…

User avatar None

New source string

testing_project / Documentation: reference/reference_lua/json — English

tarantool> json=require('json')
---
...
tarantool> json.encode(123)
---
- '123'
...
tarantool> json.encode({123})
---
- '[123]'
...
tarantool> json.encode({123, 234, 345})
---
- '[123,234,345]'
...
tarantool> json.encode({abc = 234, cde = 345})
---
- '{"cde":345,"abc":234}'
...
tarantool> json.encode({hello = {'world'}})
---
- '{"hello":["world"]}'
...
a year ago
Browse all string changes

Things to check

Ellipsis

The string uses three dots (...) instead of an ellipsis character (…)

Reset

Glossary

English English
No related strings found in the glossary.

String information

Flags
read-only
String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
string 27