]> mj.ucw.cz Git - libucw.git/commitdiff
JSON: Mention exceptions in docs
authorMartin Mares <mj@ucw.cz>
Fri, 17 Jul 2015 13:29:55 +0000 (15:29 +0200)
committerMartin Mares <mj@ucw.cz>
Fri, 17 Jul 2015 13:29:55 +0000 (15:29 +0200)
ucw-json/json.h

index f51dd6a7fe0f506aba60d36ef7b950e0ececa90b..06be568a4003da65366d5dd9d8460888e2d7b4e8 100644 (file)
@@ -246,6 +246,10 @@ struct json_node *json_object_get(struct json_node *n, const char *key);
  * and then repeat json_next_token(). If you are parsing huge JSON files,
  * you probably want to do json_push() first, then scan and process some
  * tokens, and then json_pop().
+ *
+ * All parsing functions throw LibUCW exceptions of class `ucw.json.parse`
+ * upon errors. If you want to catch them, call the parser inside
+ * a transaction.
  ***/
 
 /** Parses a JSON file from the given fastbuf stream. **/