FGCOM/jansson
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

doc: The same JSON values must not be encoded in parallel

Browse Source 
Closes GH-42.
This commit is contained in:
Petri Lehtinen 2011-11-14 19:32:42 +02:00
parent 0f2cdd70ff
commit 0931d938b0
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/portability.rst
View File

@ -20,6 +20,16 @@ such values, as containers manage the reference count of their
contained values. Bugs involving concurrent incrementing or contained values. Bugs involving concurrent incrementing or
decrementing of deference counts may be hard to track. decrementing of deference counts may be hard to track.
The encoding functions (:func:`json_dumps()` and friends) track
reference loops by modifying the internal state of objects and arrays.
For this reason, encoding functions must not be run on the same JSON
values in two separate threads at the same time. As already noted
above, be especially careful if two arrays or objects share their
contained values with another array or object.
If you want to make sure that two JSON value hierarchies do not
contain shared values, use :func:`json_deep_copy()` to make copies.
Locale Locale
------ ------