diff --git a/doc/html/README_8md.html b/doc/html/README_8md.html new file mode 100644 index 0000000..b0f17f5 --- /dev/null +++ b/doc/html/README_8md.html @@ -0,0 +1,57 @@ + + + + + +json-c: README.md File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
README.md File Reference
+
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/annotated.html b/doc/html/annotated.html new file mode 100644 index 0000000..fe03066 --- /dev/null +++ b/doc/html/annotated.html @@ -0,0 +1,69 @@ + + + + + +json-c: Data Structures + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
Data Structures
+
+
+
Here are the data structures with brief descriptions:
+ + + + + + + + + +
oCarray_list
oCjson_object_iter
oCjson_object_iterator
oCjson_tokener
oCjson_tokener_srec
oClh_entry
oClh_table
\Cprintbuf
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/arraylist_8h.html b/doc/html/arraylist_8h.html new file mode 100644 index 0000000..139f2ec --- /dev/null +++ b/doc/html/arraylist_8h.html @@ -0,0 +1,449 @@ + + + + + +json-c: arraylist.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Structures | +Macros | +Typedefs | +Functions
+
+
arraylist.h File Reference
+
+
+ +

Internal methods for working with json_type_array objects. Although this is exposed by the json_object_get_array() method, it is not recommended for direct use. +More...

+ + + + +

+Data Structures

struct  array_list
 
+ + + +

+Macros

#define ARRAY_LIST_DEFAULT_SIZE   32
 
+ + + + + +

+Typedefs

typedef void( array_list_free_fn )(void *data)
 
typedef struct array_list array_list
 
+ + + + + + + + + + + + + + + + + + + + + + + +

+Functions

struct array_list * array_list_new (array_list_free_fn *free_fn)
 
struct array_list * array_list_new2 (array_list_free_fn *free_fn, int initial_size)
 
void array_list_free (struct array_list *al)
 
void * array_list_get_idx (struct array_list *al, size_t i)
 
int array_list_put_idx (struct array_list *al, size_t i, void *data)
 
int array_list_add (struct array_list *al, void *data)
 
size_t array_list_length (struct array_list *al)
 
void array_list_sort (struct array_list *arr, int(*compar)(const void *, const void *))
 
void * array_list_bsearch (const void **key, struct array_list *arr, int(*compar)(const void *, const void *))
 
int array_list_del_idx (struct array_list *arr, size_t idx, size_t count)
 
int array_list_shrink (struct array_list *arr, size_t empty_slots)
 
+

Detailed Description

+

Internal methods for working with json_type_array objects. Although this is exposed by the json_object_get_array() method, it is not recommended for direct use.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define ARRAY_LIST_DEFAULT_SIZE   32
+
+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef struct array_list array_list
+
+ +
+
+ +
+
+ + + + +
typedef void( array_list_free_fn)(void *data)
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + +
int array_list_add (struct array_list * al,
void * data 
)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void* array_list_bsearch (const void ** key,
struct array_list * arr,
int(*)(const void *, const void *) compar 
)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int array_list_del_idx (struct array_list * arr,
size_t idx,
size_t count 
)
+
+ +
+
+ +
+
+ + + + + + + + +
void array_list_free (struct array_list * al)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
void* array_list_get_idx (struct array_list * al,
size_t i 
)
+
+ +
+
+ +
+
+ + + + + + + + +
size_t array_list_length (struct array_list * al)
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
struct array_list* array_list_new (array_list_free_fn * free_fn)
+ 		+read
+
+

Allocate an array_list of the default size (32).

+
Deprecated:
Use array_list_new2() instead.
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
struct array_list* array_list_new2 (array_list_free_fn * free_fn,
int initial_size 
)
+ 		+read
+
+

Allocate an array_list of the desired size.

+

If possible, the size should be chosen to closely match the actual number of elements expected to be used. If the exact size is unknown, there are tradeoffs to be made:

+
    +
  • too small - the array_list code will need to call realloc() more often (which might incur an additional memory copy).
    • +
  • too large - will waste memory, but that can be mitigated by calling array_list_shrink() once the final size is known.
    • +
+
See Also
array_list_shrink
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int array_list_put_idx (struct array_list * al,
size_t i,
void * data 
)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
int array_list_shrink (struct array_list * arr,
size_t empty_slots 
)
+
+

Shrink the array list to just enough to fit the number of elements in it, plus empty_slots.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
void array_list_sort (struct array_list * arr,
int(*)(const void *, const void *) compar 
)
+
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/bc_s.png b/doc/html/bc_s.png new file mode 100644 index 0000000..224b29a Binary files /dev/null and b/doc/html/bc_s.png differ diff --git a/doc/html/bdwn.png b/doc/html/bdwn.png new file mode 100644 index 0000000..940a0b9 Binary files /dev/null and b/doc/html/bdwn.png differ diff --git a/doc/html/classes.html b/doc/html/classes.html new file mode 100644 index 0000000..cc2b654 --- /dev/null +++ b/doc/html/classes.html @@ -0,0 +1,72 @@ + + + + + +json-c: Data Structure Index + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
Data Structure Index
+
+
+
A | J | L | P
+ + + + + + + + +
  A  
+		json_object_iterator   lh_table   
json_tokener   
  P  
+
array_list   json_tokener_srec   
  J  
+
  L  
+		printbuf   
json_object_iter   lh_entry   
+
A | J | L | P
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/closed.png b/doc/html/closed.png new file mode 100644 index 0000000..98cc2c9 Binary files /dev/null and b/doc/html/closed.png differ diff --git a/doc/html/deprecated.html b/doc/html/deprecated.html new file mode 100644 index 0000000..3fb967c --- /dev/null +++ b/doc/html/deprecated.html @@ -0,0 +1,95 @@ + + + + + +json-c: Deprecated List + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + +
+
+
+
Deprecated List
+
+
+
+
Global array_list_new (array_list_free_fn *free_fn)
+
Use array_list_new2() instead.
+
Global json_parse_double (const char *buf, double *retval)
+
+
Global json_tokener
+
Unused in json-c code
+
Global json_tokener::char_offset
+
See json_tokener_get_parse_end() instead.
+
Global json_tokener::err
+
See json_tokener_get_error() instead.
+
Global json_tokener::str
+
Do not access any of these fields outside of json_tokener.c
+
Class json_tokener_srec
+
Don't use this outside of json_tokener.c, it will be made private in a future release.
+
Global json_tokener_state
+
Don't use this outside of json_tokener.c, it will be made private in a future release.
+
Global lh_entry::k
+
Use lh_entry_k() instead of accessing this directly.
+
Global lh_entry::k_is_constant
+
use lh_entry_k_is_constant() instead.
+
Global lh_entry::next
+
Use lh_entry_next() instead of accessing this directly.
+
Global lh_entry::prev
+
Use lh_entry_prev() instead of accessing this directly.
+
Global lh_entry::v
+
Use lh_entry_v() instead of accessing this directly.
+
Global lh_table::count
+
Use lh_table_length() instead.
+
Global lh_table::equal_fn
+
do not use outside of linkhash.c
+
Global lh_table::free_fn
+
do not use outside of linkhash.c
+
Global lh_table::hash_fn
+
do not use outside of linkhash.c
+
Global lh_table::head
+
Use lh_table_head() instead.
+
Global lh_table::size
+
do not use outside of linkhash.c
+
Global lh_table::table
+
do not use outside of linkhash.c
+
Global lh_table::tail
+
Do not use, may be removed in a future release.
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/dir_b62156a74b5a818be0c2ef9f85294b95.html b/doc/html/dir_b62156a74b5a818be0c2ef9f85294b95.html new file mode 100644 index 0000000..0ae1471 --- /dev/null +++ b/doc/html/dir_b62156a74b5a818be0c2ef9f85294b95.html @@ -0,0 +1,62 @@ + + + + + +json-c: /home/erh/distcheck Directory Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
distcheck Directory Reference
+
+
+ + + + + +

+Files

file  json.h
 A convenience header that may be included instead of other individual ones.
 
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/doxygen.css b/doc/html/doxygen.css new file mode 100644 index 0000000..2642e8f --- /dev/null +++ b/doc/html/doxygen.css @@ -0,0 +1,1172 @@ +/* The standard CSS for doxygen */ + +body, table, div, p, dl { + font: 400 14px/19px Roboto,sans-serif; +} + +/* @group Heading Levels */ + +h1.groupheader { + font-size: 150%; +} + +.title { + font-size: 150%; + font-weight: bold; + margin: 10px 2px; +} + +h2.groupheader { + border-bottom: 1px solid #879ECB; + color: #354C7B; + font-size: 150%; + font-weight: normal; + margin-top: 1.75em; + padding-top: 8px; + padding-bottom: 4px; + width: 100%; +} + +h3.groupheader { + font-size: 100%; +} + +h1, h2, h3, h4, h5, h6 { + -webkit-transition: text-shadow 0.5s linear; + -moz-transition: text-shadow 0.5s linear; + -ms-transition: text-shadow 0.5s linear; + -o-transition: text-shadow 0.5s linear; + transition: text-shadow 0.5s linear; + margin-right: 15px; +} + +h1.glow, h2.glow, h3.glow, h4.glow, h5.glow, h6.glow { + text-shadow: 0 0 15px cyan; +} + +dt { + font-weight: bold; +} + +div.multicol { + -moz-column-gap: 1em; + -webkit-column-gap: 1em; + -moz-column-count: 3; + -webkit-column-count: 3; +} + +p.startli, p.startdd, p.starttd { + margin-top: 2px; +} + +p.endli { + margin-bottom: 0px; +} + +p.enddd { + margin-bottom: 4px; +} + +p.endtd { + margin-bottom: 2px; +} + +/* @end */ + +caption { + font-weight: bold; +} + +span.legend { + font-size: 70%; + text-align: center; +} + +h3.version { + font-size: 90%; + text-align: center; +} + +div.qindex, div.navtab{ + background-color: #EBEFF6; + border: 1px solid #A3B4D7; + text-align: center; +} + +div.qindex, div.navpath { + width: 100%; + line-height: 140%; +} + +div.navtab { + margin-right: 15px; +} + +/* @group Link Styling */ + +a { + color: #3D578C; + font-weight: normal; + text-decoration: none; +} + +.contents a:visited { + color: #4665A2; +} + +a:hover { + text-decoration: underline; +} + +a.qindex { + font-weight: bold; +} + +a.qindexHL { + font-weight: bold; + background-color: #9CAFD4; + color: #ffffff; + border: 1px double #869DCA; +} + +.contents a.qindexHL:visited { + color: #ffffff; +} + +a.el { + font-weight: bold; +} + +a.elRef { +} + +a.code, a.code:visited { + color: #4665A2; +} + +a.codeRef, a.codeRef:visited { + color: #4665A2; +} + +/* @end */ + +dl.el { + margin-left: -1cm; +} + +pre.fragment { + border: 1px solid #C4CFE5; + background-color: #FBFCFD; + padding: 4px 6px; + margin: 4px 8px 4px 2px; + overflow: auto; + word-wrap: break-word; + font-size: 9pt; + line-height: 125%; + font-family: monospace, fixed; + font-size: 105%; +} + +div.fragment { + padding: 4px; + margin: 4px; + background-color: #FBFCFD; + border: 1px solid #C4CFE5; +} + +div.line { + font-family: monospace, fixed; + font-size: 13px; + min-height: 13px; + line-height: 1.0; + text-wrap: unrestricted; + white-space: -moz-pre-wrap; /* Moz */ + white-space: -pre-wrap; /* Opera 4-6 */ + white-space: -o-pre-wrap; /* Opera 7 */ + white-space: pre-wrap; /* CSS3 */ + word-wrap: break-word; /* IE 5.5+ */ + text-indent: -53px; + padding-left: 53px; + padding-bottom: 0px; + margin: 0px; + -webkit-transition-property: background-color, box-shadow; + -webkit-transition-duration: 0.5s; + -moz-transition-property: background-color, box-shadow; + -moz-transition-duration: 0.5s; + -ms-transition-property: background-color, box-shadow; + -ms-transition-duration: 0.5s; + -o-transition-property: background-color, box-shadow; + -o-transition-duration: 0.5s; + transition-property: background-color, box-shadow; + transition-duration: 0.5s; +} + +div.line.glow { + background-color: cyan; + box-shadow: 0 0 10px cyan; +} + + +span.lineno { + padding-right: 4px; + text-align: right; + border-right: 2px solid #0F0; + background-color: #E8E8E8; + white-space: pre; +} +span.lineno a { + background-color: #D8D8D8; +} + +span.lineno a:hover { + background-color: #C8C8C8; +} + +div.ah { + background-color: black; + font-weight: bold; + color: #ffffff; + margin-bottom: 3px; + margin-top: 3px; + padding: 0.2em; + border: solid thin #333; + border-radius: 0.5em; + -webkit-border-radius: .5em; + -moz-border-radius: .5em; + box-shadow: 2px 2px 3px #999; + -webkit-box-shadow: 2px 2px 3px #999; + -moz-box-shadow: rgba(0, 0, 0, 0.15) 2px 2px 2px; + background-image: -webkit-gradient(linear, left top, left bottom, from(#eee), to(#000),color-stop(0.3, #444)); + background-image: -moz-linear-gradient(center top, #eee 0%, #444 40%, #000); +} + +div.groupHeader { + margin-left: 16px; + margin-top: 12px; + font-weight: bold; +} + +div.groupText { + margin-left: 16px; + font-style: italic; +} + +body { + background-color: white; + color: black; + margin: 0; +} + +div.contents { + margin-top: 10px; + margin-left: 12px; + margin-right: 8px; +} + +td.indexkey { + background-color: #EBEFF6; + font-weight: bold; + border: 1px solid #C4CFE5; + margin: 2px 0px 2px 0; + padding: 2px 10px; + white-space: nowrap; + vertical-align: top; +} + +td.indexvalue { + background-color: #EBEFF6; + border: 1px solid #C4CFE5; + padding: 2px 10px; + margin: 2px 0px; +} + +tr.memlist { + background-color: #EEF1F7; +} + +p.formulaDsp { + text-align: center; +} + +img.formulaDsp { + +} + +img.formulaInl { + vertical-align: middle; +} + +div.center { + text-align: center; + margin-top: 0px; + margin-bottom: 0px; + padding: 0px; +} + +div.center img { + border: 0px; +} + +address.footer { + text-align: right; + padding-right: 12px; +} + +img.footer { + border: 0px; + vertical-align: middle; +} + +/* @group Code Colorization */ + +span.keyword { + color: #008000 +} + +span.keywordtype { + color: #604020 +} + +span.keywordflow { + color: #e08000 +} + +span.comment { + color: #800000 +} + +span.preprocessor { + color: #806020 +} + +span.stringliteral { + color: #002080 +} + +span.charliteral { + color: #008080 +} + +span.vhdldigit { + color: #ff00ff +} + +span.vhdlchar { + color: #000000 +} + +span.vhdlkeyword { + color: #700070 +} + +span.vhdllogic { + color: #ff0000 +} + +blockquote { + background-color: #F7F8FB; + border-left: 2px solid #9CAFD4; + margin: 0 24px 0 4px; + padding: 0 12px 0 16px; +} + +/* @end */ + +/* +.search { + color: #003399; + font-weight: bold; +} + +form.search { + margin-bottom: 0px; + margin-top: 0px; +} + +input.search { + font-size: 75%; + color: #000080; + font-weight: normal; + background-color: #e8eef2; +} +*/ + +td.tiny { + font-size: 75%; +} + +.dirtab { + padding: 4px; + border-collapse: collapse; + border: 1px solid #A3B4D7; +} + +th.dirtab { + background: #EBEFF6; + font-weight: bold; +} + +hr { + height: 0px; + border: none; + border-top: 1px solid #4A6AAA; +} + +hr.footer { + height: 1px; +} + +/* @group Member Descriptions */ + +table.memberdecls { + border-spacing: 0px; + padding: 0px; +} + +.memberdecls td, .fieldtable tr { + -webkit-transition-property: background-color, box-shadow; + -webkit-transition-duration: 0.5s; + -moz-transition-property: background-color, box-shadow; + -moz-transition-duration: 0.5s; + -ms-transition-property: background-color, box-shadow; + -ms-transition-duration: 0.5s; + -o-transition-property: background-color, box-shadow; + -o-transition-duration: 0.5s; + transition-property: background-color, box-shadow; + transition-duration: 0.5s; +} + +.memberdecls td.glow, .fieldtable tr.glow { + background-color: cyan; + box-shadow: 0 0 15px cyan; +} + +.mdescLeft, .mdescRight, +.memItemLeft, .memItemRight, +.memTemplItemLeft, .memTemplItemRight, .memTemplParams { + background-color: #F9FAFC; + border: none; + margin: 4px; + padding: 1px 0 0 8px; +} + +.mdescLeft, .mdescRight { + padding: 0px 8px 4px 8px; + color: #555; +} + +.memSeparator { + border-bottom: 1px solid #DEE4F0; + line-height: 1px; + margin: 0px; + padding: 0px; +} + +.memItemLeft, .memTemplItemLeft { + white-space: nowrap; +} + +.memItemRight { + width: 100%; +} + +.memTemplParams { + color: #4665A2; + white-space: nowrap; + font-size: 80%; +} + +/* @end */ + +/* @group Member Details */ + +/* Styles for detailed member documentation */ + +.memtemplate { + font-size: 80%; + color: #4665A2; + font-weight: normal; + margin-left: 9px; +} + +.memnav { + background-color: #EBEFF6; + border: 1px solid #A3B4D7; + text-align: center; + margin: 2px; + margin-right: 15px; + padding: 2px; +} + +.mempage { + width: 100%; +} + +.memitem { + padding: 0; + margin-bottom: 10px; + margin-right: 5px; + -webkit-transition: box-shadow 0.5s linear; + -moz-transition: box-shadow 0.5s linear; + -ms-transition: box-shadow 0.5s linear; + -o-transition: box-shadow 0.5s linear; + transition: box-shadow 0.5s linear; + display: table !important; + width: 100%; +} + +.memitem.glow { + box-shadow: 0 0 15px cyan; +} + +.memname { + font-weight: bold; + margin-left: 6px; +} + +.memname td { + vertical-align: bottom; +} + +.memproto, dl.reflist dt { + border-top: 1px solid #A8B8D9; + border-left: 1px solid #A8B8D9; + border-right: 1px solid #A8B8D9; + padding: 6px 0px 6px 0px; + color: #253555; + font-weight: bold; + text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9); + background-image:url('nav_f.png'); + background-repeat:repeat-x; + background-color: #E2E8F2; + /* opera specific markup */ + box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); + border-top-right-radius: 4px; + border-top-left-radius: 4px; + /* firefox specific markup */ + -moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px; + -moz-border-radius-topright: 4px; + -moz-border-radius-topleft: 4px; + /* webkit specific markup */ + -webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); + -webkit-border-top-right-radius: 4px; + -webkit-border-top-left-radius: 4px; + +} + +.memdoc, dl.reflist dd { + border-bottom: 1px solid #A8B8D9; + border-left: 1px solid #A8B8D9; + border-right: 1px solid #A8B8D9; + padding: 6px 10px 2px 10px; + background-color: #FBFCFD; + border-top-width: 0; + background-image:url('nav_g.png'); + background-repeat:repeat-x; + background-color: #FFFFFF; + /* opera specific markup */ + border-bottom-left-radius: 4px; + border-bottom-right-radius: 4px; + box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); + /* firefox specific markup */ + -moz-border-radius-bottomleft: 4px; + -moz-border-radius-bottomright: 4px; + -moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px; + /* webkit specific markup */ + -webkit-border-bottom-left-radius: 4px; + -webkit-border-bottom-right-radius: 4px; + -webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); +} + +dl.reflist dt { + padding: 5px; +} + +dl.reflist dd { + margin: 0px 0px 10px 0px; + padding: 5px; +} + +.paramkey { + text-align: right; +} + +.paramtype { + white-space: nowrap; +} + +.paramname { + color: #602020; + white-space: nowrap; +} +.paramname em { + font-style: normal; +} +.paramname code { + line-height: 14px; +} + +.params, .retval, .exception, .tparams { + margin-left: 0px; + padding-left: 0px; +} + +.params .paramname, .retval .paramname { + font-weight: bold; + vertical-align: top; +} + +.params .paramtype { + font-style: italic; + vertical-align: top; +} + +.params .paramdir { + font-family: "courier new",courier,monospace; + vertical-align: top; +} + +table.mlabels { + border-spacing: 0px; +} + +td.mlabels-left { + width: 100%; + padding: 0px; +} + +td.mlabels-right { + vertical-align: bottom; + padding: 0px; + white-space: nowrap; +} + +span.mlabels { + margin-left: 8px; +} + +span.mlabel { + background-color: #728DC1; + border-top:1px solid #5373B4; + border-left:1px solid #5373B4; + border-right:1px solid #C4CFE5; + border-bottom:1px solid #C4CFE5; + text-shadow: none; + color: white; + margin-right: 4px; + padding: 2px 3px; + border-radius: 3px; + font-size: 7pt; + white-space: nowrap; + vertical-align: middle; +} + + + +/* @end */ + +/* these are for tree view when not used as main index */ + +div.directory { + margin: 10px 0px; + border-top: 1px solid #A8B8D9; + border-bottom: 1px solid #A8B8D9; + width: 100%; +} + +.directory table { + border-collapse:collapse; +} + +.directory td { + margin: 0px; + padding: 0px; + vertical-align: top; +} + +.directory td.entry { + white-space: nowrap; + padding-right: 6px; +} + +.directory td.entry a { + outline:none; +} + +.directory td.entry a img { + border: none; +} + +.directory td.desc { + width: 100%; + padding-left: 6px; + padding-right: 6px; + padding-top: 3px; + border-left: 1px solid rgba(0,0,0,0.05); +} + +.directory tr.even { + padding-left: 6px; + background-color: #F7F8FB; +} + +.directory img { + vertical-align: -30%; +} + +.directory .levels { + white-space: nowrap; + width: 100%; + text-align: right; + font-size: 9pt; +} + +.directory .levels span { + cursor: pointer; + padding-left: 2px; + padding-right: 2px; + color: #3D578C; +} + +div.dynheader { + margin-top: 8px; + -webkit-touch-callout: none; + -webkit-user-select: none; + -khtml-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; +} + +address { + font-style: normal; + color: #2A3D61; +} + +table.doxtable { + border-collapse:collapse; + margin-top: 4px; + margin-bottom: 4px; +} + +table.doxtable td, table.doxtable th { + border: 1px solid #2D4068; + padding: 3px 7px 2px; +} + +table.doxtable th { + background-color: #374F7F; + color: #FFFFFF; + font-size: 110%; + padding-bottom: 4px; + padding-top: 5px; +} + +table.fieldtable { + width: 100%; + margin-bottom: 10px; + border: 1px solid #A8B8D9; + border-spacing: 0px; + -moz-border-radius: 4px; + -webkit-border-radius: 4px; + border-radius: 4px; + -moz-box-shadow: rgba(0, 0, 0, 0.15) 2px 2px 2px; + -webkit-box-shadow: 2px 2px 2px rgba(0, 0, 0, 0.15); + box-shadow: 2px 2px 2px rgba(0, 0, 0, 0.15); +} + +.fieldtable td, .fieldtable th { + padding: 3px 7px 2px; +} + +.fieldtable td.fieldtype, .fieldtable td.fieldname { + white-space: nowrap; + border-right: 1px solid #A8B8D9; + border-bottom: 1px solid #A8B8D9; + vertical-align: top; +} + +.fieldtable td.fielddoc { + border-bottom: 1px solid #A8B8D9; + width: 100%; +} + +.fieldtable tr:last-child td { + border-bottom: none; +} + +.fieldtable th { + background-image:url('nav_f.png'); + background-repeat:repeat-x; + background-color: #E2E8F2; + font-size: 90%; + color: #253555; + padding-bottom: 4px; + padding-top: 5px; + text-align:left; + -moz-border-radius-topleft: 4px; + -moz-border-radius-topright: 4px; + -webkit-border-top-left-radius: 4px; + -webkit-border-top-right-radius: 4px; + border-top-left-radius: 4px; + border-top-right-radius: 4px; + border-bottom: 1px solid #A8B8D9; +} + + +.tabsearch { + top: 0px; + left: 10px; + height: 36px; + background-image: url('tab_b.png'); + z-index: 101; + overflow: hidden; + font-size: 13px; +} + +.navpath ul +{ + font-size: 11px; + background-image:url('tab_b.png'); + background-repeat:repeat-x; + background-position: 0 -5px; + height:30px; + line-height:30px; + color:#8AA0CC; + border:solid 1px #C2CDE4; + overflow:hidden; + margin:0px; + padding:0px; +} + +.navpath li +{ + list-style-type:none; + float:left; + padding-left:10px; + padding-right:15px; + background-image:url('bc_s.png'); + background-repeat:no-repeat; + background-position:right; + color:#364D7C; +} + +.navpath li.navelem a +{ + height:32px; + display:block; + text-decoration: none; + outline: none; + color: #283A5D; + font-family: 'Lucida Grande',Geneva,Helvetica,Arial,sans-serif; + text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9); + text-decoration: none; +} + +.navpath li.navelem a:hover +{ + color:#6884BD; +} + +.navpath li.footer +{ + list-style-type:none; + float:right; + padding-left:10px; + padding-right:15px; + background-image:none; + background-repeat:no-repeat; + background-position:right; + color:#364D7C; + font-size: 8pt; +} + + +div.summary +{ + float: right; + font-size: 8pt; + padding-right: 5px; + width: 50%; + text-align: right; +} + +div.summary a +{ + white-space: nowrap; +} + +div.ingroups +{ + font-size: 8pt; + width: 50%; + text-align: left; +} + +div.ingroups a +{ + white-space: nowrap; +} + +div.header +{ + background-image:url('nav_h.png'); + background-repeat:repeat-x; + background-color: #F9FAFC; + margin: 0px; + border-bottom: 1px solid #C4CFE5; +} + +div.headertitle +{ + padding: 5px 5px 5px 10px; +} + +dl +{ + padding: 0 0 0 10px; +} + +/* dl.note, dl.warning, dl.attention, dl.pre, dl.post, dl.invariant, dl.deprecated, dl.todo, dl.test, dl.bug */ +dl.section +{ + margin-left: 0px; + padding-left: 0px; +} + +dl.note +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #D0C000; +} + +dl.warning, dl.attention +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #FF0000; +} + +dl.pre, dl.post, dl.invariant +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #00D000; +} + +dl.deprecated +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #505050; +} + +dl.todo +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #00C0E0; +} + +dl.test +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #3030E0; +} + +dl.bug +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #C08050; +} + +dl.section dd { + margin-bottom: 6px; +} + + +#projectlogo +{ + text-align: center; + vertical-align: bottom; + border-collapse: separate; +} + +#projectlogo img +{ + border: 0px none; +} + +#projectname +{ + font: 300% Tahoma, Arial,sans-serif; + margin: 0px; + padding: 2px 0px; +} + +#projectbrief +{ + font: 120% Tahoma, Arial,sans-serif; + margin: 0px; + padding: 0px; +} + +#projectnumber +{ + font: 50% Tahoma, Arial,sans-serif; + margin: 0px; + padding: 0px; +} + +#titlearea +{ + padding: 0px; + margin: 0px; + width: 100%; + border-bottom: 1px solid #5373B4; +} + +.image +{ + text-align: center; +} + +.dotgraph +{ + text-align: center; +} + +.mscgraph +{ + text-align: center; +} + +.caption +{ + font-weight: bold; +} + +div.zoom +{ + border: 1px solid #90A5CE; +} + +dl.citelist { + margin-bottom:50px; +} + +dl.citelist dt { + color:#334975; + float:left; + font-weight:bold; + margin-right:10px; + padding:5px; +} + +dl.citelist dd { + margin:2px 0; + padding:5px 0; +} + +div.toc { + padding: 14px 25px; + background-color: #F4F6FA; + border: 1px solid #D8DFEE; + border-radius: 7px 7px 7px 7px; + float: right; + height: auto; + margin: 0 20px 10px 10px; + width: 200px; +} + +div.toc li { + background: url("bdwn.png") no-repeat scroll 0 5px transparent; + font: 10px/1.2 Verdana,DejaVu Sans,Geneva,sans-serif; + margin-top: 5px; + padding-left: 10px; + padding-top: 2px; +} + +div.toc h3 { + font: bold 12px/1.2 Arial,FreeSans,sans-serif; + color: #4665A2; + border-bottom: 0 none; + margin: 0; +} + +div.toc ul { + list-style: none outside none; + border: medium none; + padding: 0px; +} + +div.toc li.level1 { + margin-left: 0px; +} + +div.toc li.level2 { + margin-left: 15px; +} + +div.toc li.level3 { + margin-left: 30px; +} + +div.toc li.level4 { + margin-left: 45px; +} + +.inherit_header { + font-weight: bold; + color: gray; + cursor: pointer; + -webkit-touch-callout: none; + -webkit-user-select: none; + -khtml-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; +} + +.inherit_header td { + padding: 6px 0px 2px 5px; +} + +.inherit { + display: none; +} + +tr.heading h2 { + margin-top: 12px; + margin-bottom: 4px; +} + +@media print +{ + #top { display: none; } + #side-nav { display: none; } + #nav-path { display: none; } + body { overflow:visible; } + h1, h2, h3, h4, h5, h6 { page-break-after: avoid; } + .summary { display: none; } + .memitem { page-break-inside: avoid; } + #doc-content + { + margin-left:0 !important; + height:auto !important; + width:auto !important; + overflow:inherit; + display:inline; + } +} + diff --git a/doc/html/doxygen.png b/doc/html/doxygen.png new file mode 100644 index 0000000..3ff17d8 Binary files /dev/null and b/doc/html/doxygen.png differ diff --git a/doc/html/dynsections.js b/doc/html/dynsections.js new file mode 100644 index 0000000..116542f --- /dev/null +++ b/doc/html/dynsections.js @@ -0,0 +1,78 @@ +function toggleVisibility(linkObj) +{ + var base = $(linkObj).attr('id'); + var summary = $('#'+base+'-summary'); + var content = $('#'+base+'-content'); + var trigger = $('#'+base+'-trigger'); + var src=$(trigger).attr('src'); + if (content.is(':visible')===true) { + content.hide(); + summary.show(); + $(linkObj).addClass('closed').removeClass('opened'); + $(trigger).attr('src',src.substring(0,src.length-8)+'closed.png'); + } else { + content.show(); + summary.hide(); + $(linkObj).removeClass('closed').addClass('opened'); + $(trigger).attr('src',src.substring(0,src.length-10)+'open.png'); + } + return false; +} + +function updateStripes() +{ + $('table.directory tr'). + removeClass('even').filter(':visible:even').addClass('even'); +} +function toggleLevel(level) +{ + $('table.directory tr').each(function(){ + var l = this.id.split('_').length-1; + var i = $('#img'+this.id.substring(3)); + var a = $('#arr'+this.id.substring(3)); + if (l + + + + +json-c: File List + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
File List
+
+
+
Here is a list of all files with brief descriptions:
+
[detail level 12]
+ + + + + + + + + + + + + + +
o-distcheck
|\*json.hA convenience header that may be included instead of other individual ones
o*arraylist.hInternal methods for working with json_type_array objects. Although this is exposed by the json_object_get_array() method, it is not recommended for direct use
o*json_c_version.hMethods for retrieving the json-c version
o*json_inttypes.hDo not use, json-c internal, may be changed or removed at any time
o*json_object.hCore json-c API. Start here, or with json_tokener.h
o*json_object_iterator.hAn API for iterating over json_type_object objects, styled to be familiar to C++ programmers. Unlike json_object_object_foreach() and json_object_object_foreachC(), this avoids the need to expose json-c internals like lh_entry
o*json_pointer.hJSON Pointer (RFC 6901) implementation for retrieving objects from a json-c object tree
o*json_tokener.hMethods to parse an input string into a tree of json_object objects
o*json_types.hBasic types used in a few places in json-c, but you should include "json_object.h" instead
o*json_util.hMiscllaneous utility functions and macros
o*json_visit.hMethods for walking a tree of objects
o*linkhash.hInternal methods for working with json_type_object objects. Although this is exposed by the json_object_get_object() function and within the json_object_iter type, it is not recommended for direct use
\*printbuf.hInternal string buffer handling. Unless you're writing a json_object_to_json_string_fn implementation for use with json_object_set_serializer() direct use of this is not recommended
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/ftv2blank.png b/doc/html/ftv2blank.png new file mode 100644 index 0000000..63c605b Binary files /dev/null and b/doc/html/ftv2blank.png differ diff --git a/doc/html/ftv2cl.png b/doc/html/ftv2cl.png new file mode 100644 index 0000000..132f657 Binary files /dev/null and b/doc/html/ftv2cl.png differ diff --git a/doc/html/ftv2doc.png b/doc/html/ftv2doc.png new file mode 100644 index 0000000..17edabf Binary files /dev/null and b/doc/html/ftv2doc.png differ diff --git a/doc/html/ftv2folderclosed.png b/doc/html/ftv2folderclosed.png new file mode 100644 index 0000000..bb8ab35 Binary files /dev/null and b/doc/html/ftv2folderclosed.png differ diff --git a/doc/html/ftv2folderopen.png b/doc/html/ftv2folderopen.png new file mode 100644 index 0000000..d6c7f67 Binary files /dev/null and b/doc/html/ftv2folderopen.png differ diff --git a/doc/html/ftv2lastnode.png b/doc/html/ftv2lastnode.png new file mode 100644 index 0000000..63c605b Binary files /dev/null and b/doc/html/ftv2lastnode.png differ diff --git a/doc/html/ftv2link.png b/doc/html/ftv2link.png new file mode 100644 index 0000000..17edabf Binary files /dev/null and b/doc/html/ftv2link.png differ diff --git a/doc/html/ftv2mlastnode.png b/doc/html/ftv2mlastnode.png new file mode 100644 index 0000000..0b63f6d Binary files /dev/null and b/doc/html/ftv2mlastnode.png differ diff --git a/doc/html/ftv2mnode.png b/doc/html/ftv2mnode.png new file mode 100644 index 0000000..0b63f6d Binary files /dev/null and b/doc/html/ftv2mnode.png differ diff --git a/doc/html/ftv2mo.png b/doc/html/ftv2mo.png new file mode 100644 index 0000000..4bfb80f Binary files /dev/null and b/doc/html/ftv2mo.png differ diff --git a/doc/html/ftv2node.png b/doc/html/ftv2node.png new file mode 100644 index 0000000..63c605b Binary files /dev/null and b/doc/html/ftv2node.png differ diff --git a/doc/html/ftv2ns.png b/doc/html/ftv2ns.png new file mode 100644 index 0000000..72e3d71 Binary files /dev/null and b/doc/html/ftv2ns.png differ diff --git a/doc/html/ftv2plastnode.png b/doc/html/ftv2plastnode.png new file mode 100644 index 0000000..c6ee22f Binary files /dev/null and b/doc/html/ftv2plastnode.png differ diff --git a/doc/html/ftv2pnode.png b/doc/html/ftv2pnode.png new file mode 100644 index 0000000..c6ee22f Binary files /dev/null and b/doc/html/ftv2pnode.png differ diff --git a/doc/html/ftv2splitbar.png b/doc/html/ftv2splitbar.png new file mode 100644 index 0000000..fe895f2 Binary files /dev/null and b/doc/html/ftv2splitbar.png differ diff --git a/doc/html/ftv2vertline.png b/doc/html/ftv2vertline.png new file mode 100644 index 0000000..63c605b Binary files /dev/null and b/doc/html/ftv2vertline.png differ diff --git a/doc/html/functions.html b/doc/html/functions.html new file mode 100644 index 0000000..4e5c3d9 --- /dev/null +++ b/doc/html/functions.html @@ -0,0 +1,275 @@ + + + + + +json-c: Data Fields + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+
Here is a list of all struct and union fields with links to the structures/unions they belong to:
+ +

- a -

+ + +

- b -

+ + +

- c -

+ + +

- d -

+ + +

- e -

+ + +

- f -

+ + +

- h -

+ + +

- i -

+ + +

- k -

+ + +

- l -

+ + +

- m -

+ + +

- n -

+ + +

- o -

+ + +

- p -

+ + +

- q -

+ + +

- s -

+ + +

- t -

+ + +

- u -

+ + +

- v -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/functions_vars.html b/doc/html/functions_vars.html new file mode 100644 index 0000000..7bdbdca --- /dev/null +++ b/doc/html/functions_vars.html @@ -0,0 +1,275 @@ + + + + + +json-c: Data Fields - Variables + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+  + +

- a -

+ + +

- b -

+ + +

- c -

+ + +

- d -

+ + +

- e -

+ + +

- f -

+ + +

- h -

+ + +

- i -

+ + +

- k -

+ + +

- l -

+ + +

- m -

+ + +

- n -

+ + +

- o -

+ + +

- p -

+ + +

- q -

+ + +

- s -

+ + +

- t -

+ + +

- u -

+ + +

- v -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals.html b/doc/html/globals.html new file mode 100644 index 0000000..e354921 --- /dev/null +++ b/doc/html/globals.html @@ -0,0 +1,119 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+
Here is a list of all functions, variables, defines, enums, and typedefs with links to the files they belong to:
+ +

- a -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_0x6a.html b/doc/html/globals_0x6a.html new file mode 100644 index 0000000..cb0ad28 --- /dev/null +++ b/doc/html/globals_0x6a.html @@ -0,0 +1,664 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+
Here is a list of all functions, variables, defines, enums, and typedefs with links to the files they belong to:
+ +

- j -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_0x6c.html b/doc/html/globals_0x6c.html new file mode 100644 index 0000000..e508a6d --- /dev/null +++ b/doc/html/globals_0x6c.html @@ -0,0 +1,170 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+
Here is a list of all functions, variables, defines, enums, and typedefs with links to the files they belong to:
+ +

- l -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_0x70.html b/doc/html/globals_0x70.html new file mode 100644 index 0000000..4764204 --- /dev/null +++ b/doc/html/globals_0x70.html @@ -0,0 +1,110 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+
Here is a list of all functions, variables, defines, enums, and typedefs with links to the files they belong to:
+ +

- p -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_0x73.html b/doc/html/globals_0x73.html new file mode 100644 index 0000000..14601ad --- /dev/null +++ b/doc/html/globals_0x73.html @@ -0,0 +1,83 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+
Here is a list of all functions, variables, defines, enums, and typedefs with links to the files they belong to:
+ +

- s -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_defs.html b/doc/html/globals_defs.html new file mode 100644 index 0000000..22a07b8 --- /dev/null +++ b/doc/html/globals_defs.html @@ -0,0 +1,242 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+  + +

- a -

+ + +

- j -

+ + +

- l -

+ + +

- p -

+ + +

- s -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_enum.html b/doc/html/globals_enum.html new file mode 100644 index 0000000..f84d7cc --- /dev/null +++ b/doc/html/globals_enum.html @@ -0,0 +1,75 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + +
+
+  +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_eval.html b/doc/html/globals_eval.html new file mode 100644 index 0000000..f188d14 --- /dev/null +++ b/doc/html/globals_eval.html @@ -0,0 +1,223 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+  + +

- j -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_func.html b/doc/html/globals_func.html new file mode 100644 index 0000000..373801e --- /dev/null +++ b/doc/html/globals_func.html @@ -0,0 +1,492 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + + +
+
+  + +

- a -

+ + +

- j -

+ + +

- l -

+ + +

- p -

+ + +

- s -

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_type.html b/doc/html/globals_type.html new file mode 100644 index 0000000..467b3d7 --- /dev/null +++ b/doc/html/globals_type.html @@ -0,0 +1,114 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + +
+
+  +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/globals_vars.html b/doc/html/globals_vars.html new file mode 100644 index 0000000..f575c9e --- /dev/null +++ b/doc/html/globals_vars.html @@ -0,0 +1,75 @@ + + + + + +json-c: Globals + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + + +
+
+  +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/index.html b/doc/html/index.html new file mode 100644 index 0000000..2070145 --- /dev/null +++ b/doc/html/index.html @@ -0,0 +1,243 @@ + + + + + +json-c: Main Page + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + +
+
+
+
json-c Documentation
+
+
+

json-c

+
    +
  1. Overview and Build Status
    2. +
  2. Building on Unix +
    3. +
  3. CMake options
    4. +
  4. Testing
    5. +
  5. Building with `vcpkg`
    6. +
  6. Linking to libjson-c
    7. +
  7. Using json-c
    8. +
+

JSON-C - A JSON implementation in C

+

JSON-C implements a reference counting object model that allows you to easily construct JSON objects in C, output them as JSON formatted strings and parse JSON formatted strings back into the C representation of JSON objects. It aims to conform to RFC 7159.

+

Skip down to Using json-c or check out the API docs, if you already have json-c installed and ready to use.

+

Home page for json-c: https://github.com/json-c/json-c/wiki

+

Build Status

+ +

Test Status

+ +

Building on Unix with git, gcc and cmake

+

If you already have json-c installed, see Linking to `libjson-c` for how to build and link your program against it.

+

Prerequisites:

+
    +
  • gcc, clang, or another C compiler
    • +
+
    +
  • cmake>=2.8, >=3.16 recommended, cmake=>3.1 for tests
    • +
+

To generate docs you'll also need:

+
    +
  • doxygen>=1.8.13
    • +
+

If you are on a relatively modern system, you'll likely be able to install the prerequisites using your OS's packaging system.

+

Install using apt (e.g. Ubuntu 16.04.2 LTS)

+
sudo apt install git
+sudo apt install cmake
+sudo apt install doxygen  # optional
+sudo apt install valgrind # optional
+

Build instructions:

+

json-c GitHub repo: https://github.com/json-c/json-c

+
$ git clone https://github.com/json-c/json-c.git
+$ mkdir json-c-build
+$ cd json-c-build
+$ cmake ../json-c   # See CMake section below for custom arguments
+

Note: it's also possible to put your build directory inside the json-c source directory, or even not use a separate build directory at all, but certain things might not work quite right (notably, make distcheck)

+

Then:

+
$ make
+$ make test
+$ make USE_VALGRIND=0 test   # optionally skip using valgrind
+$ make install
+

Generating documentation with Doxygen:

+

The library documentation can be generated directly from the source code using Doxygen tool:

+
# in build directory
+make doc
+google-chrome doc/html/index.html
+

CMake Options

+

The json-c library is built with CMake, which can take a few options.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Variable Type Description
CMAKE_INSTALL_PREFIX String The install location.
CMAKE_BUILD_TYPE String Defaults to "debug".
BUILD_SHARED_LIBS Bool The default build generates a dynamic (dll/so) library. Set this to OFF to create a static library only.
BUILD_STATIC_LIBS Bool The default build generates a static (lib/a) library. Set this to OFF to create a shared library only.
DISABLE_STATIC_FPIC Bool The default builds position independent code. Set this to OFF to create a shared library only.
DISABLE_BSYMBOLIC Bool Disable use of -Bsymbolic-functions.
DISABLE_THREAD_LOCAL_STORAGE Bool Disable use of Thread-Local Storage (HAVE___THREAD).
DISABLE_WERROR Bool Disable use of -Werror.
ENABLE_RDRAND Bool Enable RDRAND Hardware RNG Hash Seed.
ENABLE_THREADING Bool Enable partial threading support.
OVERRIDE_GET_RANDOM_SEED String A block of code to use instead of the default implementation of json_c_get_random_seed(), e.g. on embedded platforms where not even the fallback to time() works. Must be a single line.
+

Pass these options as -D on CMake's command-line.

+
# build a static library only
+cmake -DBUILD_SHARED_LIBS=OFF ..
+

Building with partial threading support

+

Although json-c does not support fully multi-threaded access to object trees, it has some code to help make its use in threaded programs a bit safer. Currently, this is limited to using atomic operations for json_object_get() and json_object_put().

+

Since this may have a performance impact, of at least 3x slower according to https://stackoverflow.com/a/11609063, it is disabled by default. You may turn it on by adjusting your cmake command with: -DENABLE_THREADING=ON

+

Separately, the default hash function used for object field keys, lh_char_hash, uses a compare-and-swap operation to ensure the random seed is only generated once. Because this is a one-time operation, it is always compiled in when the compare-and-swap operation is available.

+

cmake-configure wrapper script

+

For those familiar with the old autoconf/autogen.sh/configure method, there is a cmake-configure wrapper script to ease the transition to cmake.

+
mkdir build
+cd build
+../cmake-configure --prefix=/some/install/path
+make
+

cmake-configure can take a few options.

+ + + + + + + + + + + + + + + + + +
options Description
prefix=PREFIX install architecture-independent files in PREFIX
enable-threading Enable code to support partly multi-threaded use
enable-rdrand Enable RDRAND Hardware RNG Hash Seed generation on supported x86/x64 platforms.
enable-shared build shared libraries [default=yes]
enable-static build static libraries [default=yes]
disable-Bsymbolic Avoid linking with -Bsymbolic-function
disable-werror Avoid treating compiler warnings as fatal errors
+

Testing:

+

By default, if valgrind is available running tests uses it. That can slow the tests down considerably, so to disable it use:

+
export USE_VALGRIND=0
+

To run tests a separate build directory is recommended:

+
mkdir build-test
+cd build-test
+# VALGRIND=1 causes -DVALGRIND=1 to be passed when compiling code
+# which uses slightly slower, but valgrind-safe code.
+VALGRIND=1 cmake ..
+make
+
+make test
+# By default, if valgrind is available running tests uses it.
+make USE_VALGRIND=0 test   # optionally skip using valgrind
+

If a test fails, check Testing/Temporary/LastTest.log, tests/testSubDir/${testname}/${testname}.vg.out, and other similar files. If there is insufficient output try:

+
VERBOSE=1 CTEST_OUTPUT_ON_FAILURE=1 make test
+

or

+
JSONC_TEST_TRACE=1 make test
+

and check the log files again.

+

Building on Unix and Windows with vcpkg

+

You can download and install JSON-C using the vcpkg dependency manager:

+
git clone https://github.com/Microsoft/vcpkg.git
+cd vcpkg
+./bootstrap-vcpkg.sh
+./vcpkg integrate install
+vcpkg install json-c
+

The JSON-C port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the vcpkg repository.

+

Linking to libjson-c

+

If your system has pkgconfig, then you can just add this to your makefile:

+
CFLAGS += $(shell pkg-config --cflags json-c)
+LDFLAGS += $(shell pkg-config --libs json-c)
+

Without pkgconfig, you might do something like this:

+
JSON_C_DIR=/path/to/json_c/install
+CFLAGS += -I$(JSON_C_DIR)/include/json-c
+# Or to use lines like: #include <json-c/json_object.h>
+#CFLAGS += -I$(JSON_C_DIR)/include
+LDFLAGS+= -L$(JSON_C_DIR)/lib -ljson-c
+

If your project uses cmake:

+
    +

  • Add to your CMakeLists.txt file:

    +

    find_package(json-c CONFIG) target_link_libraries(${PROJECT_NAME} PRIVATE json-c::json-c)

    +
    • +
+
    +

  • Then you might run in your project:

    +

    cd build cmake -DCMAKE_PREFIX_PATH=/path/to/json_c/install/lib64/cmake ..

    +
    • +
+

Using json-c

+

To use json-c you can either include json.h, or preferably, one of the following more specific header files:

+ +

For a full list of headers see files.html

+

The primary type in json-c is json_object. It describes a reference counted tree of json objects which are created by either parsing text with a json_tokener (i.e. json_tokener_parse_ex()), or by creating (with json_object_new_object(), json_object_new_int(), etc...) and adding (with json_object_object_add(), json_object_array_add(), etc...) them individually. Typically, every object in the tree will have one reference, from its parent. When you are done with the tree of objects, you call json_object_put() on just the root object to free it, which recurses down through any child objects calling json_object_put() on each one of those in turn.

+

You can get a reference to a single child (json_object_object_get() or json_object_array_get_idx()) and use that object as long as its parent is valid. If you need a child object to live longer than its parent, you can increment the child's refcount (json_object_get()) to allow it to survive the parent being freed or it being removed from its parent (json_object_object_del() or json_object_array_del_idx())

+

When parsing text, the json_tokener object is independent from the json_object that it returns. It can be allocated (json_tokener_new()) used one or multiple times (json_tokener_parse_ex(), and freed (json_tokener_free()) while the json_object objects live on.

+

A json_object tree can be serialized back into a string with json_object_to_json_string_ext(). The string that is returned is only valid until the next "to_json_string" call on that same object. Also, it is freed when the json_object is freed.

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/issues__closed__for__0_813_8md.html b/doc/html/issues__closed__for__0_813_8md.html new file mode 100644 index 0000000..7f9b0e0 --- /dev/null +++ b/doc/html/issues__closed__for__0_813_8md.html @@ -0,0 +1,57 @@ + + + + + +json-c: issues_closed_for_0.13.md File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
issues_closed_for_0.13.md File Reference
+
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/issues__closed__for__0_814_8md.html b/doc/html/issues__closed__for__0_814_8md.html new file mode 100644 index 0000000..fb91c8f --- /dev/null +++ b/doc/html/issues__closed__for__0_814_8md.html @@ -0,0 +1,57 @@ + + + + + +json-c: issues_closed_for_0.14.md File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
issues_closed_for_0.14.md File Reference
+
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/issues__closed__for__0_815_8md.html b/doc/html/issues__closed__for__0_815_8md.html new file mode 100644 index 0000000..22df45d --- /dev/null +++ b/doc/html/issues__closed__for__0_815_8md.html @@ -0,0 +1,57 @@ + + + + + +json-c: issues_closed_for_0.15.md File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
issues_closed_for_0.15.md File Reference
+
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/issues__closed__for__0_816_8md.html b/doc/html/issues__closed__for__0_816_8md.html new file mode 100644 index 0000000..219384c --- /dev/null +++ b/doc/html/issues__closed__for__0_816_8md.html @@ -0,0 +1,57 @@ + + + + + +json-c: issues_closed_for_0.16.md File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+
issues_closed_for_0.16.md File Reference
+
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/jquery.js b/doc/html/jquery.js new file mode 100644 index 0000000..63939e7 --- /dev/null +++ b/doc/html/jquery.js @@ -0,0 +1,8 @@ +/*! jQuery v1.7.1 jquery.com | jquery.org/license */ +(function(a,b){function cy(a){return f.isWindow(a)?a:a.nodeType===9?a.defaultView||a.parentWindow:!1}function cv(a){if(!ck[a]){var b=c.body,d=f("<"+a+">").appendTo(b),e=d.css("display");d.remove();if(e==="none"||e===""){cl||(cl=c.createElement("iframe"),cl.frameBorder=cl.width=cl.height=0),b.appendChild(cl);if(!cm||!cl.createElement)cm=(cl.contentWindow||cl.contentDocument).document,cm.write((c.compatMode==="CSS1Compat"?"":"")+""),cm.close();d=cm.createElement(a),cm.body.appendChild(d),e=f.css(d,"display"),b.removeChild(cl)}ck[a]=e}return ck[a]}function cu(a,b){var c={};f.each(cq.concat.apply([],cq.slice(0,b)),function(){c[this]=a});return c}function ct(){cr=b}function cs(){setTimeout(ct,0);return cr=f.now()}function cj(){try{return new a.ActiveXObject("Microsoft.XMLHTTP")}catch(b){}}function ci(){try{return new a.XMLHttpRequest}catch(b){}}function cc(a,c){a.dataFilter&&(c=a.dataFilter(c,a.dataType));var d=a.dataTypes,e={},g,h,i=d.length,j,k=d[0],l,m,n,o,p;for(g=1;g0){if(c!=="border")for(;g=0===c})}function S(a){return!a||!a.parentNode||a.parentNode.nodeType===11}function K(){return!0}function J(){return!1}function n(a,b,c){var d=b+"defer",e=b+"queue",g=b+"mark",h=f._data(a,d);h&&(c==="queue"||!f._data(a,e))&&(c==="mark"||!f._data(a,g))&&setTimeout(function(){!f._data(a,e)&&!f._data(a,g)&&(f.removeData(a,d,!0),h.fire())},0)}function m(a){for(var b in a){if(b==="data"&&f.isEmptyObject(a[b]))continue;if(b!=="toJSON")return!1}return!0}function l(a,c,d){if(d===b&&a.nodeType===1){var e="data-"+c.replace(k,"-$1").toLowerCase();d=a.getAttribute(e);if(typeof d=="string"){try{d=d==="true"?!0:d==="false"?!1:d==="null"?null:f.isNumeric(d)?parseFloat(d):j.test(d)?f.parseJSON(d):d}catch(g){}f.data(a,c,d)}else d=b}return d}function h(a){var b=g[a]={},c,d;a=a.split(/\s+/);for(c=0,d=a.length;c)[^>]*$|#([\w\-]*)$)/,j=/\S/,k=/^\s+/,l=/\s+$/,m=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,n=/^[\],:{}\s]*$/,o=/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,p=/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,q=/(?:^|:|,)(?:\s*\[)+/g,r=/(webkit)[ \/]([\w.]+)/,s=/(opera)(?:.*version)?[ \/]([\w.]+)/,t=/(msie) ([\w.]+)/,u=/(mozilla)(?:.*? rv:([\w.]+))?/,v=/-([a-z]|[0-9])/ig,w=/^-ms-/,x=function(a,b){return(b+"").toUpperCase()},y=d.userAgent,z,A,B,C=Object.prototype.toString,D=Object.prototype.hasOwnProperty,E=Array.prototype.push,F=Array.prototype.slice,G=String.prototype.trim,H=Array.prototype.indexOf,I={};e.fn=e.prototype={constructor:e,init:function(a,d,f){var g,h,j,k;if(!a)return this;if(a.nodeType){this.context=this[0]=a,this.length=1;return this}if(a==="body"&&!d&&c.body){this.context=c,this[0]=c.body,this.selector=a,this.length=1;return this}if(typeof a=="string"){a.charAt(0)!=="<"||a.charAt(a.length-1)!==">"||a.length<3?g=i.exec(a):g=[null,a,null];if(g&&(g[1]||!d)){if(g[1]){d=d instanceof e?d[0]:d,k=d?d.ownerDocument||d:c,j=m.exec(a),j?e.isPlainObject(d)?(a=[c.createElement(j[1])],e.fn.attr.call(a,d,!0)):a=[k.createElement(j[1])]:(j=e.buildFragment([g[1]],[k]),a=(j.cacheable?e.clone(j.fragment):j.fragment).childNodes);return e.merge(this,a)}h=c.getElementById(g[2]);if(h&&h.parentNode){if(h.id!==g[2])return f.find(a);this.length=1,this[0]=h}this.context=c,this.selector=a;return this}return!d||d.jquery?(d||f).find(a):this.constructor(d).find(a)}if(e.isFunction(a))return f.ready(a);a.selector!==b&&(this.selector=a.selector,this.context=a.context);return e.makeArray(a,this)},selector:"",jquery:"1.7.1",length:0,size:function(){return this.length},toArray:function(){return F.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this[this.length+a]:this[a]},pushStack:function(a,b,c){var d=this.constructor();e.isArray(a)?E.apply(d,a):e.merge(d,a),d.prevObject=this,d.context=this.context,b==="find"?d.selector=this.selector+(this.selector?" ":"")+c:b&&(d.selector=this.selector+"."+b+"("+c+")");return d},each:function(a,b){return e.each(this,a,b)},ready:function(a){e.bindReady(),A.add(a);return this},eq:function(a){a=+a;return a===-1?this.slice(a):this.slice(a,a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(F.apply(this,arguments),"slice",F.call(arguments).join(","))},map:function(a){return this.pushStack(e.map(this,function(b,c){return a.call(b,c,b)}))},end:function(){return this.prevObject||this.constructor(null)},push:E,sort:[].sort,splice:[].splice},e.fn.init.prototype=e.fn,e.extend=e.fn.extend=function(){var a,c,d,f,g,h,i=arguments[0]||{},j=1,k=arguments.length,l=!1;typeof i=="boolean"&&(l=i,i=arguments[1]||{},j=2),typeof i!="object"&&!e.isFunction(i)&&(i={}),k===j&&(i=this,--j);for(;j0)return;A.fireWith(c,[e]),e.fn.trigger&&e(c).trigger("ready").off("ready")}},bindReady:function(){if(!A){A=e.Callbacks("once memory");if(c.readyState==="complete")return setTimeout(e.ready,1);if(c.addEventListener)c.addEventListener("DOMContentLoaded",B,!1),a.addEventListener("load",e.ready,!1);else if(c.attachEvent){c.attachEvent("onreadystatechange",B),a.attachEvent("onload",e.ready);var b=!1;try{b=a.frameElement==null}catch(d){}c.documentElement.doScroll&&b&&J()}}},isFunction:function(a){return e.type(a)==="function"},isArray:Array.isArray||function(a){return e.type(a)==="array"},isWindow:function(a){return a&&typeof a=="object"&&"setInterval"in a},isNumeric:function(a){return!isNaN(parseFloat(a))&&isFinite(a)},type:function(a){return a==null?String(a):I[C.call(a)]||"object"},isPlainObject:function(a){if(!a||e.type(a)!=="object"||a.nodeType||e.isWindow(a))return!1;try{if(a.constructor&&!D.call(a,"constructor")&&!D.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}var d;for(d in a);return d===b||D.call(a,d)},isEmptyObject:function(a){for(var b in a)return!1;return!0},error:function(a){throw new Error(a)},parseJSON:function(b){if(typeof b!="string"||!b)return null;b=e.trim(b);if(a.JSON&&a.JSON.parse)return a.JSON.parse(b);if(n.test(b.replace(o,"@").replace(p,"]").replace(q,"")))return(new Function("return "+b))();e.error("Invalid JSON: "+b)},parseXML:function(c){var d,f;try{a.DOMParser?(f=new DOMParser,d=f.parseFromString(c,"text/xml")):(d=new ActiveXObject("Microsoft.XMLDOM"),d.async="false",d.loadXML(c))}catch(g){d=b}(!d||!d.documentElement||d.getElementsByTagName("parsererror").length)&&e.error("Invalid XML: "+c);return d},noop:function(){},globalEval:function(b){b&&j.test(b)&&(a.execScript||function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return a.replace(w,"ms-").replace(v,x)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toUpperCase()===b.toUpperCase()},each:function(a,c,d){var f,g=0,h=a.length,i=h===b||e.isFunction(a);if(d){if(i){for(f in a)if(c.apply(a[f],d)===!1)break}else for(;g0&&a[0]&&a[j-1]||j===0||e.isArray(a));if(k)for(;i1?i.call(arguments,0):b,j.notifyWith(k,e)}}function l(a){return function(c){b[a]=arguments.length>1?i.call(arguments,0):c,--g||j.resolveWith(j,b)}}var b=i.call(arguments,0),c=0,d=b.length,e=Array(d),g=d,h=d,j=d<=1&&a&&f.isFunction(a.promise)?a:f.Deferred(),k=j.promise();if(d>1){for(;c
a",d=q.getElementsByTagName("*"),e=q.getElementsByTagName("a")[0];if(!d||!d.length||!e)return{};g=c.createElement("select"),h=g.appendChild(c.createElement("option")),i=q.getElementsByTagName("input")[0],b={leadingWhitespace:q.firstChild.nodeType===3,tbody:!q.getElementsByTagName("tbody").length,htmlSerialize:!!q.getElementsByTagName("link").length,style:/top/.test(e.getAttribute("style")),hrefNormalized:e.getAttribute("href")==="/a",opacity:/^0.55/.test(e.style.opacity),cssFloat:!!e.style.cssFloat,checkOn:i.value==="on",optSelected:h.selected,getSetAttribute:q.className!=="t",enctype:!!c.createElement("form").enctype,html5Clone:c.createElement("nav").cloneNode(!0).outerHTML!=="<:nav>",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0},i.checked=!0,b.noCloneChecked=i.cloneNode(!0).checked,g.disabled=!0,b.optDisabled=!h.disabled;try{delete q.test}catch(s){b.deleteExpando=!1}!q.addEventListener&&q.attachEvent&&q.fireEvent&&(q.attachEvent("onclick",function(){b.noCloneEvent=!1}),q.cloneNode(!0).fireEvent("onclick")),i=c.createElement("input"),i.value="t",i.setAttribute("type","radio"),b.radioValue=i.value==="t",i.setAttribute("checked","checked"),q.appendChild(i),k=c.createDocumentFragment(),k.appendChild(q.lastChild),b.checkClone=k.cloneNode(!0).cloneNode(!0).lastChild.checked,b.appendChecked=i.checked,k.removeChild(i),k.appendChild(q),q.innerHTML="",a.getComputedStyle&&(j=c.createElement("div"),j.style.width="0",j.style.marginRight="0",q.style.width="2px",q.appendChild(j),b.reliableMarginRight=(parseInt((a.getComputedStyle(j,null)||{marginRight:0}).marginRight,10)||0)===0);if(q.attachEvent)for(o in{submit:1,change:1,focusin:1})n="on"+o,p=n in q,p||(q.setAttribute(n,"return;"),p=typeof q[n]=="function"),b[o+"Bubbles"]=p;k.removeChild(q),k=g=h=j=q=i=null,f(function(){var a,d,e,g,h,i,j,k,m,n,o,r=c.getElementsByTagName("body")[0];!r||(j=1,k="position:absolute;top:0;left:0;width:1px;height:1px;margin:0;",m="visibility:hidden;border:0;",n="style='"+k+"border:5px solid #000;padding:0;'",o="
"+""+"
",a=c.createElement("div"),a.style.cssText=m+"width:0;height:0;position:static;top:0;margin-top:"+j+"px",r.insertBefore(a,r.firstChild),q=c.createElement("div"),a.appendChild(q),q.innerHTML="
t
",l=q.getElementsByTagName("td"),p=l[0].offsetHeight===0,l[0].style.display="",l[1].style.display="none",b.reliableHiddenOffsets=p&&l[0].offsetHeight===0,q.innerHTML="",q.style.width=q.style.paddingLeft="1px",f.boxModel=b.boxModel=q.offsetWidth===2,typeof q.style.zoom!="undefined"&&(q.style.display="inline",q.style.zoom=1,b.inlineBlockNeedsLayout=q.offsetWidth===2,q.style.display="",q.innerHTML="
",b.shrinkWrapBlocks=q.offsetWidth!==2),q.style.cssText=k+m,q.innerHTML=o,d=q.firstChild,e=d.firstChild,h=d.nextSibling.firstChild.firstChild,i={doesNotAddBorder:e.offsetTop!==5,doesAddBorderForTableAndCells:h.offsetTop===5},e.style.position="fixed",e.style.top="20px",i.fixedPosition=e.offsetTop===20||e.offsetTop===15,e.style.position=e.style.top="",d.style.overflow="hidden",d.style.position="relative",i.subtractsBorderForOverflowNotVisible=e.offsetTop===-5,i.doesNotIncludeMarginInBodyOffset=r.offsetTop!==j,r.removeChild(a),q=a=null,f.extend(b,i))});return b}();var j=/^(?:\{.*\}|\[.*\])$/,k=/([A-Z])/g;f.extend({cache:{},uuid:0,expando:"jQuery"+(f.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(a){a=a.nodeType?f.cache[a[f.expando]]:a[f.expando];return!!a&&!m(a)},data:function(a,c,d,e){if(!!f.acceptData(a)){var g,h,i,j=f.expando,k=typeof c=="string",l=a.nodeType,m=l?f.cache:a,n=l?a[j]:a[j]&&j,o=c==="events";if((!n||!m[n]||!o&&!e&&!m[n].data)&&k&&d===b)return;n||(l?a[j]=n=++f.uuid:n=j),m[n]||(m[n]={},l||(m[n].toJSON=f.noop));if(typeof c=="object"||typeof c=="function")e?m[n]=f.extend(m[n],c):m[n].data=f.extend(m[n].data,c);g=h=m[n],e||(h.data||(h.data={}),h=h.data),d!==b&&(h[f.camelCase(c)]=d);if(o&&!h[c])return g.events;k?(i=h[c],i==null&&(i=h[f.camelCase(c)])):i=h;return i}},removeData:function(a,b,c){if(!!f.acceptData(a)){var d,e,g,h=f.expando,i=a.nodeType,j=i?f.cache:a,k=i?a[h]:h;if(!j[k])return;if(b){d=c?j[k]:j[k].data;if(d){f.isArray(b)||(b in d?b=[b]:(b=f.camelCase(b),b in d?b=[b]:b=b.split(" ")));for(e=0,g=b.length;e-1)return!0;return!1},val:function(a){var c,d,e,g=this[0];{if(!!arguments.length){e=f.isFunction(a);return this.each(function(d){var g=f(this),h;if(this.nodeType===1){e?h=a.call(this,d,g.val()):h=a,h==null?h="":typeof h=="number"?h+="":f.isArray(h)&&(h=f.map(h,function(a){return a==null?"":a+""})),c=f.valHooks[this.nodeName.toLowerCase()]||f.valHooks[this.type];if(!c||!("set"in c)||c.set(this,h,"value")===b)this.value=h}})}if(g){c=f.valHooks[g.nodeName.toLowerCase()]||f.valHooks[g.type];if(c&&"get"in c&&(d=c.get(g,"value"))!==b)return d;d=g.value;return typeof d=="string"?d.replace(q,""):d==null?"":d}}}}),f.extend({valHooks:{option:{get:function(a){var b=a.attributes.value;return!b||b.specified?a.value:a.text}},select:{get:function(a){var b,c,d,e,g=a.selectedIndex,h=[],i=a.options,j=a.type==="select-one";if(g<0)return null;c=j?g:0,d=j?g+1:i.length;for(;c=0}),c.length||(a.selectedIndex=-1);return c}}},attrFn:{val:!0,css:!0,html:!0,text:!0,data:!0,width:!0,height:!0,offset:!0},attr:function(a,c,d,e){var g,h,i,j=a.nodeType;if(!!a&&j!==3&&j!==8&&j!==2){if(e&&c in f.attrFn)return f(a)[c](d);if(typeof a.getAttribute=="undefined")return f.prop(a,c,d);i=j!==1||!f.isXMLDoc(a),i&&(c=c.toLowerCase(),h=f.attrHooks[c]||(u.test(c)?x:w));if(d!==b){if(d===null){f.removeAttr(a,c);return}if(h&&"set"in h&&i&&(g=h.set(a,d,c))!==b)return g;a.setAttribute(c,""+d);return d}if(h&&"get"in h&&i&&(g=h.get(a,c))!==null)return g;g=a.getAttribute(c);return g===null?b:g}},removeAttr:function(a,b){var c,d,e,g,h=0;if(b&&a.nodeType===1){d=b.toLowerCase().split(p),g=d.length;for(;h=0}})});var z=/^(?:textarea|input|select)$/i,A=/^([^\.]*)?(?:\.(.+))?$/,B=/\bhover(\.\S+)?\b/,C=/^key/,D=/^(?:mouse|contextmenu)|click/,E=/^(?:focusinfocus|focusoutblur)$/,F=/^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/,G=function(a){var b=F.exec(a);b&&(b[1]=(b[1]||"").toLowerCase(),b[3]=b[3]&&new RegExp("(?:^|\\s)"+b[3]+"(?:\\s|$)"));return b},H=function(a,b){var c=a.attributes||{};return(!b[1]||a.nodeName.toLowerCase()===b[1])&&(!b[2]||(c.id||{}).value===b[2])&&(!b[3]||b[3].test((c["class"]||{}).value))},I=function(a){return f.event.special.hover?a:a.replace(B,"mouseenter$1 mouseleave$1")}; +f.event={add:function(a,c,d,e,g){var h,i,j,k,l,m,n,o,p,q,r,s;if(!(a.nodeType===3||a.nodeType===8||!c||!d||!(h=f._data(a)))){d.handler&&(p=d,d=p.handler),d.guid||(d.guid=f.guid++),j=h.events,j||(h.events=j={}),i=h.handle,i||(h.handle=i=function(a){return typeof f!="undefined"&&(!a||f.event.triggered!==a.type)?f.event.dispatch.apply(i.elem,arguments):b},i.elem=a),c=f.trim(I(c)).split(" ");for(k=0;k=0&&(h=h.slice(0,-1),k=!0),h.indexOf(".")>=0&&(i=h.split("."),h=i.shift(),i.sort());if((!e||f.event.customEvent[h])&&!f.event.global[h])return;c=typeof c=="object"?c[f.expando]?c:new f.Event(h,c):new f.Event(h),c.type=h,c.isTrigger=!0,c.exclusive=k,c.namespace=i.join("."),c.namespace_re=c.namespace?new RegExp("(^|\\.)"+i.join("\\.(?:.*\\.)?")+"(\\.|$)"):null,o=h.indexOf(":")<0?"on"+h:"";if(!e){j=f.cache;for(l in j)j[l].events&&j[l].events[h]&&f.event.trigger(c,d,j[l].handle.elem,!0);return}c.result=b,c.target||(c.target=e),d=d!=null?f.makeArray(d):[],d.unshift(c),p=f.event.special[h]||{};if(p.trigger&&p.trigger.apply(e,d)===!1)return;r=[[e,p.bindType||h]];if(!g&&!p.noBubble&&!f.isWindow(e)){s=p.delegateType||h,m=E.test(s+h)?e:e.parentNode,n=null;for(;m;m=m.parentNode)r.push([m,s]),n=m;n&&n===e.ownerDocument&&r.push([n.defaultView||n.parentWindow||a,s])}for(l=0;le&&i.push({elem:this,matches:d.slice(e)});for(j=0;j0?this.on(b,null,a,c):this.trigger(b)},f.attrFn&&(f.attrFn[b]=!0),C.test(b)&&(f.event.fixHooks[b]=f.event.keyHooks),D.test(b)&&(f.event.fixHooks[b]=f.event.mouseHooks)}),function(){function x(a,b,c,e,f,g){for(var h=0,i=e.length;h0){k=j;break}}j=j[a]}e[h]=k}}}function w(a,b,c,e,f,g){for(var h=0,i=e.length;h+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,d="sizcache"+(Math.random()+"").replace(".",""),e=0,g=Object.prototype.toString,h=!1,i=!0,j=/\\/g,k=/\r\n/g,l=/\W/;[0,0].sort(function(){i=!1;return 0});var m=function(b,d,e,f){e=e||[],d=d||c;var h=d;if(d.nodeType!==1&&d.nodeType!==9)return[];if(!b||typeof b!="string")return e;var i,j,k,l,n,q,r,t,u=!0,v=m.isXML(d),w=[],x=b;do{a.exec(""),i=a.exec(x);if(i){x=i[3],w.push(i[1]);if(i[2]){l=i[3];break}}}while(i);if(w.length>1&&p.exec(b))if(w.length===2&&o.relative[w[0]])j=y(w[0]+w[1],d,f);else{j=o.relative[w[0]]?[d]:m(w.shift(),d);while(w.length)b=w.shift(),o.relative[b]&&(b+=w.shift()),j=y(b,j,f)}else{!f&&w.length>1&&d.nodeType===9&&!v&&o.match.ID.test(w[0])&&!o.match.ID.test(w[w.length-1])&&(n=m.find(w.shift(),d,v),d=n.expr?m.filter(n.expr,n.set)[0]:n.set[0]);if(d){n=f?{expr:w.pop(),set:s(f)}:m.find(w.pop(),w.length===1&&(w[0]==="~"||w[0]==="+")&&d.parentNode?d.parentNode:d,v),j=n.expr?m.filter(n.expr,n.set):n.set,w.length>0?k=s(j):u=!1;while(w.length)q=w.pop(),r=q,o.relative[q]?r=w.pop():q="",r==null&&(r=d),o.relative[q](k,r,v)}else k=w=[]}k||(k=j),k||m.error(q||b);if(g.call(k)==="[object Array]")if(!u)e.push.apply(e,k);else if(d&&d.nodeType===1)for(t=0;k[t]!=null;t++)k[t]&&(k[t]===!0||k[t].nodeType===1&&m.contains(d,k[t]))&&e.push(j[t]);else for(t=0;k[t]!=null;t++)k[t]&&k[t].nodeType===1&&e.push(j[t]);else s(k,e);l&&(m(l,h,e,f),m.uniqueSort(e));return e};m.uniqueSort=function(a){if(u){h=i,a.sort(u);if(h)for(var b=1;b0},m.find=function(a,b,c){var d,e,f,g,h,i;if(!a)return[];for(e=0,f=o.order.length;e":function(a,b){var c,d=typeof b=="string",e=0,f=a.length;if(d&&!l.test(b)){b=b.toLowerCase();for(;e=0)?c||d.push(h):c&&(b[g]=!1));return!1},ID:function(a){return a[1].replace(j,"")},TAG:function(a,b){return a[1].replace(j,"").toLowerCase()},CHILD:function(a){if(a[1]==="nth"){a[2]||m.error(a[0]),a[2]=a[2].replace(/^\+|\s*/g,"");var b=/(-?)(\d*)(?:n([+\-]?\d*))?/.exec(a[2]==="even"&&"2n"||a[2]==="odd"&&"2n+1"||!/\D/.test(a[2])&&"0n+"+a[2]||a[2]);a[2]=b[1]+(b[2]||1)-0,a[3]=b[3]-0}else a[2]&&m.error(a[0]);a[0]=e++;return a},ATTR:function(a,b,c,d,e,f){var g=a[1]=a[1].replace(j,"");!f&&o.attrMap[g]&&(a[1]=o.attrMap[g]),a[4]=(a[4]||a[5]||"").replace(j,""),a[2]==="~="&&(a[4]=" "+a[4]+" ");return a},PSEUDO:function(b,c,d,e,f){if(b[1]==="not")if((a.exec(b[3])||"").length>1||/^\w/.test(b[3]))b[3]=m(b[3],null,null,c);else{var g=m.filter(b[3],c,d,!0^f);d||e.push.apply(e,g);return!1}else if(o.match.POS.test(b[0])||o.match.CHILD.test(b[0]))return!0;return b},POS:function(a){a.unshift(!0);return a}},filters:{enabled:function(a){return a.disabled===!1&&a.type!=="hidden"},disabled:function(a){return a.disabled===!0},checked:function(a){return a.checked===!0},selected:function(a){a.parentNode&&a.parentNode.selectedIndex;return a.selected===!0},parent:function(a){return!!a.firstChild},empty:function(a){return!a.firstChild},has:function(a,b,c){return!!m(c[3],a).length},header:function(a){return/h\d/i.test(a.nodeName)},text:function(a){var b=a.getAttribute("type"),c=a.type;return a.nodeName.toLowerCase()==="input"&&"text"===c&&(b===c||b===null)},radio:function(a){return a.nodeName.toLowerCase()==="input"&&"radio"===a.type},checkbox:function(a){return a.nodeName.toLowerCase()==="input"&&"checkbox"===a.type},file:function(a){return a.nodeName.toLowerCase()==="input"&&"file"===a.type},password:function(a){return a.nodeName.toLowerCase()==="input"&&"password"===a.type},submit:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"submit"===a.type},image:function(a){return a.nodeName.toLowerCase()==="input"&&"image"===a.type},reset:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"reset"===a.type},button:function(a){var b=a.nodeName.toLowerCase();return b==="input"&&"button"===a.type||b==="button"},input:function(a){return/input|select|textarea|button/i.test(a.nodeName)},focus:function(a){return a===a.ownerDocument.activeElement}},setFilters:{first:function(a,b){return b===0},last:function(a,b,c,d){return b===d.length-1},even:function(a,b){return b%2===0},odd:function(a,b){return b%2===1},lt:function(a,b,c){return bc[3]-0},nth:function(a,b,c){return c[3]-0===b},eq:function(a,b,c){return c[3]-0===b}},filter:{PSEUDO:function(a,b,c,d){var e=b[1],f=o.filters[e];if(f)return f(a,c,b,d);if(e==="contains")return(a.textContent||a.innerText||n([a])||"").indexOf(b[3])>=0;if(e==="not"){var g=b[3];for(var h=0,i=g.length;h=0}},ID:function(a,b){return a.nodeType===1&&a.getAttribute("id")===b},TAG:function(a,b){return b==="*"&&a.nodeType===1||!!a.nodeName&&a.nodeName.toLowerCase()===b},CLASS:function(a,b){return(" "+(a.className||a.getAttribute("class"))+" ").indexOf(b)>-1},ATTR:function(a,b){var c=b[1],d=m.attr?m.attr(a,c):o.attrHandle[c]?o.attrHandle[c](a):a[c]!=null?a[c]:a.getAttribute(c),e=d+"",f=b[2],g=b[4];return d==null?f==="!=":!f&&m.attr?d!=null:f==="="?e===g:f==="*="?e.indexOf(g)>=0:f==="~="?(" "+e+" ").indexOf(g)>=0:g?f==="!="?e!==g:f==="^="?e.indexOf(g)===0:f==="$="?e.substr(e.length-g.length)===g:f==="|="?e===g||e.substr(0,g.length+1)===g+"-":!1:e&&d!==!1},POS:function(a,b,c,d){var e=b[2],f=o.setFilters[e];if(f)return f(a,c,b,d)}}},p=o.match.POS,q=function(a,b){return"\\"+(b-0+1)};for(var r in o.match)o.match[r]=new RegExp(o.match[r].source+/(?![^\[]*\])(?![^\(]*\))/.source),o.leftMatch[r]=new RegExp(/(^(?:.|\r|\n)*?)/.source+o.match[r].source.replace(/\\(\d+)/g,q));var s=function(a,b){a=Array.prototype.slice.call(a,0);if(b){b.push.apply(b,a);return b}return a};try{Array.prototype.slice.call(c.documentElement.childNodes,0)[0].nodeType}catch(t){s=function(a,b){var c=0,d=b||[];if(g.call(a)==="[object Array]")Array.prototype.push.apply(d,a);else if(typeof a.length=="number")for(var e=a.length;c",e.insertBefore(a,e.firstChild),c.getElementById(d)&&(o.find.ID=function(a,c,d){if(typeof c.getElementById!="undefined"&&!d){var e=c.getElementById(a[1]);return e?e.id===a[1]||typeof e.getAttributeNode!="undefined"&&e.getAttributeNode("id").nodeValue===a[1]?[e]:b:[]}},o.filter.ID=function(a,b){var c=typeof a.getAttributeNode!="undefined"&&a.getAttributeNode("id");return a.nodeType===1&&c&&c.nodeValue===b}),e.removeChild(a),e=a=null}(),function(){var a=c.createElement("div");a.appendChild(c.createComment("")),a.getElementsByTagName("*").length>0&&(o.find.TAG=function(a,b){var c=b.getElementsByTagName(a[1]);if(a[1]==="*"){var d=[];for(var e=0;c[e];e++)c[e].nodeType===1&&d.push(c[e]);c=d}return c}),a.innerHTML="",a.firstChild&&typeof a.firstChild.getAttribute!="undefined"&&a.firstChild.getAttribute("href")!=="#"&&(o.attrHandle.href=function(a){return a.getAttribute("href",2)}),a=null}(),c.querySelectorAll&&function(){var a=m,b=c.createElement("div"),d="__sizzle__";b.innerHTML="

";if(!b.querySelectorAll||b.querySelectorAll(".TEST").length!==0){m=function(b,e,f,g){e=e||c;if(!g&&!m.isXML(e)){var h=/^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec(b);if(h&&(e.nodeType===1||e.nodeType===9)){if(h[1])return s(e.getElementsByTagName(b),f);if(h[2]&&o.find.CLASS&&e.getElementsByClassName)return s(e.getElementsByClassName(h[2]),f)}if(e.nodeType===9){if(b==="body"&&e.body)return s([e.body],f);if(h&&h[3]){var i=e.getElementById(h[3]);if(!i||!i.parentNode)return s([],f);if(i.id===h[3])return s([i],f)}try{return s(e.querySelectorAll(b),f)}catch(j){}}else if(e.nodeType===1&&e.nodeName.toLowerCase()!=="object"){var k=e,l=e.getAttribute("id"),n=l||d,p=e.parentNode,q=/^\s*[+~]/.test(b);l?n=n.replace(/'/g,"\\$&"):e.setAttribute("id",n),q&&p&&(e=e.parentNode);try{if(!q||p)return s(e.querySelectorAll("[id='"+n+"'] "+b),f)}catch(r){}finally{l||k.removeAttribute("id")}}}return a(b,e,f,g)};for(var e in a)m[e]=a[e];b=null}}(),function(){var a=c.documentElement,b=a.matchesSelector||a.mozMatchesSelector||a.webkitMatchesSelector||a.msMatchesSelector;if(b){var d=!b.call(c.createElement("div"),"div"),e=!1;try{b.call(c.documentElement,"[test!='']:sizzle")}catch(f){e=!0}m.matchesSelector=function(a,c){c=c.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!m.isXML(a))try{if(e||!o.match.PSEUDO.test(c)&&!/!=/.test(c)){var f=b.call(a,c);if(f||!d||a.document&&a.document.nodeType!==11)return f}}catch(g){}return m(c,null,null,[a]).length>0}}}(),function(){var a=c.createElement("div");a.innerHTML="
";if(!!a.getElementsByClassName&&a.getElementsByClassName("e").length!==0){a.lastChild.className="e";if(a.getElementsByClassName("e").length===1)return;o.order.splice(1,0,"CLASS"),o.find.CLASS=function(a,b,c){if(typeof b.getElementsByClassName!="undefined"&&!c)return b.getElementsByClassName(a[1])},a=null}}(),c.documentElement.contains?m.contains=function(a,b){return a!==b&&(a.contains?a.contains(b):!0)}:c.documentElement.compareDocumentPosition?m.contains=function(a,b){return!!(a.compareDocumentPosition(b)&16)}:m.contains=function(){return!1},m.isXML=function(a){var b=(a?a.ownerDocument||a:0).documentElement;return b?b.nodeName!=="HTML":!1};var y=function(a,b,c){var d,e=[],f="",g=b.nodeType?[b]:b;while(d=o.match.PSEUDO.exec(a))f+=d[0],a=a.replace(o.match.PSEUDO,"");a=o.relative[a]?a+"*":a;for(var h=0,i=g.length;h0)for(h=g;h=0:f.filter(a,this).length>0:this.filter(a).length>0)},closest:function(a,b){var c=[],d,e,g=this[0];if(f.isArray(a)){var h=1;while(g&&g.ownerDocument&&g!==b){for(d=0;d-1:f.find.matchesSelector(g,a)){c.push(g);break}g=g.parentNode;if(!g||!g.ownerDocument||g===b||g.nodeType===11)break}}c=c.length>1?f.unique(c):c;return this.pushStack(c,"closest",a)},index:function(a){if(!a)return this[0]&&this[0].parentNode?this.prevAll().length:-1;if(typeof a=="string")return f.inArray(this[0],f(a));return f.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var c=typeof a=="string"?f(a,b):f.makeArray(a&&a.nodeType?[a]:a),d=f.merge(this.get(),c);return this.pushStack(S(c[0])||S(d[0])?d:f.unique(d))},andSelf:function(){return this.add(this.prevObject)}}),f.each({parent:function(a){var b=a.parentNode;return b&&b.nodeType!==11?b:null},parents:function(a){return f.dir(a,"parentNode")},parentsUntil:function(a,b,c){return f.dir(a,"parentNode",c)},next:function(a){return f.nth(a,2,"nextSibling")},prev:function(a){return f.nth(a,2,"previousSibling")},nextAll:function(a){return f.dir(a,"nextSibling")},prevAll:function(a){return f.dir(a,"previousSibling")},nextUntil:function(a,b,c){return f.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return f.dir(a,"previousSibling",c)},siblings:function(a){return f.sibling(a.parentNode.firstChild,a)},children:function(a){return f.sibling(a.firstChild)},contents:function(a){return f.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:f.makeArray(a.childNodes)}},function(a,b){f.fn[a]=function(c,d){var e=f.map(this,b,c);L.test(a)||(d=c),d&&typeof d=="string"&&(e=f.filter(d,e)),e=this.length>1&&!R[a]?f.unique(e):e,(this.length>1||N.test(d))&&M.test(a)&&(e=e.reverse());return this.pushStack(e,a,P.call(arguments).join(","))}}),f.extend({filter:function(a,b,c){c&&(a=":not("+a+")");return b.length===1?f.find.matchesSelector(b[0],a)?[b[0]]:[]:f.find.matches(a,b)},dir:function(a,c,d){var e=[],g=a[c];while(g&&g.nodeType!==9&&(d===b||g.nodeType!==1||!f(g).is(d)))g.nodeType===1&&e.push(g),g=g[c];return e},nth:function(a,b,c,d){b=b||1;var e=0;for(;a;a=a[c])if(a.nodeType===1&&++e===b)break;return a},sibling:function(a,b){var c=[];for(;a;a=a.nextSibling)a.nodeType===1&&a!==b&&c.push(a);return c}});var V="abbr|article|aside|audio|canvas|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",W=/ jQuery\d+="(?:\d+|null)"/g,X=/^\s+/,Y=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,Z=/<([\w:]+)/,$=/",""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]},bh=U(c);bg.optgroup=bg.option,bg.tbody=bg.tfoot=bg.colgroup=bg.caption=bg.thead,bg.th=bg.td,f.support.htmlSerialize||(bg._default=[1,"div
","
"]),f.fn.extend({text:function(a){if(f.isFunction(a))return this.each(function(b){var c=f(this);c.text(a.call(this,b,c.text()))});if(typeof a!="object"&&a!==b)return this.empty().append((this[0]&&this[0].ownerDocument||c).createTextNode(a));return f.text(this)},wrapAll:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapAll(a.call(this,b))});if(this[0]){var b=f(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&a.firstChild.nodeType===1)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapInner(a.call(this,b))});return this.each(function(){var b=f(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=f.isFunction(a);return this.each(function(c){f(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){f.nodeName(this,"body")||f(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.appendChild(a)})},prepend:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this)});if(arguments.length){var a=f.clean(arguments);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this.nextSibling)});if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,f.clean(arguments));return a}},remove:function(a,b){for(var c=0,d;(d=this[c])!=null;c++)if(!a||f.filter(a,[d]).length)!b&&d.nodeType===1&&(f.cleanData(d.getElementsByTagName("*")), +f.cleanData([d])),d.parentNode&&d.parentNode.removeChild(d);return this},empty:function() +{for(var a=0,b;(b=this[a])!=null;a++){b.nodeType===1&&f.cleanData(b.getElementsByTagName("*"));while(b.firstChild)b.removeChild(b.firstChild)}return this},clone:function(a,b){a=a==null?!1:a,b=b==null?a:b;return this.map(function(){return f.clone(this,a,b)})},html:function(a){if(a===b)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(W,""):null;if(typeof a=="string"&&!ba.test(a)&&(f.support.leadingWhitespace||!X.test(a))&&!bg[(Z.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Y,"<$1>");try{for(var c=0,d=this.length;c1&&l0?this.clone(!0):this).get();f(e[h])[b](j),d=d.concat(j)}return this.pushStack(d,a,e.selector)}}),f.extend({clone:function(a,b,c){var d,e,g,h=f.support.html5Clone||!bc.test("<"+a.nodeName)?a.cloneNode(!0):bo(a);if((!f.support.noCloneEvent||!f.support.noCloneChecked)&&(a.nodeType===1||a.nodeType===11)&&!f.isXMLDoc(a)){bk(a,h),d=bl(a),e=bl(h);for(g=0;d[g];++g)e[g]&&bk(d[g],e[g])}if(b){bj(a,h);if(c){d=bl(a),e=bl(h);for(g=0;d[g];++g)bj(d[g],e[g])}}d=e=null;return h},clean:function(a,b,d,e){var g;b=b||c,typeof b.createElement=="undefined"&&(b=b.ownerDocument||b[0]&&b[0].ownerDocument||c);var h=[],i;for(var j=0,k;(k=a[j])!=null;j++){typeof k=="number"&&(k+="");if(!k)continue;if(typeof k=="string")if(!_.test(k))k=b.createTextNode(k);else{k=k.replace(Y,"<$1>");var l=(Z.exec(k)||["",""])[1].toLowerCase(),m=bg[l]||bg._default,n=m[0],o=b.createElement("div");b===c?bh.appendChild(o):U(b).appendChild(o),o.innerHTML=m[1]+k+m[2];while(n--)o=o.lastChild;if(!f.support.tbody){var p=$.test(k),q=l==="table"&&!p?o.firstChild&&o.firstChild.childNodes:m[1]===""&&!p?o.childNodes:[];for(i=q.length-1;i>=0;--i)f.nodeName(q[i],"tbody")&&!q[i].childNodes.length&&q[i].parentNode.removeChild(q[i])}!f.support.leadingWhitespace&&X.test(k)&&o.insertBefore(b.createTextNode(X.exec(k)[0]),o.firstChild),k=o.childNodes}var r;if(!f.support.appendChecked)if(k[0]&&typeof (r=k.length)=="number")for(i=0;i=0)return b+"px"}}}),f.support.opacity||(f.cssHooks.opacity={get:function(a,b){return br.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=f.isNumeric(b)?"alpha(opacity="+b*100+")":"",g=d&&d.filter||c.filter||"";c.zoom=1;if(b>=1&&f.trim(g.replace(bq,""))===""){c.removeAttribute("filter");if(d&&!d.filter)return}c.filter=bq.test(g)?g.replace(bq,e):g+" "+e}}),f(function(){f.support.reliableMarginRight||(f.cssHooks.marginRight={get:function(a,b){var c;f.swap(a,{display:"inline-block"},function(){b?c=bz(a,"margin-right","marginRight"):c=a.style.marginRight});return c}})}),c.defaultView&&c.defaultView.getComputedStyle&&(bA=function(a,b){var c,d,e;b=b.replace(bs,"-$1").toLowerCase(),(d=a.ownerDocument.defaultView)&&(e=d.getComputedStyle(a,null))&&(c=e.getPropertyValue(b),c===""&&!f.contains(a.ownerDocument.documentElement,a)&&(c=f.style(a,b)));return c}),c.documentElement.currentStyle&&(bB=function(a,b){var c,d,e,f=a.currentStyle&&a.currentStyle[b],g=a.style;f===null&&g&&(e=g[b])&&(f=e),!bt.test(f)&&bu.test(f)&&(c=g.left,d=a.runtimeStyle&&a.runtimeStyle.left,d&&(a.runtimeStyle.left=a.currentStyle.left),g.left=b==="fontSize"?"1em":f||0,f=g.pixelLeft+"px",g.left=c,d&&(a.runtimeStyle.left=d));return f===""?"auto":f}),bz=bA||bB,f.expr&&f.expr.filters&&(f.expr.filters.hidden=function(a){var b=a.offsetWidth,c=a.offsetHeight;return b===0&&c===0||!f.support.reliableHiddenOffsets&&(a.style&&a.style.display||f.css(a,"display"))==="none"},f.expr.filters.visible=function(a){return!f.expr.filters.hidden(a)});var bD=/%20/g,bE=/\[\]$/,bF=/\r?\n/g,bG=/#.*$/,bH=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,bI=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,bJ=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,bK=/^(?:GET|HEAD)$/,bL=/^\/\//,bM=/\?/,bN=/)<[^<]*)*<\/script>/gi,bO=/^(?:select|textarea)/i,bP=/\s+/,bQ=/([?&])_=[^&]*/,bR=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+))?)?/,bS=f.fn.load,bT={},bU={},bV,bW,bX=["*/"]+["*"];try{bV=e.href}catch(bY){bV=c.createElement("a"),bV.href="",bV=bV.href}bW=bR.exec(bV.toLowerCase())||[],f.fn.extend({load:function(a,c,d){if(typeof a!="string"&&bS)return bS.apply(this,arguments);if(!this.length)return this;var e=a.indexOf(" ");if(e>=0){var g=a.slice(e,a.length);a=a.slice(0,e)}var h="GET";c&&(f.isFunction(c)?(d=c,c=b):typeof c=="object"&&(c=f.param(c,f.ajaxSettings.traditional),h="POST"));var i=this;f.ajax({url:a,type:h,dataType:"html",data:c,complete:function(a,b,c){c=a.responseText,a.isResolved()&&(a.done(function(a){c=a}),i.html(g?f("
").append(c.replace(bN,"")).find(g):c)),d&&i.each(d,[c,b,a])}});return this},serialize:function(){return f.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?f.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||bO.test(this.nodeName)||bI.test(this.type))}).map(function(a,b){var c=f(this).val();return c==null?null:f.isArray(c)?f.map(c,function(a,c){return{name:b.name,value:a.replace(bF,"\r\n")}}):{name:b.name,value:c.replace(bF,"\r\n")}}).get()}}),f.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(a,b){f.fn[b]=function(a){return this.on(b,a)}}),f.each(["get","post"],function(a,c){f[c]=function(a,d,e,g){f.isFunction(d)&&(g=g||e,e=d,d=b);return f.ajax({type:c,url:a,data:d,success:e,dataType:g})}}),f.extend({getScript:function(a,c){return f.get(a,b,c,"script")},getJSON:function(a,b,c){return f.get(a,b,c,"json")},ajaxSetup:function(a,b){b?b_(a,f.ajaxSettings):(b=a,a=f.ajaxSettings),b_(a,b);return a},ajaxSettings:{url:bV,isLocal:bJ.test(bW[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":bX},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":a.String,"text html":!0,"text json":f.parseJSON,"text xml":f.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:bZ(bT),ajaxTransport:bZ(bU),ajax:function(a,c){function w(a,c,l,m){if(s!==2){s=2,q&&clearTimeout(q),p=b,n=m||"",v.readyState=a>0?4:0;var o,r,u,w=c,x=l?cb(d,v,l):b,y,z;if(a>=200&&a<300||a===304){if(d.ifModified){if(y=v.getResponseHeader("Last-Modified"))f.lastModified[k]=y;if(z=v.getResponseHeader("Etag"))f.etag[k]=z}if(a===304)w="notmodified",o=!0;else try{r=cc(d,x),w="success",o=!0}catch(A){w="parsererror",u=A}}else{u=w;if(!w||a)w="error",a<0&&(a=0)}v.status=a,v.statusText=""+(c||w),o?h.resolveWith(e,[r,w,v]):h.rejectWith(e,[v,w,u]),v.statusCode(j),j=b,t&&g.trigger("ajax"+(o?"Success":"Error"),[v,d,o?r:u]),i.fireWith(e,[v,w]),t&&(g.trigger("ajaxComplete",[v,d]),--f.active||f.event.trigger("ajaxStop"))}}typeof a=="object"&&(c=a,a=b),c=c||{};var d=f.ajaxSetup({},c),e=d.context||d,g=e!==d&&(e.nodeType||e instanceof f)?f(e):f.event,h=f.Deferred(),i=f.Callbacks("once memory"),j=d.statusCode||{},k,l={},m={},n,o,p,q,r,s=0,t,u,v={readyState:0,setRequestHeader:function(a,b){if(!s){var c=a.toLowerCase();a=m[c]=m[c]||a,l[a]=b}return this},getAllResponseHeaders:function(){return s===2?n:null},getResponseHeader:function(a){var c;if(s===2){if(!o){o={};while(c=bH.exec(n))o[c[1].toLowerCase()]=c[2]}c=o[a.toLowerCase()]}return c===b?null:c},overrideMimeType:function(a){s||(d.mimeType=a);return this},abort:function(a){a=a||"abort",p&&p.abort(a),w(0,a);return this}};h.promise(v),v.success=v.done,v.error=v.fail,v.complete=i.add,v.statusCode=function(a){if(a){var b;if(s<2)for(b in a)j[b]=[j[b],a[b]];else b=a[v.status],v.then(b,b)}return this},d.url=((a||d.url)+"").replace(bG,"").replace(bL,bW[1]+"//"),d.dataTypes=f.trim(d.dataType||"*").toLowerCase().split(bP),d.crossDomain==null&&(r=bR.exec(d.url.toLowerCase()),d.crossDomain=!(!r||r[1]==bW[1]&&r[2]==bW[2]&&(r[3]||(r[1]==="http:"?80:443))==(bW[3]||(bW[1]==="http:"?80:443)))),d.data&&d.processData&&typeof d.data!="string"&&(d.data=f.param(d.data,d.traditional)),b$(bT,d,c,v);if(s===2)return!1;t=d.global,d.type=d.type.toUpperCase(),d.hasContent=!bK.test(d.type),t&&f.active++===0&&f.event.trigger("ajaxStart");if(!d.hasContent){d.data&&(d.url+=(bM.test(d.url)?"&":"?")+d.data,delete d.data),k=d.url;if(d.cache===!1){var x=f.now(),y=d.url.replace(bQ,"$1_="+x);d.url=y+(y===d.url?(bM.test(d.url)?"&":"?")+"_="+x:"")}}(d.data&&d.hasContent&&d.contentType!==!1||c.contentType)&&v.setRequestHeader("Content-Type",d.contentType),d.ifModified&&(k=k||d.url,f.lastModified[k]&&v.setRequestHeader("If-Modified-Since",f.lastModified[k]),f.etag[k]&&v.setRequestHeader("If-None-Match",f.etag[k])),v.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+(d.dataTypes[0]!=="*"?", "+bX+"; q=0.01":""):d.accepts["*"]);for(u in d.headers)v.setRequestHeader(u,d.headers[u]);if(d.beforeSend&&(d.beforeSend.call(e,v,d)===!1||s===2)){v.abort();return!1}for(u in{success:1,error:1,complete:1})v[u](d[u]);p=b$(bU,d,c,v);if(!p)w(-1,"No Transport");else{v.readyState=1,t&&g.trigger("ajaxSend",[v,d]),d.async&&d.timeout>0&&(q=setTimeout(function(){v.abort("timeout")},d.timeout));try{s=1,p.send(l,w)}catch(z){if(s<2)w(-1,z);else throw z}}return v},param:function(a,c){var d=[],e=function(a,b){b=f.isFunction(b)?b():b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};c===b&&(c=f.ajaxSettings.traditional);if(f.isArray(a)||a.jquery&&!f.isPlainObject(a))f.each(a,function(){e(this.name,this.value)});else for(var g in a)ca(g,a[g],c,e);return d.join("&").replace(bD,"+")}}),f.extend({active:0,lastModified:{},etag:{}});var cd=f.now(),ce=/(\=)\?(&|$)|\?\?/i;f.ajaxSetup({jsonp:"callback",jsonpCallback:function(){return f.expando+"_"+cd++}}),f.ajaxPrefilter("json jsonp",function(b,c,d){var e=b.contentType==="application/x-www-form-urlencoded"&&typeof b.data=="string";if(b.dataTypes[0]==="jsonp"||b.jsonp!==!1&&(ce.test(b.url)||e&&ce.test(b.data))){var g,h=b.jsonpCallback=f.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,i=a[h],j=b.url,k=b.data,l="$1"+h+"$2";b.jsonp!==!1&&(j=j.replace(ce,l),b.url===j&&(e&&(k=k.replace(ce,l)),b.data===k&&(j+=(/\?/.test(j)?"&":"?")+b.jsonp+"="+h))),b.url=j,b.data=k,a[h]=function(a){g=[a]},d.always(function(){a[h]=i,g&&f.isFunction(i)&&a[h](g[0])}),b.converters["script json"]=function(){g||f.error(h+" was not called");return g[0]},b.dataTypes[0]="json";return"script"}}),f.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(a){f.globalEval(a);return a}}}),f.ajaxPrefilter("script",function(a){a.cache===b&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),f.ajaxTransport("script",function(a){if(a.crossDomain){var d,e=c.head||c.getElementsByTagName("head")[0]||c.documentElement;return{send:function(f,g){d=c.createElement("script"),d.async="async",a.scriptCharset&&(d.charset=a.scriptCharset),d.src=a.url,d.onload=d.onreadystatechange=function(a,c){if(c||!d.readyState||/loaded|complete/.test(d.readyState))d.onload=d.onreadystatechange=null,e&&d.parentNode&&e.removeChild(d),d=b,c||g(200,"success")},e.insertBefore(d,e.firstChild)},abort:function(){d&&d.onload(0,1)}}}});var cf=a.ActiveXObject?function(){for(var a in ch)ch[a](0,1)}:!1,cg=0,ch;f.ajaxSettings.xhr=a.ActiveXObject?function(){return!this.isLocal&&ci()||cj()}:ci,function(a){f.extend(f.support,{ajax:!!a,cors:!!a&&"withCredentials"in a})}(f.ajaxSettings.xhr()),f.support.ajax&&f.ajaxTransport(function(c) +{if(!c.crossDomain||f.support.cors){var d;return{send:function(e,g){var h=c.xhr(),i,j;c.username?h.open(c.type,c.url,c.async,c.username,c.password):h.open(c.type,c.url,c.async);if(c.xhrFields)for(j in c.xhrFields)h[j]=c.xhrFields[j];c.mimeType&&h.overrideMimeType&&h.overrideMimeType(c.mimeType),!c.crossDomain&&!e["X-Requested-With"]&&(e["X-Requested-With"]="XMLHttpRequest");try{for(j in e)h.setRequestHeader(j,e[j])}catch(k){}h.send(c.hasContent&&c.data||null),d=function(a,e){var j,k,l,m,n;try{if(d&&(e||h.readyState===4)){d=b,i&&(h.onreadystatechange=f.noop,cf&&delete ch[i]);if(e)h.readyState!==4&&h.abort();else{j=h.status,l=h.getAllResponseHeaders(),m={},n=h.responseXML,n&&n.documentElement&&(m.xml=n),m.text=h.responseText;try{k=h.statusText}catch(o){k=""}!j&&c.isLocal&&!c.crossDomain?j=m.text?200:404:j===1223&&(j=204)}}}catch(p){e||g(-1,p)}m&&g(j,k,m,l)},!c.async||h.readyState===4?d():(i=++cg,cf&&(ch||(ch={},f(a).unload(cf)),ch[i]=d),h.onreadystatechange=d)},abort:function(){d&&d(0,1)}}}});var ck={},cl,cm,cn=/^(?:toggle|show|hide)$/,co=/^([+\-]=)?([\d+.\-]+)([a-z%]*)$/i,cp,cq=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]],cr;f.fn.extend({show:function(a,b,c){var d,e;if(a||a===0)return this.animate(cu("show",3),a,b,c);for(var g=0,h=this.length;g=i.duration+this.startTime){this.now=this.end,this.pos=this.state=1,this.update(),i.animatedProperties[this.prop]=!0;for(b in i.animatedProperties)i.animatedProperties[b]!==!0&&(g=!1);if(g){i.overflow!=null&&!f.support.shrinkWrapBlocks&&f.each(["","X","Y"],function(a,b){h.style["overflow"+b]=i.overflow[a]}),i.hide&&f(h).hide();if(i.hide||i.show)for(b in i.animatedProperties)f.style(h,b,i.orig[b]),f.removeData(h,"fxshow"+b,!0),f.removeData(h,"toggle"+b,!0);d=i.complete,d&&(i.complete=!1,d.call(h))}return!1}i.duration==Infinity?this.now=e:(c=e-this.startTime,this.state=c/i.duration,this.pos=f.easing[i.animatedProperties[this.prop]](this.state,c,0,1,i.duration),this.now=this.start+(this.end-this.start)*this.pos),this.update();return!0}},f.extend(f.fx,{tick:function(){var a,b=f.timers,c=0;for(;c-1,k={},l={},m,n;j?(l=e.position(),m=l.top,n=l.left):(m=parseFloat(h)||0,n=parseFloat(i)||0),f.isFunction(b)&&(b=b.call(a,c,g)),b.top!=null&&(k.top=b.top-g.top+m),b.left!=null&&(k.left=b.left-g.left+n),"using"in b?b.using.call(a,k):e.css(k)}},f.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),c=this.offset(),d=cx.test(b[0].nodeName)?{top:0,left:0}:b.offset();c.top-=parseFloat(f.css(a,"marginTop"))||0,c.left-=parseFloat(f.css(a,"marginLeft"))||0,d.top+=parseFloat(f.css(b[0],"borderTopWidth"))||0,d.left+=parseFloat(f.css(b[0],"borderLeftWidth"))||0;return{top:c.top-d.top,left:c.left-d.left}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||c.body;while(a&&!cx.test(a.nodeName)&&f.css(a,"position")==="static")a=a.offsetParent;return a})}}),f.each(["Left","Top"],function(a,c){var d="scroll"+c;f.fn[d]=function(c){var e,g;if(c===b){e=this[0];if(!e)return null;g=cy(e);return g?"pageXOffset"in g?g[a?"pageYOffset":"pageXOffset"]:f.support.boxModel&&g.document.documentElement[d]||g.document.body[d]:e[d]}return this.each(function(){g=cy(this),g?g.scrollTo(a?f(g).scrollLeft():c,a?c:f(g).scrollTop()):this[d]=c})}}),f.each(["Height","Width"],function(a,c){var d=c.toLowerCase();f.fn["inner"+c]=function(){var a=this[0];return a?a.style?parseFloat(f.css(a,d,"padding")):this[d]():null},f.fn["outer"+c]=function(a){var b=this[0];return b?b.style?parseFloat(f.css(b,d,a?"margin":"border")):this[d]():null},f.fn[d]=function(a){var e=this[0];if(!e)return a==null?null:this;if(f.isFunction(a))return this.each(function(b){var c=f(this);c[d](a.call(this,b,c[d]()))});if(f.isWindow(e)){var g=e.document.documentElement["client"+c],h=e.document.body;return e.document.compatMode==="CSS1Compat"&&g||h&&h["client"+c]||g}if(e.nodeType===9)return Math.max(e.documentElement["client"+c],e.body["scroll"+c],e.documentElement["scroll"+c],e.body["offset"+c],e.documentElement["offset"+c]);if(a===b){var i=f.css(e,d),j=parseFloat(i);return f.isNumeric(j)?j:i}return this.css(d,typeof a=="string"?a:a+"px")}}),a.jQuery=a.$=f,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return f})})(window); diff --git a/doc/html/json_8h.html b/doc/html/json_8h.html new file mode 100644 index 0000000..615d2b6 --- /dev/null +++ b/doc/html/json_8h.html @@ -0,0 +1,66 @@ + + + + + +json-c: /home/erh/distcheck/json.h File Reference + + + + + + +
+
+
+ + + + + +
+
json-c +  0.16 +
+
+ + + + + + + +
+
+
json.h File Reference
+
+
+ +

A convenience header that may be included instead of other individual ones. +More...

+

Detailed Description

+

A convenience header that may be included instead of other individual ones.

+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__c__version_8h.html b/doc/html/json__c__version_8h.html new file mode 100644 index 0000000..3b049c6 --- /dev/null +++ b/doc/html/json__c__version_8h.html @@ -0,0 +1,199 @@ + + + + + +json-c: json_c_version.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Macros | +Functions
+
+
json_c_version.h File Reference
+
+
+ +

Methods for retrieving the json-c version. +More...

+ + + + + + + + + + + + + + +

+Macros

#define JSON_C_MAJOR_VERSION   0
 
#define JSON_C_MINOR_VERSION   16
 
#define JSON_C_MICRO_VERSION   0
 
#define JSON_C_VERSION_NUM   ((JSON_C_MAJOR_VERSION << 16) | (JSON_C_MINOR_VERSION << 8) | JSON_C_MICRO_VERSION)
 
#define JSON_C_VERSION   "0.16"
 
#define JSON_EXPORT   extern
 
+ + + + + +

+Functions

JSON_EXPORT const char * json_c_version (void)
 
JSON_EXPORT int json_c_version_num (void)
 
+

Detailed Description

+

Methods for retrieving the json-c version.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_C_MAJOR_VERSION   0
+
+ +
+
+ +
+
+ + + + +
#define JSON_C_MICRO_VERSION   0
+
+ +
+
+ +
+
+ + + + +
#define JSON_C_MINOR_VERSION   16
+
+ +
+
+ +
+
+ + + + +
#define JSON_C_VERSION   "0.16"
+
+ +
+
+ +
+
+ + + + +
#define JSON_C_VERSION_NUM   ((JSON_C_MAJOR_VERSION << 16) | (JSON_C_MINOR_VERSION << 8) | JSON_C_MICRO_VERSION)
+
+ +
+
+ +
+
+ + + + +
#define JSON_EXPORT   extern
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_c_version (void )
+
+
See Also
JSON_C_VERSION
+
Returns
the version of the json-c library as a string
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT int json_c_version_num (void )
+
+

The json-c version encoded into an int, with the low order 8 bits being the micro version, the next higher 8 bits being the minor version and the next higher 8 bits being the major version. For example, 7.12.99 would be 0x00070B63.

+
See Also
JSON_C_VERSION_NUM
+
Returns
the version of the json-c library as an int
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__inttypes_8h.html b/doc/html/json__inttypes_8h.html new file mode 100644 index 0000000..5115fa6 --- /dev/null +++ b/doc/html/json__inttypes_8h.html @@ -0,0 +1,111 @@ + + + + + +json-c: json_inttypes.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Macros
+
+
json_inttypes.h File Reference
+
+
+ +

Do not use, json-c internal, may be changed or removed at any time. +More...

+ + + + + + + + +

+Macros

#define PRId64   "I64d"
 
#define SCNd64   "I64d"
 
#define PRIu64   "I64u"
 
+

Detailed Description

+

Do not use, json-c internal, may be changed or removed at any time.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define PRId64   "I64d"
+
+ +
+
+ +
+
+ + + + +
#define PRIu64   "I64u"
+
+ +
+
+ +
+
+ + + + +
#define SCNd64   "I64d"
+
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__object_8h.html b/doc/html/json__object_8h.html new file mode 100644 index 0000000..671cacc --- /dev/null +++ b/doc/html/json__object_8h.html @@ -0,0 +1,2610 @@ + + + + + +json-c: json_object.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Macros | +Typedefs | +Functions | +Variables
+
+
json_object.h File Reference
+
+
+ +

Core json-c API. Start here, or with json_tokener.h. +More...

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Macros

#define JSON_C_CONST_FUNCTION(func)   func
 
#define JSON_OBJECT_DEF_HASH_ENTRIES   16
 
#define JSON_C_TO_STRING_PLAIN   0
 
#define JSON_C_TO_STRING_SPACED   (1 << 0)
 
#define JSON_C_TO_STRING_PRETTY   (1 << 1)
 
#define JSON_C_TO_STRING_PRETTY_TAB   (1 << 3)
 
#define JSON_C_TO_STRING_NOZERO   (1 << 2)
 
#define JSON_C_TO_STRING_NOSLASHESCAPE   (1 << 4)
 
#define JSON_C_OBJECT_ADD_KEY_IS_NEW   (1 << 1)
 
#define JSON_C_OBJECT_ADD_CONSTANT_KEY   (1 << 2)
 
#define JSON_C_OBJECT_KEY_IS_CONSTANT   JSON_C_OBJECT_ADD_CONSTANT_KEY
 
#define JSON_C_OPTION_GLOBAL   (0)
 
#define JSON_C_OPTION_THREAD   (1)
 
#define json_object_object_foreach(obj, key, val)
 
#define json_object_object_foreachC(obj, iter)
 
+ + + +

+Typedefs

typedef int( json_c_shallow_copy_fn )(json_object *src, json_object *parent, const char *key, size_t index, json_object **dst)
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Functions

JSON_EXPORT struct json_object * json_object_get (struct json_object *obj)
 
JSON_EXPORT int json_object_put (struct json_object *obj)
 
JSON_EXPORT int json_object_is_type (const struct json_object *obj, enum json_type type)
 
JSON_EXPORT enum json_type json_object_get_type (const struct json_object *obj)
 
JSON_EXPORT const char * json_object_to_json_string (struct json_object *obj)
 
JSON_EXPORT const char * json_object_to_json_string_ext (struct json_object *obj, int flags)
 
JSON_EXPORT const char * json_object_to_json_string_length (struct json_object *obj, int flags, size_t *length)
 
JSON_EXPORT void * json_object_get_userdata (json_object *jso)
 
JSON_EXPORT void json_object_set_userdata (json_object *jso, void *userdata, json_object_delete_fn *user_delete)
 
JSON_EXPORT void json_object_set_serializer (json_object *jso, json_object_to_json_string_fn *to_string_func, void *userdata, json_object_delete_fn *user_delete)
 
JSON_EXPORT struct json_object * json_object_new_object (void)
 
JSON_EXPORT struct lh_table * json_object_get_object (const struct json_object *obj)
 
JSON_EXPORT int json_object_object_length (const struct json_object *obj)
 
size_t json_c_object_sizeof (void)
 
JSON_EXPORT int json_object_object_add (struct json_object *obj, const char *key, struct json_object *val)
 
JSON_EXPORT int json_object_object_add_ex (struct json_object *obj, const char *const key, struct json_object *const val, const unsigned opts)
 
JSON_EXPORT struct json_object * json_object_object_get (const struct json_object *obj, const char *key)
 
JSON_EXPORT json_bool json_object_object_get_ex (const struct json_object *obj, const char *key, struct json_object **value)
 
JSON_EXPORT void json_object_object_del (struct json_object *obj, const char *key)
 
JSON_EXPORT struct json_object * json_object_new_array (void)
 
JSON_EXPORT struct json_object * json_object_new_array_ext (int initial_size)
 
JSON_EXPORT struct array_list * json_object_get_array (const struct json_object *obj)
 
JSON_EXPORT size_t json_object_array_length (const struct json_object *obj)
 
JSON_EXPORT void json_object_array_sort (struct json_object *jso, int(*sort_fn)(const void *, const void *))
 
JSON_EXPORT struct json_object * json_object_array_bsearch (const struct json_object *key, const struct json_object *jso, int(*sort_fn)(const void *, const void *))
 
JSON_EXPORT int json_object_array_add (struct json_object *obj, struct json_object *val)
 
JSON_EXPORT int json_object_array_put_idx (struct json_object *obj, size_t idx, struct json_object *val)
 
JSON_EXPORT struct json_object * json_object_array_get_idx (const struct json_object *obj, size_t idx)
 
JSON_EXPORT int json_object_array_del_idx (struct json_object *obj, size_t idx, size_t count)
 
JSON_EXPORT int json_object_array_shrink (struct json_object *jso, int empty_slots)
 
JSON_EXPORT struct json_object * json_object_new_boolean (json_bool b)
 
JSON_EXPORT json_bool json_object_get_boolean (const struct json_object *obj)
 
JSON_EXPORT int json_object_set_boolean (struct json_object *obj, json_bool new_value)
 
JSON_EXPORT struct json_object * json_object_new_int (int32_t i)
 
JSON_EXPORT struct json_object * json_object_new_int64 (int64_t i)
 
JSON_EXPORT struct json_object * json_object_new_uint64 (uint64_t i)
 
JSON_EXPORT int32_t json_object_get_int (const struct json_object *obj)
 
JSON_EXPORT int json_object_set_int (struct json_object *obj, int new_value)
 
JSON_EXPORT int json_object_int_inc (struct json_object *obj, int64_t val)
 
JSON_EXPORT int64_t json_object_get_int64 (const struct json_object *obj)
 
JSON_EXPORT uint64_t json_object_get_uint64 (const struct json_object *obj)
 
JSON_EXPORT int json_object_set_int64 (struct json_object *obj, int64_t new_value)
 
JSON_EXPORT int json_object_set_uint64 (struct json_object *obj, uint64_t new_value)
 
JSON_EXPORT struct json_object * json_object_new_double (double d)
 
JSON_EXPORT struct json_object * json_object_new_double_s (double d, const char *ds)
 
JSON_EXPORT int json_c_set_serialization_double_format (const char *double_format, int global_or_thread)
 
JSON_EXPORT int json_object_double_to_json_string (struct json_object *jso, struct printbuf *pb, int level, int flags)
 
JSON_EXPORT double json_object_get_double (const struct json_object *obj)
 
JSON_EXPORT int json_object_set_double (struct json_object *obj, double new_value)
 
JSON_EXPORT struct json_object * json_object_new_string (const char *s)
 
JSON_EXPORT struct json_object * json_object_new_string_len (const char *s, const int len)
 
JSON_EXPORT const char * json_object_get_string (struct json_object *obj)
 
JSON_EXPORT int json_object_get_string_len (const struct json_object *obj)
 
JSON_EXPORT int json_object_set_string (json_object *obj, const char *new_value)
 
JSON_EXPORT int json_object_set_string_len (json_object *obj, const char *new_value, int len)
 
JSON_EXPORT struct json_object * json_object_new_null (void)
 
JSON_EXPORT int json_object_equal (struct json_object *obj1, struct json_object *obj2)
 
JSON_EXPORT int json_object_deep_copy (struct json_object *src, struct json_object **dst, json_c_shallow_copy_fn *shallow_copy)
 
+ + + + + + + +

+Variables

JSON_EXPORT json_object_delete_fn json_object_free_userdata
 
JSON_EXPORT
+json_object_to_json_string_fn 		json_object_userdata_to_json_string
 
JSON_EXPORT json_c_shallow_copy_fn json_c_shallow_copy_default
 
+

Detailed Description

+

Core json-c API. Start here, or with json_tokener.h.

+

Macro Definition Documentation

+ +
+
+ + + + + + + + +
#define JSON_C_CONST_FUNCTION( func)   func
+
+ +
+
+ +
+
+ + + + +
#define JSON_C_OBJECT_ADD_CONSTANT_KEY   (1 << 2)
+
+

A flag for the json_object_object_add_ex function which flags the key as being constant memory. This means that the key will NOT be copied via strdup(), resulting in a potentially huge performance win (malloc, strdup and free are usually performance hogs). It is acceptable to use this flag for keys in non-constant memory blocks if the caller ensure that the memory holding the key lives longer than the corresponding json object. However, this is somewhat dangerous and should only be done if really justified. The general use-case for this flag is cases where the key is given as a real constant value in the function call, e.g. as in json_object_object_add_ex(obj, "ip", json, JSON_C_OBJECT_ADD_CONSTANT_KEY);

+ +
+
+ +
+
+ + + + +
#define JSON_C_OBJECT_ADD_KEY_IS_NEW   (1 << 1)
+
+

A flag for the json_object_object_add_ex function which causes the value to be added without a check if it already exists. Note: it is the responsibility of the caller to ensure that no key is added multiple times. If this is done, results are unpredictable. While this option is somewhat dangerous, it permits potentially large performance savings in code that knows for sure the key values are unique (e.g. because the code adds a well-known set of constant key values).

+ +
+
+ +
+
+ + + + +
#define JSON_C_OBJECT_KEY_IS_CONSTANT   JSON_C_OBJECT_ADD_CONSTANT_KEY
+
+

This flag is an alias to JSON_C_OBJECT_ADD_CONSTANT_KEY. Historically, this flag was used first and the new name JSON_C_OBJECT_ADD_CONSTANT_KEY was introduced for version 0.16.00 in order to have regular naming. Use of this flag is now legacy.

+ +
+
+ +
+
+ + + + +
#define JSON_C_OPTION_GLOBAL   (0)
+
+

Set the global value of an option, which will apply to all current and future threads that have not set a thread-local value.

+
See Also
json_c_set_serialization_double_format
+ +
+
+ +
+
+ + + + +
#define JSON_C_OPTION_THREAD   (1)
+
+

Set a thread-local value of an option, overriding the global value. This will fail if json-c is not compiled with threading enabled, and with the __thread specifier (or equivalent) available.

+
See Also
json_c_set_serialization_double_format
+ +
+
+ +
+
+ + + + +
#define JSON_C_TO_STRING_NOSLASHESCAPE   (1 << 4)
+
+

Don't escape forward slashes.

+ +
+
+ +
+
+ + + + +
#define JSON_C_TO_STRING_NOZERO   (1 << 2)
+
+

A flag to drop trailing zero for float values

+ +
+
+ +
+
+ + + + +
#define JSON_C_TO_STRING_PLAIN   0
+
+

A flag for the json_object_to_json_string_ext() and json_object_to_file_ext() functions which causes the output to have no extra whitespace or formatting applied.

+ +
+
+ +
+
+ + + + +
#define JSON_C_TO_STRING_PRETTY   (1 << 1)
+
+

A flag for the json_object_to_json_string_ext() and json_object_to_file_ext() functions which causes the output to be formatted.

+

See the "Two Space Tab" option at https://jsonformatter.curiousconcept.com/ for an example of the format.

+ +
+
+ +
+
+ + + + +
#define JSON_C_TO_STRING_PRETTY_TAB   (1 << 3)
+
+

A flag for the json_object_to_json_string_ext() and json_object_to_file_ext() functions which causes the output to be formatted.

+

Instead of a "Two Space Tab" this gives a single tab character.

+ +
+
+ +
+
+ + + + +
#define JSON_C_TO_STRING_SPACED   (1 << 0)
+
+

A flag for the json_object_to_json_string_ext() and json_object_to_file_ext() functions which causes the output to have minimal whitespace inserted to make things slightly more readable.

+ +
+
+ +
+
+ + + + +
#define JSON_OBJECT_DEF_HASH_ENTRIES   16
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
#define json_object_object_foreach( obj,
 key,
 val 
)
+
+Value:
char *key = NULL; \
+
struct json_object *val = NULL; \
+
struct lh_entry *entry##key; \
+
struct lh_entry *entry_next##key = NULL; \
+
for (entry##key = lh_table_head(json_object_get_object(obj)); \
+
(entry##key ? (key = (char *)lh_entry_k(entry##key), \
+
val = (struct json_object *)lh_entry_v(entry##key), \
+
entry_next##key = lh_entry_next(entry##key), entry##key) \
+
: 0); \
+
entry##key = entry_next##key)
+

Iterate through all keys and values of an object.

+

Adding keys to the object while iterating is NOT allowed.

+

Deleting an existing key, or replacing an existing key with a new value IS allowed.

+
Parameters
+ + + + +
objthe json_object instance
keythe local name for the char* key variable defined in the body
valthe local name for the json_object* object variable defined in the body
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
#define json_object_object_foreachC( obj,
 iter 
)
+
+Value:
for (iter.entry = lh_table_head(json_object_get_object(obj)); \
+
(iter.entry ? (iter.key = (char *)lh_entry_k(iter.entry), \
+
iter.val = (struct json_object *)lh_entry_v(iter.entry), iter.entry) \
+
: 0); \
+
iter.entry = lh_entry_next(iter.entry))
+

Iterate through all keys and values of an object (ANSI C Safe)

+
Parameters
+ + + +
objthe json_object instance
iterthe object iterator, use type json_object_iter
+
+
+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef int( json_c_shallow_copy_fn)(json_object *src, json_object *parent, const char *key, size_t index, json_object **dst)
+
+

Perform a shallow copy of src into *dst as part of an overall json_object_deep_copy().

+

If src is part of a containing object or array, parent will be non-NULL, and key or index will be provided. When shallow_copy is called *dst will be NULL, and must be non-NULL when it returns. src will never be NULL.

+

If shallow_copy sets the serializer on an object, return 2 to indicate to json_object_deep_copy that it should not attempt to use the standard userdata copy function.

+
Returns
On success 1 or 2, -1 on errors
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + +
size_t json_c_object_sizeof (void )
+
+

Get the sizeof (struct json_object).

+
Returns
a size_t with the sizeof (struct json_object)
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_c_set_serialization_double_format (const char * double_format,
int global_or_thread 
)
+
+

Set a global or thread-local json-c option, depending on whether JSON_C_OPTION_GLOBAL or JSON_C_OPTION_THREAD is passed. Thread-local options default to undefined, and inherit from the global value, even if the global value is changed after the thread is created. Attempting to set thread-local options when threading is not compiled in will result in an error. Be sure to check the return value.

+

double_format is a "%g" printf format, such as "%.20g"

+
Returns
-1 on errors, 0 on success.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_array_add (struct json_object * obj,
struct json_object * val 
)
+
+

Add an element to the end of a json_object of type json_type_array

+

The reference count will not be incremented. This is to make adding fields to objects in code more compact. If you want to retain a reference to an added object you must wrap the passed object with json_object_get

+
Parameters
+ + + +
objthe json_object instance
valthe json_object to be added
+
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_object_array_bsearch (const struct json_object * key,
const struct json_object * jso,
int(*)(const void *, const void *) sort_fn 
)
+ 		+read
+
+

Binary search a sorted array for a specified key object.

+

It depends on your compare function what's sufficient as a key. Usually you create some dummy object with the parameter compared in it, to identify the right item you're actually looking for.

+
See Also
json_object_array_sort() for hints on the compare function.
+
Parameters
+ + + + +
keya dummy json_object with the right key
jsothe array object we're searching
sort_fnthe sort/compare function
+
+
+
Returns
the wanted json_object instance
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_array_del_idx (struct json_object * obj,
size_t idx,
size_t count 
)
+
+

Delete an elements from a specified index in an array (a json_object of type json_type_array)

+

The reference count will be decremented for each of the deleted objects. If there are no more owners of an element that is being deleted, then the value is freed. Otherwise, the reference to the value will remain in memory.

+
Parameters
+ + + + +
objthe json_object instance
idxthe index to start deleting elements at
countthe number of elements to delete
+
+
+
Returns
0 if the elements were successfully deleted
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_object_array_get_idx (const struct json_object * obj,
size_t idx 
)
+ 		+read
+
+

Get the element at specified index of array obj (which must be a json_object of type json_type_array)

+

No reference counts will be changed, and ownership of the returned object remains with obj. See json_object_object_get() for additional implications of this behavior.

+

Calling this with anything other than a json_type_array will trigger an assert.

+
Parameters
+ + + +
objthe json_object instance
idxthe index to get the element at
+
+
+
Returns
the json_object at the specified index (or NULL)
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT size_t json_object_array_length (const struct json_object * obj)
+
+

Get the length of a json_object of type json_type_array

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
an int
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_array_put_idx (struct json_object * obj,
size_t idx,
struct json_object * val 
)
+
+

Insert or replace an element at a specified index in an array (a json_object of type json_type_array)

+

The reference count will not be incremented. This is to make adding fields to objects in code more compact. If you want to retain a reference to an added object you must wrap the passed object with json_object_get

+

The reference count of a replaced object will be decremented.

+

The array size will be automatically be expanded to the size of the index if the index is larger than the current size.

+
Parameters
+ + + + +
objthe json_object instance
idxthe index to insert the element at
valthe json_object to be added
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_array_shrink (struct json_object * jso,
int empty_slots 
)
+
+

Shrink the internal memory allocation of the array to just enough to fit the number of elements in it, plus empty_slots.

+
Parameters
+ + + +
jsothe json_object instance, must be json_type_array
empty_slotsthe number of empty slots to leave allocated
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT void json_object_array_sort (struct json_object * jso,
int(*)(const void *, const void *) sort_fn 
)
+
+

Sorts the elements of jso of type json_type_array

+

Pointers to the json_object pointers will be passed as the two arguments to sort_fn

+
Parameters
+ + + +
jsothe json_object instance
sort_fna sorting function
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_deep_copy (struct json_object * src,
struct json_object ** dst,
json_c_shallow_copy_fn * shallow_copy 
)
+
+

Copy the contents of the JSON object. The destination object must be initialized to NULL, to make sure this function won't overwrite an existing JSON object.

+

This does roughly the same thing as json_tokener_parse(json_object_get_string(src)).

+
Parameters
+ + + + +
srcsource JSON object whose contents will be copied
dstpointer to the destination object where the contents of src; make sure this pointer is initialized to NULL
shallow_copyan optional function to copy individual objects, needed when custom serializers are in use. See also json_object set_serializer.
+
+
+
Returns
0 if the copy went well, -1 if an error occurred during copy or if the destination pointer is non-NULL
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_double_to_json_string (struct json_object * jso,
struct printbuf * pb,
int level,
int flags 
)
+
+

Serialize a json_object of type json_type_double to a string.

+

This function isn't meant to be called directly. Instead, you can set a custom format string for the serialization of this double using the following call (where "%.17g" actually is the default):

+
jso = json_object_new_double(d);
+
json_object_set_serializer(jso, json_object_double_to_json_string,
+
"%.17g", NULL);
+
See Also
printf(3) man page for format strings
+
Parameters
+ + + + + +
jsoThe json_type_double object that is serialized.
pbThe destination buffer.
levelIgnored.
flagsIgnored.
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_equal (struct json_object * obj1,
struct json_object * obj2 
)
+
+

Check if two json_object's are equal

+

If the passed objects are equal 1 will be returned. Equality is defined as follows:

+
    +
  • json_objects of different types are never equal
    • +
  • json_objects of the same primitive type are equal if the c-representation of their value is equal
    • +
  • json-arrays are considered equal if all values at the same indices are equal (same order)
    • +
  • Complex json_objects are considered equal if all contained objects referenced by their key are equal, regardless their order.
    • +
+
Parameters
+ + + +
obj1the first json_object instance
obj2the second json_object instance
+
+
+
Returns
whether both objects are equal or not
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_get (struct json_object * obj)
+ 		+read
+
+

Increment the reference count of json_object, thereby taking ownership of it.

+

Cases where you might need to increase the refcount include:

+ +
Parameters
+ + +
objthe json_object instance
+
+
+
See Also
json_object_put()
+
+json_object_object_get()
+
+json_object_array_get_idx()
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct array_list* json_object_get_array (const struct json_object * obj)
+ 		+read
+
+

Get the arraylist of a json_object of type json_type_array

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
an arraylist
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT json_bool json_object_get_boolean (const struct json_object * obj)
+
+

Get the json_bool value of a json_object

+

The type is coerced to a json_bool if the passed object is not a json_bool. integer and double objects will return 0 if there value is zero or 1 otherwise. If the passed object is a string it will return 1 if it has a non zero length. If any other object type is passed 0 will be returned, even non-empty json_type_array and json_type_object objects.

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
a json_bool
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT double json_object_get_double (const struct json_object * obj)
+
+

Get the double floating point value of a json_object

+

The type is coerced to a double if the passed object is not a double. integer objects will return their double conversion. Strings will be parsed as a double. If no conversion exists then 0.0 is returned and errno is set to EINVAL. null is equivalent to 0 (no error values set)

+

If the value is too big to fit in a double, then the value is set to the closest infinity with errno set to ERANGE. If strings cannot be converted to their double value, then EINVAL is set & NaN is returned.

+

Arrays of length 0 are interpreted as 0 (with no error flags set). Arrays of length 1 are effectively cast to the equivalent object and converted using the above rules. All other arrays set the error to EINVAL & return NaN.

+

NOTE: Set errno to 0 directly before a call to this function to determine whether or not conversion was successful (it does not clear the value for you).

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
a double floating point number
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT int32_t json_object_get_int (const struct json_object * obj)
+
+

Get the int value of a json_object

+

The type is coerced to a int if the passed object is not a int. double objects will return their integer conversion. Strings will be parsed as an integer. If no conversion exists then 0 is returned and errno is set to EINVAL. null is equivalent to 0 (no error values set)

+

Note that integers are stored internally as 64-bit values. If the value of too big or too small to fit into 32-bit, INT32_MAX or INT32_MIN are returned, respectively.

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
an int
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT int64_t json_object_get_int64 (const struct json_object * obj)
+
+

Get the int value of a json_object

+

The type is coerced to a int64 if the passed object is not a int64. double objects will return their int64 conversion. Strings will be parsed as an int64. If no conversion exists then 0 is returned.

+

NOTE: Set errno to 0 directly before a call to this function to determine whether or not conversion was successful (it does not clear the value for you).

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
an int64
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct lh_table* json_object_get_object (const struct json_object * obj)
+ 		+read
+
+

Get the hashtable of a json_object of type json_type_object

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
a linkhash
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_object_get_string (struct json_object * obj)
+
+

Get the string value of a json_object

+

If the passed object is of type json_type_null (i.e. obj == NULL), NULL is returned.

+

If the passed object of type json_type_string, the string contents are returned.

+

Otherwise the JSON representation of the object is returned.

+

The returned string memory is managed by the json_object and will be freed when the reference count of the json_object drops to zero.

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
a string or NULL
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT int json_object_get_string_len (const struct json_object * obj)
+
+

Get the string length of a json_object

+

If the passed object is not of type json_type_string then zero will be returned.

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
int
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT enum json_type json_object_get_type (const struct json_object * obj)
+
+

Get the type of the json_object. See also json_type_to_name() to turn this into a string suitable, for instance, for logging.

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
type being one of: json_type_null (i.e. obj == NULL), json_type_boolean, json_type_double, json_type_int, json_type_object, json_type_array, json_type_string
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT uint64_t json_object_get_uint64 (const struct json_object * obj)
+
+

Get the uint value of a json_object

+

The type is coerced to a uint64 if the passed object is not a uint64. double objects will return their uint64 conversion. Strings will be parsed as an uint64. If no conversion exists then 0 is returned.

+

NOTE: Set errno to 0 directly before a call to this function to determine whether or not conversion was successful (it does not clear the value for you).

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
an uint64
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT void* json_object_get_userdata (json_object * jso)
+
+

Returns the userdata set by json_object_set_userdata() or json_object_set_serializer()

+
Parameters
+ + +
jsothe object to return the userdata for
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_int_inc (struct json_object * obj,
int64_t val 
)
+
+

Increment a json_type_int object by the given amount, which may be negative.

+

If the type of obj is not json_type_int then 0 is returned with no further action taken. If the addition would result in a overflow, the object value is set to INT64_MAX. If the addition would result in a underflow, the object value is set to INT64_MIN. Neither overflow nor underflow affect the return value.

+
Parameters
+ + + +
objthe json_object instance
valthe value to add
+
+
+
Returns
1 if the increment succeeded, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_is_type (const struct json_object * obj,
enum json_type type 
)
+
+

Check if the json_object is of a given type

+
Parameters
+ + + +
objthe json_object instance
typeone of: json_type_null (i.e. obj == NULL), json_type_boolean, json_type_double, json_type_int, json_type_object, json_type_array, json_type_string
+
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_array (void )
+ 		+read
+
+

Create a new empty json_object of type json_type_array with 32 slots allocated. If you know the array size you'll need ahead of time, use json_object_new_array_ext() instead.

+
See Also
json_object_new_array_ext()
+
+json_object_array_shrink()
+
Returns
a json_object of type json_type_array
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_array_ext (int initial_size)
+ 		+read
+
+

Create a new empty json_object of type json_type_array with the desired number of slots allocated.

+
See Also
json_object_array_shrink()
+
Parameters
+ + +
initial_sizethe number of slots to allocate
+
+
+
Returns
a json_object of type json_type_array
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_boolean (json_bool b)
+ 		+read
+
+

Create a new empty json_object of type json_type_boolean

+
Parameters
+ + +
ba json_bool 1 or 0
+
+
+
Returns
a json_object of type json_type_boolean
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_double (double d)
+ 		+read
+
+

Create a new empty json_object of type json_type_double

+
See Also
json_object_double_to_json_string() for how to set a custom format string.
+
Parameters
+ + +
dthe double
+
+
+
Returns
a json_object of type json_type_double
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_double_s (double d,
const char * ds 
)
+ 		+read
+
+

Create a new json_object of type json_type_double, using the exact serialized representation of the value.

+

This allows for numbers that would otherwise get displayed inefficiently (e.g. 12.3 => "12.300000000000001") to be serialized with the more convenient form.

+

Notes:

+

This is used by json_tokener_parse_ex() to allow for an exact re-serialization of a parsed object.

+

The userdata field is used to store the string representation, so it can't be used for other data if this function is used.

+

A roughly equivalent sequence of calls, with the difference being that the serialization function won't be reset by json_object_set_double(), is:

+
jso = json_object_new_double(d);
+
json_object_set_serializer(jso, json_object_userdata_to_json_string,
+
strdup(ds), json_object_free_userdata);
+
Parameters
+ + + +
dthe numeric value of the double.
dsthe string representation of the double. This will be copied.
+
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_int (int32_t i)
+ 		+read
+
+

Create a new empty json_object of type json_type_int Note that values are stored as 64-bit values internally. To ensure the full range is maintained, use json_object_new_int64 instead.

+
Parameters
+ + +
ithe integer
+
+
+
Returns
a json_object of type json_type_int
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_int64 (int64_t i)
+ 		+read
+
+

Create a new empty json_object of type json_type_int

+
Parameters
+ + +
ithe integer
+
+
+
Returns
a json_object of type json_type_int
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_null (void )
+ 		+read
+
+

This method exists only to provide a complementary function along the lines of the other json_object_new_* functions. It always returns NULL, and it is entirely acceptable to simply use NULL directly.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_object (void )
+ 		+read
+
+

Create a new empty object with a reference count of 1. The caller of this object initially has sole ownership. Remember, when using json_object_object_add or json_object_array_put_idx, ownership will transfer to the object/array. Call json_object_get if you want to maintain shared ownership or also add this object as a child of multiple objects or arrays. Any ownerships you acquired but did not transfer must be released through json_object_put.

+
Returns
a json_object of type json_type_object
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_string (const char * s)
+ 		+read
+
+

Create a new empty json_object of type json_type_string

+

A copy of the string is made and the memory is managed by the json_object

+
Parameters
+ + +
sthe string
+
+
+
Returns
a json_object of type json_type_string
+
See Also
json_object_new_string_len()
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_string_len (const char * s,
const int len 
)
+ 		+read
+
+

Create a new empty json_object of type json_type_string and allocate len characters for the new string.

+

A copy of the string is made and the memory is managed by the json_object

+
Parameters
+ + + +
sthe string
lenmax length of the new string
+
+
+
Returns
a json_object of type json_type_string
+
See Also
json_object_new_string()
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_new_uint64 (uint64_t i)
+ 		+read
+
+

Create a new empty json_object of type json_type_uint

+
Parameters
+ + +
ithe integer
+
+
+
Returns
a json_object of type json_type_uint
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_object_add (struct json_object * obj,
const char * key,
struct json_object * val 
)
+
+

Add an object field to a json_object of type json_type_object

+

The reference count of val will not be incremented, in effect transferring ownership that object to obj, and thus val will be freed when obj is. (i.e. through json_object_put(obj))

+

If you want to retain a reference to the added object, independent of the lifetime of obj, you must increment the refcount with json_object_get(val) (and later release it with json_object_put()).

+

Since ownership transfers to obj, you must make sure that you do in fact have ownership over val. For instance, json_object_new_object() will give you ownership until you transfer it, whereas json_object_object_get() does not.

+

Any previous object stored under key in obj will have its refcount decremented, and be freed normally if that drops to zero.

+
Parameters
+ + + + +
objthe json_object instance
keythe object field name (a private copy will be duplicated)
vala json_object or NULL member to associate with the given field
+
+
+
Returns
On success, 0 is returned. On error, a negative value is returned.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_object_add_ex (struct json_object * obj,
const char *const key,
struct json_object *const val,
const unsigned opts 
)
+
+

Add an object field to a json_object of type json_type_object

+

The semantics are identical to json_object_object_add, except that an additional flag fields gives you more control over some detail aspects of processing. See the description of JSON_C_OBJECT_ADD_* flags for more details.

+
Parameters
+ + + + + +
objthe json_object instance
keythe object field name (a private copy will be duplicated)
vala json_object or NULL member to associate with the given field
optsprocess-modifying options. To specify multiple options, use (OPT1|OPT2)
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT void json_object_object_del (struct json_object * obj,
const char * key 
)
+
+

Delete the given json_object field

+

The reference count will be decremented for the deleted object. If there are no more owners of the value represented by this key, then the value is freed. Otherwise, the reference to the value will remain in memory.

+
Parameters
+ + + +
objthe json_object instance
keythe object field name
+
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_object_object_get (const struct json_object * obj,
const char * key 
)
+ 		+read
+
+

Get the json_object associate with a given object field. Deprecated/discouraged: used json_object_object_get_ex instead.

+

This returns NULL if the field is found but its value is null, or if the field is not found, or if obj is not a json_type_object. If you need to distinguish between these cases, use json_object_object_get_ex().

+

No reference counts will be changed. There is no need to manually adjust reference counts through the json_object_put/json_object_get methods unless you need to have the child (value) reference maintain a different lifetime than the owning parent (obj). Ownership of the returned value is retained by obj (do not do json_object_put unless you have done a json_object_get). If you delete the value from obj (json_object_object_del) and wish to access the returned reference afterwards, make sure you have first gotten shared ownership through json_object_get (& don't forget to do a json_object_put or transfer ownership to prevent a memory leak).

+
Parameters
+ + + +
objthe json_object instance
keythe object field name
+
+
+
Returns
the json_object associated with the given field name
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT json_bool json_object_object_get_ex (const struct json_object * obj,
const char * key,
struct json_object ** value 
)
+
+

Get the json_object associated with a given object field.

+

This returns true if the key is found, false in all other cases (including if obj isn't a json_type_object).

+

No reference counts will be changed. There is no need to manually adjust reference counts through the json_object_put/json_object_get methods unless you need to have the child (value) reference maintain a different lifetime than the owning parent (obj). Ownership of value is retained by obj.

+
Parameters
+ + + + +
objthe json_object instance
keythe object field name
valuea pointer where to store a reference to the json_object associated with the given field name.
+
+
+

It is safe to pass a NULL value.

+
Returns
whether or not the key exists
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT int json_object_object_length (const struct json_object * obj)
+
+

Get the size of an object in terms of the number of fields it has.

+
Parameters
+ + +
objthe json_object whose length to return
+
+
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT int json_object_put (struct json_object * obj)
+
+

Decrement the reference count of json_object and free if it reaches zero.

+

You must have ownership of obj prior to doing this or you will cause an imbalance in the reference count, leading to a classic use-after-free bug. In particular, you normally do not need to call json_object_put() on the json_object returned by json_object_object_get() or json_object_array_get_idx().

+

Just like after calling free() on a block of memory, you must not use obj after calling json_object_put() on it or any object that it is a member of (unless you know you've called json_object_get(obj) to explicitly increment the refcount).

+

NULL may be passed, which which case this is a no-op.

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
1 if the object was freed.
+
See Also
json_object_get()
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_boolean (struct json_object * obj,
json_bool new_value 
)
+
+

Set the json_bool value of a json_object

+

The type of obj is checked to be a json_type_boolean and 0 is returned if it is not without any further actions. If type of obj is json_type_boolean the object value is changed to new_value

+
Parameters
+ + + +
objthe json_object instance
new_valuethe value to be set
+
+
+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_double (struct json_object * obj,
double new_value 
)
+
+

Set the double value of a json_object

+

The type of obj is checked to be a json_type_double and 0 is returned if it is not without any further actions. If type of obj is json_type_double the object value is changed to new_value

+

If the object was created with json_object_new_double_s(), the serialization function is reset to the default and the cached serialized value is cleared.

+
Parameters
+ + + +
objthe json_object instance
new_valuethe value to be set
+
+
+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_int (struct json_object * obj,
int new_value 
)
+
+

Set the int value of a json_object

+

The type of obj is checked to be a json_type_int and 0 is returned if it is not without any further actions. If type of obj is json_type_int the object value is changed to new_value

+
Parameters
+ + + +
objthe json_object instance
new_valuethe value to be set
+
+
+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_int64 (struct json_object * obj,
int64_t new_value 
)
+
+

Set the int64_t value of a json_object

+

The type of obj is checked to be a json_type_int and 0 is returned if it is not without any further actions. If type of obj is json_type_int the object value is changed to new_value

+
Parameters
+ + + +
objthe json_object instance
new_valuethe value to be set
+
+
+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT void json_object_set_serializer (json_object * jso,
json_object_to_json_string_fn * to_string_func,
void * userdata,
json_object_delete_fn * user_delete 
)
+
+

Set a custom serialization function to be used when this particular object is converted to a string by json_object_to_json_string.

+

If custom userdata is already set on this object, any existing user_delete function is called before the new one is set.

+

If to_string_func is NULL the default behaviour is reset (but the userdata and user_delete fields are still set).

+

The userdata parameter is optional and may be passed as NULL. It can be used to provide additional data for to_string_func to use. This parameter may be NULL even if user_delete is non-NULL.

+

The user_delete parameter is optional and may be passed as NULL, even if the userdata parameter is non-NULL. It will be called just before the json_object is deleted, after it's reference count goes to zero (see json_object_put()). If this is not provided, it is up to the caller to free the userdata at an appropriate time. (i.e. after the json_object is deleted)

+

Note that the userdata is the same as set by json_object_set_userdata(), so care must be taken not to overwrite the value when both a custom serializer and json_object_set_userdata() are used.

+
Parameters
+ + + + + +
jsothe object to customize
to_string_functhe custom serialization function
userdataan optional opaque cookie
user_deletean optional function from freeing userdata
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_string (json_object * obj,
const char * new_value 
)
+
+

Set the string value of a json_object with zero terminated strings equivalent to json_object_set_string_len (obj, new_value, strlen(new_value))

+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_string_len (json_object * obj,
const char * new_value,
int len 
)
+
+

Set the string value of a json_object str

+

The type of obj is checked to be a json_type_string and 0 is returned if it is not without any further actions. If type of obj is json_type_string the object value is changed to new_value

+
Parameters
+ + + + +
objthe json_object instance
new_valuethe value to be set; Since string length is given in len this need not be zero terminated
lenthe length of new_value
+
+
+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_set_uint64 (struct json_object * obj,
uint64_t new_value 
)
+
+

Set the uint64_t value of a json_object

+

The type of obj is checked to be a json_type_uint and 0 is returned if it is not without any further actions. If type of obj is json_type_uint the object value is changed to new_value

+
Parameters
+ + + +
objthe json_object instance
new_valuethe value to be set
+
+
+
Returns
1 if value is set correctly, 0 otherwise
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT void json_object_set_userdata (json_object * jso,
void * userdata,
json_object_delete_fn * user_delete 
)
+
+

Set an opaque userdata value for an object

+

The userdata can be retrieved using json_object_get_userdata().

+

If custom userdata is already set on this object, any existing user_delete function is called before the new one is set.

+

The user_delete parameter is optional and may be passed as NULL, even if the userdata parameter is non-NULL. It will be called just before the json_object is deleted, after it's reference count goes to zero (see json_object_put()). If this is not provided, it is up to the caller to free the userdata at an appropriate time. (i.e. after the json_object is deleted)

+

Note: Objects created by parsing strings may have custom serializers set which expect the userdata to contain specific data (due to use of json_object_new_double_s()). In this case, json_object_set_serialiser() with NULL as to_string_func should be used instead to set the userdata and reset the serializer to its default value.

+
Parameters
+ + + + +
jsothe object to set the userdata for
userdataan optional opaque cookie
user_deletean optional function from freeing userdata
+
+
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_object_to_json_string (struct json_object * obj)
+
+

Stringify object to json format. Equivalent to json_object_to_json_string_ext(obj, JSON_C_TO_STRING_SPACED) The pointer you get is an internal of your json object. You don't have to free it, later use of json_object_put() should be sufficient. If you can not ensure there's no concurrent access to *obj use strdup().

+
Parameters
+ + +
objthe json_object instance
+
+
+
Returns
a string in JSON format
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT const char* json_object_to_json_string_ext (struct json_object * obj,
int flags 
)
+
+

Stringify object to json format

+
See Also
json_object_to_json_string() for details on how to free string.
+
Parameters
+ + + +
objthe json_object instance
flagsformatting options, see JSON_C_TO_STRING_PRETTY and other constants
+
+
+
Returns
a string in JSON format
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT const char* json_object_to_json_string_length (struct json_object * obj,
int flags,
size_t * length 
)
+
+

Stringify object to json format

+
See Also
json_object_to_json_string() for details on how to free string.
+
Parameters
+ + + + +
objthe json_object instance
flagsformatting options, see JSON_C_TO_STRING_PRETTY and other constants
lengtha pointer where, if not NULL, the length (without null) is stored
+
+
+
Returns
a string in JSON format and the length if not NULL
+ +
+
+

Variable Documentation

+ +
+
+ + + + +
JSON_EXPORT json_c_shallow_copy_fn json_c_shallow_copy_default
+
+

The default shallow copy implementation for use with json_object_deep_copy(). This simply calls the appropriate json_object_new_<type>() function and copies over the serializer function (_to_json_string internal field of the json_object structure) but not any _userdata or _user_delete values.

+

If you're writing a custom shallow_copy function, perhaps because you're using your own custom serializer, you can call this first to create the new object before customizing it with json_object_set_serializer().

+
Returns
1 on success, -1 on errors, but never 2.
+ +
+
+ +
+
+ + + + +
JSON_EXPORT json_object_delete_fn json_object_free_userdata
+
+

Simply call free on the userdata pointer. Can be used with json_object_set_serializer().

+
Parameters
+ + + +
jsounused
userdatathe pointer that is passed to free().
+
+
+ +
+
+ +
+
+ + + + +
JSON_EXPORT json_object_to_json_string_fn json_object_userdata_to_json_string
+
+

Copy the jso->_userdata string over to pb as-is. Can be used with json_object_set_serializer().

+
Parameters
+ + + + + +
jsoThe object whose _userdata is used.
pbThe destination buffer.
levelIgnored.
flagsIgnored.
+
+
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__object__iterator_8h.html b/doc/html/json__object__iterator_8h.html new file mode 100644 index 0000000..54fefdd --- /dev/null +++ b/doc/html/json__object__iterator_8h.html @@ -0,0 +1,334 @@ + + + + + +json-c: json_object_iterator.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Structures | +Functions
+
+
json_object_iterator.h File Reference
+
+
+ +

An API for iterating over json_type_object objects, styled to be familiar to C++ programmers. Unlike json_object_object_foreach() and json_object_object_foreachC(), this avoids the need to expose json-c internals like lh_entry. +More...

+ + + + +

+Data Structures

struct  json_object_iterator
 
+ + + + + + + + + + + + + + + +

+Functions

JSON_EXPORT struct
+json_object_iterator 		json_object_iter_init_default (void)
 
JSON_EXPORT struct
+json_object_iterator 		json_object_iter_begin (struct json_object *obj)
 
JSON_EXPORT struct
+json_object_iterator 		json_object_iter_end (const struct json_object *obj)
 
JSON_EXPORT void json_object_iter_next (struct json_object_iterator *iter)
 
JSON_EXPORT const char * json_object_iter_peek_name (const struct json_object_iterator *iter)
 
JSON_EXPORT struct json_object * json_object_iter_peek_value (const struct json_object_iterator *iter)
 
JSON_EXPORT json_bool json_object_iter_equal (const struct json_object_iterator *iter1, const struct json_object_iterator *iter2)
 
+

Detailed Description

+

An API for iterating over json_type_object objects, styled to be familiar to C++ programmers. Unlike json_object_object_foreach() and json_object_object_foreachC(), this avoids the need to expose json-c internals like lh_entry.

+

Copyright (c) 2009-2012 Hewlett-Packard Development Company, L.P.

+

This library is free software; you can redistribute it and/or modify it under the terms of the MIT license. See COPYING for details.

+

API attributes:
+

+
    +
  • Thread-safe: NO
    +
    • +
  • Reentrant: NO
    • +
+

Function Documentation

+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object_iterator json_object_iter_begin (struct json_object * obj)
+ 		+read
+
+

Retrieves an iterator to the first pair of the JSON Object.

+
Warning
Any modification of the underlying pair invalidates all iterators to that pair.
+
Parameters
+ + +
objJSON Object instance (MUST be of type json_object)
+
+
+
Returns
json_object_iterator If the JSON Object has at least one pair, on return, the iterator refers to the first pair. If the JSON Object doesn't have any pairs, the returned iterator is equivalent to the "end" iterator for the same JSON Object instance.
+
struct json_object_iterator it;
+
struct json_object_iterator itEnd;
+
struct json_object* obj;
+
+
obj = json_tokener_parse("{'first':'george', 'age':100}");
+
it = json_object_iter_begin(obj);
+
itEnd = json_object_iter_end(obj);
+
+
while (!json_object_iter_equal(&it, &itEnd)) {
+
printf("%s\n",
+
json_object_iter_peek_name(&it));
+
json_object_iter_next(&it);
+
}
+
+
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object_iterator json_object_iter_end (const struct json_object * obj)
+ 		+read
+
+

Retrieves the iterator that represents the position beyond the last pair of the given JSON Object instance.

+
Warning
Do NOT write code that assumes that the "end" iterator value is NULL, even if it is so in a particular instance of the implementation.
+
Note
The reason we do not (and MUST NOT) provide "json_object_iter_is_end(json_object_iterator* iter)" type of API is because it would limit the underlying representation of name/value containment (or force us to add additional, otherwise unnecessary, fields to the iterator structure). The "end" iterator and the equality test method, on the other hand, permit us to cleanly abstract pretty much any reasonable underlying representation without burdening the iterator structure with unnecessary data.
+
+For performance reasons, memorize the "end" iterator prior to any loop.
+
Parameters
+ + +
objJSON Object instance (MUST be of type json_object)
+
+
+
Returns
json_object_iterator On return, the iterator refers to the "end" of the Object instance's pairs (i.e., NOT the last pair, but "beyond the last + pair" value)
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT json_bool json_object_iter_equal (const struct json_object_iterator * iter1,
const struct json_object_iterator * iter2 
)
+
+

Tests two iterators for equality. Typically used to test for end of iteration by comparing an iterator to the corresponding "end" iterator (that was derived from the same JSON Object instance).

+
Note
The reason we do not (and MUST NOT) provide "json_object_iter_is_end(json_object_iterator* iter)" type of API is because it would limit the underlying representation of name/value containment (or force us to add additional, otherwise unnecessary, fields to the iterator structure). The equality test method, on the other hand, permits us to cleanly abstract pretty much any reasonable underlying representation.
+
Parameters
+ + + +
iter1Pointer to first valid, non-NULL iterator
iter2POinter to second valid, non-NULL iterator
+
+
+
Warning
if a NULL iterator pointer or an uninitialized or invalid iterator, or iterators derived from different JSON Object instances are passed, bad things will happen!
+
Returns
json_bool non-zero if iterators are equal (i.e., both reference the same name/value pair or are both at "end"); zero if they are not equal.
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object_iterator json_object_iter_init_default (void )
+ 		+read
+
+

Initializes an iterator structure to a "default" value that is convenient for initializing an iterator variable to a default state (e.g., initialization list in a class' constructor).

+
struct json_object_iterator iter = json_object_iter_init_default();
+
MyClass() : iter_(json_object_iter_init_default())
+
Note
The initialized value doesn't reference any specific pair, is considered an invalid iterator, and MUST NOT be passed to any json-c API that expects a valid iterator.
+
+User and internal code MUST NOT make any assumptions about and dependencies on the value of the "default" iterator value.
+
Returns
json_object_iterator
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT void json_object_iter_next (struct json_object_iterator * iter)
+
+

Returns an iterator to the next pair, if any

+
Warning
Any modification of the underlying pair invalidates all iterators to that pair.
+
Parameters
+ + +
iter[IN/OUT] Pointer to iterator that references a name/value pair; MUST be a valid, non-end iterator. WARNING: bad things will happen if invalid or "end" iterator is passed. Upon return will contain the reference to the next pair if there is one; if there are no more pairs, will contain the "end" iterator value, which may be compared against the return value of json_object_iter_end() for the same JSON Object instance.
+
+
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_object_iter_peek_name (const struct json_object_iterator * iter)
+
+

Returns a const pointer to the name of the pair referenced by the given iterator.

+
Parameters
+ + +
iterpointer to iterator that references a name/value pair; MUST be a valid, non-end iterator.
+
+
+
Warning
bad things will happen if an invalid or "end" iterator is passed.
+
Returns
const char* Pointer to the name of the referenced name/value pair. The name memory belongs to the name/value pair, will be freed when the pair is deleted or modified, and MUST NOT be modified or freed by the user.
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_iter_peek_value (const struct json_object_iterator * iter)
+ 		+read
+
+

Returns a pointer to the json-c instance representing the value of the referenced name/value pair, without altering the instance's reference count.

+
Parameters
+ + +
iterpointer to iterator that references a name/value pair; MUST be a valid, non-end iterator.
+
+
+
Warning
bad things will happen if invalid or "end" iterator is passed.
+
Returns
struct json_object* Pointer to the json-c value instance of the referenced name/value pair; the value's reference count is not changed by this function: if you plan to hold on to this json-c node, take a look at json_object_get() and json_object_put(). IMPORTANT: json-c API represents the JSON Null value as a NULL json_object instance pointer.
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__pointer_8h.html b/doc/html/json__pointer_8h.html new file mode 100644 index 0000000..d293bab --- /dev/null +++ b/doc/html/json__pointer_8h.html @@ -0,0 +1,268 @@ + + + + + +json-c: json_pointer.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Functions
+
+
json_pointer.h File Reference
+
+
+ +

JSON Pointer (RFC 6901) implementation for retrieving objects from a json-c object tree. +More...

+ + + + + + + + + + +

+Functions

JSON_EXPORT int json_pointer_get (struct json_object *obj, const char *path, struct json_object **res)
 
JSON_EXPORT int json_pointer_getf (struct json_object *obj, struct json_object **res, const char *path_fmt,...)
 
JSON_EXPORT int json_pointer_set (struct json_object **obj, const char *path, struct json_object *value)
 
JSON_EXPORT int json_pointer_setf (struct json_object **obj, struct json_object *value, const char *path_fmt,...)
 
+

Detailed Description

+

JSON Pointer (RFC 6901) implementation for retrieving objects from a json-c object tree.

+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_pointer_get (struct json_object * obj,
const char * path,
struct json_object ** res 
)
+
+

Retrieves a JSON sub-object from inside another JSON object using the JSON pointer notation as defined in RFC 6901 https://tools.ietf.org/html/rfc6901

+

The returned JSON sub-object is equivalent to parsing manually the 'obj' JSON tree ; i.e. it's not a new object that is created, but rather a pointer inside the JSON tree.

+

Internally, this is equivalent to doing a series of 'json_object_object_get()' and 'json_object_array_get_idx()' along the given 'path'.

+

Note that the 'path' string supports 'printf()' type arguments, so, whatever is added after the 'res' param will be treated as an argument for 'path' Example: json_pointer_get(obj, "/foo/%d/%s", &res, 0, bar) This means, that you need to escape '' with '%' (just like in printf())

+
Parameters
+ + + + +
objthe json_object instance/tree from where to retrieve sub-objects
patha (RFC6901) string notation for the sub-object to retrieve
resa pointer that stores a reference to the json_object associated with the given path
+
+
+
Returns
negative if an error (or not found), or 0 if succeeded
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_pointer_getf (struct json_object * obj,
struct json_object ** res,
const char * path_fmt,
 ... 
)
+
+

This is a variant of 'json_pointer_get()' that supports printf() style arguments.

+

Example: json_pointer_getf(obj, res, "/foo/%d/%s", 0, bak) This also means that you need to escape '' with '%' (just like in printf())

+

Please take into consideration all recommended 'printf()' format security aspects when using this function.

+
Parameters
+ + + + +
objthe json_object instance/tree to which to add a sub-object
resa pointer that stores a reference to the json_object associated with the given path
path_fmta printf() style format for the path
+
+
+
Returns
negative if an error (or not found), or 0 if succeeded
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_pointer_set (struct json_object ** obj,
const char * path,
struct json_object * value 
)
+
+

Sets JSON object 'value' in the 'obj' tree at the location specified by the 'path'. 'path' is JSON pointer notation as defined in RFC 6901 https://tools.ietf.org/html/rfc6901

+

Note that 'obj' is a double pointer, mostly for the "" (empty string) case, where the entire JSON object would be replaced by 'value'. In the case of the "" path, the object at '*obj' will have it's refcount decremented with 'json_object_put()' and the 'value' object will be assigned to it.

+

For other cases (JSON sub-objects) ownership of 'value' will be transferred into '*obj' via 'json_object_object_add()' & 'json_object_array_put_idx()', so the only time the refcount should be decremented for 'value' is when the return value of 'json_pointer_set()' is negative (meaning the 'value' object did not get set into '*obj').

+

That also implies that 'json_pointer_set()' does not do any refcount incrementing. (Just that single decrement that was mentioned above).

+

Note that the 'path' string supports 'printf()' type arguments, so, whatever is added after the 'value' param will be treated as an argument for 'path' Example: json_pointer_set(obj, "/foo/%d/%s", value, 0, bak) This means, that you need to escape '' with '%' (just like in printf())

+
Parameters
+ + + + +
objthe json_object instance/tree to which to add a sub-object
patha (RFC6901) string notation for the sub-object to set in the tree
valueobject to set at path
+
+
+
Returns
negative if an error (or not found), or 0 if succeeded
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_pointer_setf (struct json_object ** obj,
struct json_object * value,
const char * path_fmt,
 ... 
)
+
+

This is a variant of 'json_pointer_set()' that supports printf() style arguments.

+

Example: json_pointer_setf(obj, value, "/foo/%d/%s", 0, bak) This also means that you need to escape '' with '%' (just like in printf())

+

Please take into consideration all recommended 'printf()' format security aspects when using this function.

+
Parameters
+ + + + +
objthe json_object instance/tree to which to add a sub-object
valueobject to set at path
path_fmta printf() style format for the path
+
+
+
Returns
negative if an error (or not found), or 0 if succeeded
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__tokener_8h.html b/doc/html/json__tokener_8h.html new file mode 100644 index 0000000..adce19d --- /dev/null +++ b/doc/html/json__tokener_8h.html @@ -0,0 +1,686 @@ + + + + + +json-c: json_tokener.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Structures | +Macros | +Typedefs | +Enumerations | +Functions
+
+
json_tokener.h File Reference
+
+
+ +

Methods to parse an input string into a tree of json_object objects. +More...

+ + + + + + +

+Data Structures

struct  json_tokener_srec
 
struct  json_tokener
 
+ + + + + + + + + +

+Macros

#define JSON_TOKENER_DEFAULT_DEPTH   32
 
#define JSON_TOKENER_STRICT   0x01
 
#define JSON_TOKENER_ALLOW_TRAILING_CHARS   0x02
 
#define JSON_TOKENER_VALIDATE_UTF8   0x10
 
+ + + +

+Typedefs

typedef struct json_tokener json_tokener
 
+ + + + + +

+Enumerations

enum  json_tokener_error {
+  json_tokener_success, +json_tokener_continue, +json_tokener_error_depth, +json_tokener_error_parse_eof, +
+  json_tokener_error_parse_unexpected, +json_tokener_error_parse_null, +json_tokener_error_parse_boolean, +json_tokener_error_parse_number, +
+  json_tokener_error_parse_array, +json_tokener_error_parse_object_key_name, +json_tokener_error_parse_object_key_sep, +json_tokener_error_parse_object_value_sep, +
+  json_tokener_error_parse_string, +json_tokener_error_parse_comment, +json_tokener_error_parse_utf8_string, +json_tokener_error_size +
+ }
 
enum  json_tokener_state {
+  json_tokener_state_eatws, +json_tokener_state_start, +json_tokener_state_finish, +json_tokener_state_null, +
+  json_tokener_state_comment_start, +json_tokener_state_comment, +json_tokener_state_comment_eol, +json_tokener_state_comment_end, +
+  json_tokener_state_string, +json_tokener_state_string_escape, +json_tokener_state_escape_unicode, +json_tokener_state_escape_unicode_need_escape, +
+  json_tokener_state_escape_unicode_need_u, +json_tokener_state_boolean, +json_tokener_state_number, +json_tokener_state_array, +
+  json_tokener_state_array_add, +json_tokener_state_array_sep, +json_tokener_state_object_field_start, +json_tokener_state_object_field, +
+  json_tokener_state_object_field_end, +json_tokener_state_object_value, +json_tokener_state_object_value_add, +json_tokener_state_object_sep, +
+  json_tokener_state_array_after_sep, +json_tokener_state_object_field_start_after_sep, +json_tokener_state_inf +
+ }
 
+ + + + + + + + + + + + + + + + + + + + + + + +

+Functions

JSON_EXPORT size_t json_tokener_get_parse_end (struct json_tokener *tok)
 
JSON_EXPORT const char * json_tokener_error_desc (enum json_tokener_error jerr)
 
JSON_EXPORT enum json_tokener_error json_tokener_get_error (struct json_tokener *tok)
 
JSON_EXPORT struct json_tokener * json_tokener_new (void)
 
JSON_EXPORT struct json_tokener * json_tokener_new_ex (int depth)
 
JSON_EXPORT void json_tokener_free (struct json_tokener *tok)
 
JSON_EXPORT void json_tokener_reset (struct json_tokener *tok)
 
JSON_EXPORT struct json_object * json_tokener_parse (const char *str)
 
JSON_EXPORT struct json_object * json_tokener_parse_verbose (const char *str, enum json_tokener_error *error)
 
JSON_EXPORT void json_tokener_set_flags (struct json_tokener *tok, int flags)
 
JSON_EXPORT struct json_object * json_tokener_parse_ex (struct json_tokener *tok, const char *str, int len)
 
+

Detailed Description

+

Methods to parse an input string into a tree of json_object objects.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_TOKENER_ALLOW_TRAILING_CHARS   0x02
+
+

Use with JSON_TOKENER_STRICT to allow trailing characters after the first parsed object.

+
See Also
json_tokener_set_flags()
+ +
+
+ +
+
+ + + + +
#define JSON_TOKENER_DEFAULT_DEPTH   32
+
+ +
+
+ +
+
+ + + + +
#define JSON_TOKENER_STRICT   0x01
+
+

Be strict when parsing JSON input. Use caution with this flag as what is considered valid may become more restrictive from one release to the next, causing your code to fail on previously working input.

+

Note that setting this will also effectively disable parsing of multiple json objects in a single character stream (e.g. {"foo":123}{"bar":234}); if you want to allow that also set JSON_TOKENER_ALLOW_TRAILING_CHARS

+

This flag is not set by default.

+
See Also
json_tokener_set_flags()
+ +
+
+ +
+
+ + + + +
#define JSON_TOKENER_VALIDATE_UTF8   0x10
+
+

Cause json_tokener_parse_ex() to validate that input is UTF8. If this flag is specified and validation fails, then json_tokener_get_error(tok) will return json_tokener_error_parse_utf8_string

+

This flag is not set by default.

+
See Also
json_tokener_set_flags()
+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef struct json_tokener json_tokener
+
+
Deprecated:
Unused in json-c code
+ +
+
+

Enumeration Type Documentation

+ +
+
+ + + + +
enum json_tokener_error
+
+
Enumerator:
+ + + + + + + + + + + + + + + + +
json_tokener_success  +
json_tokener_continue  +
json_tokener_error_depth  +
json_tokener_error_parse_eof  +
json_tokener_error_parse_unexpected  +
json_tokener_error_parse_null  +
json_tokener_error_parse_boolean  +
json_tokener_error_parse_number  +
json_tokener_error_parse_array  +
json_tokener_error_parse_object_key_name  +
json_tokener_error_parse_object_key_sep  +
json_tokener_error_parse_object_value_sep  +
json_tokener_error_parse_string  +
json_tokener_error_parse_comment  +
json_tokener_error_parse_utf8_string  +
json_tokener_error_size  +
+
+
+ +
+
+ +
+
+ + + + +
enum json_tokener_state
+
+
Deprecated:
Don't use this outside of json_tokener.c, it will be made private in a future release.
+
Enumerator:
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
json_tokener_state_eatws  +
json_tokener_state_start  +
json_tokener_state_finish  +
json_tokener_state_null  +
json_tokener_state_comment_start  +
json_tokener_state_comment  +
json_tokener_state_comment_eol  +
json_tokener_state_comment_end  +
json_tokener_state_string  +
json_tokener_state_string_escape  +
json_tokener_state_escape_unicode  +
json_tokener_state_escape_unicode_need_escape  +
json_tokener_state_escape_unicode_need_u  +
json_tokener_state_boolean  +
json_tokener_state_number  +
json_tokener_state_array  +
json_tokener_state_array_add  +
json_tokener_state_array_sep  +
json_tokener_state_object_field_start  +
json_tokener_state_object_field  +
json_tokener_state_object_field_end  +
json_tokener_state_object_value  +
json_tokener_state_object_value_add  +
json_tokener_state_object_sep  +
json_tokener_state_array_after_sep  +
json_tokener_state_object_field_start_after_sep  +
json_tokener_state_inf  +
+
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_tokener_error_desc (enum json_tokener_error jerr)
+
+

Given an error previously returned by json_tokener_get_error(), return a human readable description of the error.

+
Returns
a generic error message is returned if an invalid error value is provided.
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT void json_tokener_free (struct json_tokener * tok)
+
+

Free a json_tokener previously allocated with json_tokener_new().

+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT enum json_tokener_error json_tokener_get_error (struct json_tokener * tok)
+
+

Retrieve the error caused by the last call to json_tokener_parse_ex(), or json_tokener_success if there is no error.

+

When parsing a JSON string in pieces, if the tokener is in the middle of parsing this will return json_tokener_continue.

+
See Also
json_tokener_error_desc().
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT size_t json_tokener_get_parse_end (struct json_tokener * tok)
+
+

Return the offset of the byte after the last byte parsed relative to the start of the most recent string passed in to json_tokener_parse_ex(). i.e. this is where parsing would start again if the input contains another JSON object after the currently parsed one.

+

Note that when multiple parse calls are issued, this is not the total number of characters parsed.

+

In the past this would have been accessed as tok->char_offset.

+

See json_tokener_parse_ex() for an example of how to use this.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_tokener* json_tokener_new (void )
+ 		+read
+
+

Allocate a new json_tokener. When done using that to parse objects, free it with json_tokener_free(). See json_tokener_parse_ex() for usage details.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_tokener* json_tokener_new_ex (int depth)
+ 		+read
+
+

Allocate a new json_tokener with a custom max nesting depth.

+
See Also
JSON_TOKENER_DEFAULT_DEPTH
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_tokener_parse (const char * str)
+ 		+read
+
+

Parse a json_object out of the string str.

+

If you need more control over how the parsing occurs, see json_tokener_parse_ex().

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_tokener_parse_ex (struct json_tokener * tok,
const char * str,
int len 
)
+ 		+read
+
+

Parse a string and return a non-NULL json_object if a valid JSON value is found. The string does not need to be a JSON object or array; it can also be a string, number or boolean value.

+

A partial JSON string can be parsed. If the parsing is incomplete, NULL will be returned and json_tokener_get_error() will return json_tokener_continue. json_tokener_parse_ex() can then be called with additional bytes in str to continue the parsing.

+

If json_tokener_parse_ex() returns NULL and the error is anything other than json_tokener_continue, a fatal error has occurred and parsing must be halted. Then, the tok object must not be reused until json_tokener_reset() is called.

+

When a valid JSON value is parsed, a non-NULL json_object will be returned, with a reference count of one which belongs to the caller. Also, json_tokener_get_error() will return json_tokener_success. Be sure to check the type with json_object_is_type() or json_object_get_type() before using the object.

+

Trailing characters after the parsed value do not automatically cause an error. It is up to the caller to decide whether to treat this as an error or to handle the additional characters, perhaps by parsing another json value starting from that point.

+

If the caller knows that they are at the end of their input, the length passed MUST include the final '\0' character, so values with no inherent end (i.e. numbers) can be properly parsed, rather than just returning json_tokener_continue.

+

Extra characters can be detected by comparing the value returned by json_tokener_get_parse_end() against the length of the last len parameter passed in.

+

The tokener does not maintain an internal buffer so the caller is responsible for a subsequent call to json_tokener_parse_ex with an appropriate str parameter starting with the extra characters.

+

This interface is presently not 64-bit clean due to the int len argument so the function limits the maximum string size to INT32_MAX (2GB). If the function is called with len == -1 then strlen is called to check the string length is less than INT32_MAX (2GB)

+

Example:

+
json_object *jobj = NULL;
+
const char *mystring = NULL;
+
int stringlen = 0;
+
enum json_tokener_error jerr;
+
do {
+
mystring = ... // get JSON string, e.g. read from file, etc...
+
stringlen = strlen(mystring);
+
if (end_of_input)
+
stringlen++; // Include the '\0' if we know we're at the end of input
+
jobj = json_tokener_parse_ex(tok, mystring, stringlen);
+
} while ((jerr = json_tokener_get_error(tok)) == json_tokener_continue);
+
if (jerr != json_tokener_success)
+
{
+
fprintf(stderr, "Error: %s\n", json_tokener_error_desc(jerr));
+
// Handle errors, as appropriate for your application.
+
}
+
if (json_tokener_get_parse_end(tok) < stringlen)
+
{
+
// Handle extra characters after parsed object as desired.
+
// e.g. issue an error, parse another object from that point, etc...
+
}
+
// Success, use jobj here.
+
Parameters
+ + + + +
toka json_tokener previously allocated with json_tokener_new()
stran string with any valid JSON expression, or portion of. This does not need to be null terminated.
lenthe length of str
+
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_tokener_parse_verbose (const char * str,
enum json_tokener_error * error 
)
+ 		+read
+
+

Parser a json_object out of the string str, but if it fails return the error in *error.

+
See Also
json_tokener_parse()
+
+json_tokener_parse_ex()
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT void json_tokener_reset (struct json_tokener * tok)
+
+

Reset the state of a json_tokener, to prepare to parse a brand new JSON object.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT void json_tokener_set_flags (struct json_tokener * tok,
int flags 
)
+
+

Set flags that control how parsing will be done.

+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__types_8h.html b/doc/html/json__types_8h.html new file mode 100644 index 0000000..281d067 --- /dev/null +++ b/doc/html/json__types_8h.html @@ -0,0 +1,230 @@ + + + + + +json-c: json_types.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Structures | +Macros | +Typedefs | +Enumerations
+
+
json_types.h File Reference
+
+
+ +

Basic types used in a few places in json-c, but you should include "json_object.h" instead. +More...

+ + + + +

+Data Structures

struct  json_object_iter
 
+ + + +

+Macros

#define JSON_EXPORT   extern
 
+ + + + + + + + + + + + + + +

+Typedefs

typedef struct json_object_iter json_object_iter
 
typedef int json_bool
 
typedef struct json_object json_object
 The core type for all type of JSON objects handled by json-c.
 
typedef void( json_object_delete_fn )(struct json_object *jso, void *userdata)
 
typedef int( json_object_to_json_string_fn )(struct json_object *jso, struct printbuf *pb, int level, int flags)
 
typedef enum json_type json_type
 
+ + + +

+Enumerations

enum  json_type {
+  json_type_null, +json_type_boolean, +json_type_double, +json_type_int, +
+  json_type_object, +json_type_array, +json_type_string +
+ }
 
+

Detailed Description

+

Basic types used in a few places in json-c, but you should include "json_object.h" instead.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_EXPORT   extern
+
+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef int json_bool
+
+ +
+
+ +
+
+ + + + +
typedef struct json_object json_object
+
+ +

The core type for all type of JSON objects handled by json-c.

+ +
+
+ +
+
+ + + + +
typedef void( json_object_delete_fn)(struct json_object *jso, void *userdata)
+
+

Type of custom user delete functions. See json_object_set_serializer.

+ +
+
+ +
+
+ + + + +
typedef struct json_object_iter json_object_iter
+
+ +
+
+ +
+
+ + + + +
typedef int( json_object_to_json_string_fn)(struct json_object *jso, struct printbuf *pb, int level, int flags)
+
+

Type of a custom serialization function. See json_object_set_serializer.

+ +
+
+ +
+
+ + + + +
typedef enum json_type json_type
+
+ +
+
+

Enumeration Type Documentation

+ +
+
+ + + + +
enum json_type
+
+
Enumerator:
+ + + + + + + +
json_type_null  +
json_type_boolean  +
json_type_double  +
json_type_int  +
json_type_object  +
json_type_array  +
json_type_string  +
+
+
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__util_8h.html b/doc/html/json__util_8h.html new file mode 100644 index 0000000..ae37fd7 --- /dev/null +++ b/doc/html/json__util_8h.html @@ -0,0 +1,473 @@ + + + + + +json-c: json_util.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Macros | +Functions
+
+
json_util.h File Reference
+
+
+ +

Miscllaneous utility functions and macros. +More...

+ + + + + + + + +

+Macros

#define json_min(a, b)   ((a) < (b) ? (a) : (b))
 
#define json_max(a, b)   ((a) > (b) ? (a) : (b))
 
#define JSON_FILE_BUF_SIZE   4096
 
+ + + + + + + + + + + + + + + + + + + + + + + +

+Functions

JSON_EXPORT struct json_object * json_object_from_file (const char *filename)
 
JSON_EXPORT struct json_object * json_object_from_fd_ex (int fd, int depth)
 
JSON_EXPORT struct json_object * json_object_from_fd (int fd)
 
JSON_EXPORT int json_object_to_file (const char *filename, struct json_object *obj)
 
JSON_EXPORT int json_object_to_file_ext (const char *filename, struct json_object *obj, int flags)
 
JSON_EXPORT int json_object_to_fd (int fd, struct json_object *obj, int flags)
 
JSON_EXPORT const char * json_util_get_last_err (void)
 
JSON_EXPORT int json_parse_int64 (const char *buf, int64_t *retval)
 
JSON_EXPORT int json_parse_uint64 (const char *buf, uint64_t *retval)
 
JSON_EXPORT int json_parse_double (const char *buf, double *retval)
 
JSON_EXPORT const char * json_type_to_name (enum json_type o_type)
 
+

Detailed Description

+

Miscllaneous utility functions and macros.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_FILE_BUF_SIZE   4096
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
#define json_max( a,
 b 
)   ((a) > (b) ? (a) : (b))
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
#define json_min( a,
 b 
)   ((a) < (b) ? (a) : (b))
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_from_fd (int fd)
+ 		+read
+
+

Create a JSON object from an already opened file descriptor, using the default maximum object depth. (JSON_TOKENER_DEFAULT_DEPTH)

+

See json_object_from_fd_ex() for details.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT struct json_object* json_object_from_fd_ex (int fd,
int depth 
)
+ 		+read
+
+

Create a JSON object from already opened file descriptor.

+

This function can be helpful, when you opened the file already, e.g. when you have a temp file. Note, that the fd must be readable at the actual position, i.e. use lseek(fd, 0, SEEK_SET) before.

+

The depth argument specifies the maximum object depth to pass to json_tokener_new_ex(). When depth == -1, JSON_TOKENER_DEFAULT_DEPTH is used instead.

+

Returns NULL on failure. See json_util_get_last_err() for details.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct json_object* json_object_from_file (const char * filename)
+ 		+read
+
+

Read the full contents of the given file, then convert it to a json_object using json_tokener_parse().

+

Returns NULL on failure. See json_util_get_last_err() for details.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_to_fd (int fd,
struct json_object * obj,
int flags 
)
+
+

Convert the json_object to a string and write it to the file descriptor. Handles partial writes and will keep writing until done, or an error occurs.

+
Parameters
+ + + + +
fdan open, writable file descriptor to write to
objthe object to serializer and write
flagsflags to pass to json_object_to_json_string_ext()
+
+
+
Returns
-1 if something fails. See json_util_get_last_err() for details.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_to_file (const char * filename,
struct json_object * obj 
)
+
+

Equivalent to: json_object_to_file_ext(filename, obj, JSON_C_TO_STRING_PLAIN);

+

Returns -1 if something fails. See json_util_get_last_err() for details.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_object_to_file_ext (const char * filename,
struct json_object * obj,
int flags 
)
+
+

Open and truncate the given file, creating it if necessary, then convert the json_object to a string and write it to the file.

+

Returns -1 if something fails. See json_util_get_last_err() for details.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_parse_double (const char * buf,
double * retval 
)
+
+
Deprecated:
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_parse_int64 (const char * buf,
int64_t * retval 
)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_parse_uint64 (const char * buf,
uint64_t * retval 
)
+
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_type_to_name (enum json_type o_type)
+
+

Return a string describing the type of the object. e.g. "int", or "object", etc...

+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT const char* json_util_get_last_err (void )
+
+

Return the last error from various json-c functions, including: json_object_to_file{,ext}, json_object_to_fd() or json_object_from{file,fd}, or NULL if there is none.

+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/json__visit_8h.html b/doc/html/json__visit_8h.html new file mode 100644 index 0000000..bae4d69 --- /dev/null +++ b/doc/html/json__visit_8h.html @@ -0,0 +1,239 @@ + + + + + +json-c: json_visit.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Macros | +Typedefs | +Functions
+
+
json_visit.h File Reference
+
+
+ +

Methods for walking a tree of objects. +More...

+ + + + + + + + + + + + + + +

+Macros

#define JSON_C_VISIT_SECOND   0x02
 
#define JSON_C_VISIT_RETURN_CONTINUE   0
 
#define JSON_C_VISIT_RETURN_SKIP   7547
 
#define JSON_C_VISIT_RETURN_POP   767
 
#define JSON_C_VISIT_RETURN_STOP   7867
 
#define JSON_C_VISIT_RETURN_ERROR   -1
 
+ + + +

+Typedefs

typedef int( json_c_visit_userfunc )(json_object *jso, int flags, json_object *parent_jso, const char *jso_key, size_t *jso_index, void *userarg)
 
+ + + +

+Functions

JSON_EXPORT int json_c_visit (json_object *jso, int future_flags, json_c_visit_userfunc *userfunc, void *userarg)
 
+

Detailed Description

+

Methods for walking a tree of objects.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_C_VISIT_RETURN_CONTINUE   0
+
+

This json_c_visit_userfunc return value indicates that iteration should proceed normally.

+ +
+
+ +
+
+ + + + +
#define JSON_C_VISIT_RETURN_ERROR   -1
+
+

This json_c_visit_userfunc return value indicates that iteration should stop immediately, and cause json_c_visit to return an error.

+ +
+
+ +
+
+ + + + +
#define JSON_C_VISIT_RETURN_POP   767
+
+

This json_c_visit_userfunc return value indicates that iteration of the fields/elements of the containing object should stop and continue "popped up" a level of the object hierarchy. For example, returning this when handling arg will result in arg3 and any other fields being skipped. The next call to userfunc will be the JSON_C_VISIT_SECOND call on "foo", followed by a userfunc call on "bar".

+
+{
+  "foo": {
+    "arg1": 1,
+    "arg2": 2,
+    "arg3": 3,
+    ...
+  },
+  "bar": {
+    ...
+  }
+}
+
+
+
+ +
+
+ + + + +
#define JSON_C_VISIT_RETURN_SKIP   7547
+
+

This json_c_visit_userfunc return value indicates that iteration over the members of the current object should be skipped. If the current object isn't a container (array or object), this is no different than JSON_C_VISIT_RETURN_CONTINUE.

+ +
+
+ +
+
+ + + + +
#define JSON_C_VISIT_RETURN_STOP   7867
+
+

This json_c_visit_userfunc return value indicates that iteration should stop immediately, and cause json_c_visit to return success.

+ +
+
+ +
+
+ + + + +
#define JSON_C_VISIT_SECOND   0x02
+
+

Passed to json_c_visit_userfunc as one of the flags values to indicate that this is the second time a container (array or object) is being called, after all of it's members have been iterated over.

+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef int( json_c_visit_userfunc)(json_object *jso, int flags, json_object *parent_jso, const char *jso_key, size_t *jso_index, void *userarg)
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int json_c_visit (json_object * jso,
int future_flags,
json_c_visit_userfunc * userfunc,
void * userarg 
)
+
+

Visit each object in the JSON hierarchy starting at jso. For each object, userfunc is called, passing the object and userarg. If the object has a parent (i.e. anything other than jso itself) its parent will be passed as parent_jso, and either jso_key or jso_index will be set, depending on whether the parent is an object or an array.

+

Nodes will be visited depth first, but containers (arrays and objects) will be visited twice, the second time with JSON_C_VISIT_SECOND set in flags.

+

userfunc must return one of the defined return values, to indicate whether and how to continue visiting nodes, or one of various ways to stop.

+

Returns 0 if nodes were visited successfully, even if some were intentionally skipped due to what userfunc returned. Returns <0 if an error occurred during iteration, including if userfunc returned JSON_C_VISIT_RETURN_ERROR.

+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/linkhash_8h.html b/doc/html/linkhash_8h.html new file mode 100644 index 0000000..2f09b14 --- /dev/null +++ b/doc/html/linkhash_8h.html @@ -0,0 +1,1155 @@ + + + + + +json-c: linkhash.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Structures | +Macros | +Typedefs | +Functions
+
+
linkhash.h File Reference
+
+
+ +

Internal methods for working with json_type_object objects. Although this is exposed by the json_object_get_object() function and within the json_object_iter type, it is not recommended for direct use. +More...

+ + + + + + +

+Data Structures

struct  lh_entry
 
struct  lh_table
 
+ + + + + + + + + + + + + + + + + +

+Macros

#define LH_PRIME   0x9e370001UL
 
#define LH_LOAD_FACTOR   0.66
 
#define LH_EMPTY   (void *)-1
 
#define LH_FREED   (void *)-2
 
#define JSON_C_STR_HASH_DFLT   0
 
#define JSON_C_STR_HASH_PERLLIKE   1
 
#define lh_foreach(table, entry)   for (entry = lh_table_head(table); entry; entry = lh_entry_next(entry))
 
#define lh_foreach_safe(table, entry, tmp)   for (entry = lh_table_head(table); entry && ((tmp = lh_entry_next(entry)) || 1); entry = tmp)
 
+ + + + + + + + + +

+Typedefs

typedef void( lh_entry_free_fn )(struct lh_entry *e)
 
typedef unsigned long( lh_hash_fn )(const void *k)
 
typedef int( lh_equal_fn )(const void *k1, const void *k2)
 
typedef struct lh_table lh_table
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Functions

int json_global_set_string_hash (const int h)
 
struct lh_table * lh_table_new (int size, lh_entry_free_fn *free_fn, lh_hash_fn *hash_fn, lh_equal_fn *equal_fn)
 
struct lh_table * lh_kchar_table_new (int size, lh_entry_free_fn *free_fn)
 
struct lh_table * lh_kptr_table_new (int size, lh_entry_free_fn *free_fn)
 
void lh_table_free (struct lh_table *t)
 
int lh_table_insert (struct lh_table *t, const void *k, const void *v)
 
int lh_table_insert_w_hash (struct lh_table *t, const void *k, const void *v, const unsigned long h, const unsigned opts)
 
struct lh_entry * lh_table_lookup_entry (struct lh_table *t, const void *k)
 
struct lh_entry * lh_table_lookup_entry_w_hash (struct lh_table *t, const void *k, const unsigned long h)
 
json_bool lh_table_lookup_ex (struct lh_table *t, const void *k, void **v)
 
int lh_table_delete_entry (struct lh_table *t, struct lh_entry *e)
 
int lh_table_delete (struct lh_table *t, const void *k)
 
int lh_table_length (struct lh_table *t)
 
int lh_table_resize (struct lh_table *t, int new_size)
 
static struct lh_entry * lh_table_head (const lh_table *t)
 
static unsigned long lh_get_hash (const struct lh_table *t, const void *k)
 
static void * lh_entry_k (const struct lh_entry *e)
 
static int lh_entry_k_is_constant (const struct lh_entry *e)
 
static void * lh_entry_v (const struct lh_entry *e)
 
static void lh_entry_set_val (struct lh_entry *e, void *newval)
 
static struct lh_entry * lh_entry_next (const struct lh_entry *e)
 
static struct lh_entry * lh_entry_prev (const struct lh_entry *e)
 
+

Detailed Description

+

Internal methods for working with json_type_object objects. Although this is exposed by the json_object_get_object() function and within the json_object_iter type, it is not recommended for direct use.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_C_STR_HASH_DFLT   0
+
+

default string hash function

+ +
+
+ +
+
+ + + + +
#define JSON_C_STR_HASH_PERLLIKE   1
+
+

perl-like string hash function

+ +
+
+ +
+
+ + + + +
#define LH_EMPTY   (void *)-1
+
+

sentinel pointer value for empty slots

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
#define lh_foreach( table,
 entry 
)   for (entry = lh_table_head(table); entry; entry = lh_entry_next(entry))
+
+

Convenience list iterator.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
#define lh_foreach_safe( table,
 entry,
 tmp 
)   for (entry = lh_table_head(table); entry && ((tmp = lh_entry_next(entry)) || 1); entry = tmp)
+
+

lh_foreach_safe allows calling of deletion routine while iterating.

+
Parameters
+ + + + +
tablea struct lh_table * to iterate over
entrya struct lh_entry * variable to hold each element
tmpa struct lh_entry * variable to hold a temporary pointer to the next element
+
+
+ +
+
+ +
+
+ + + + +
#define LH_FREED   (void *)-2
+
+

sentinel pointer value for freed slots

+ +
+
+ +
+
+ + + + +
#define LH_LOAD_FACTOR   0.66
+
+

The fraction of filled hash buckets until an insert will cause the table to be resized. This can range from just above 0 up to 1.0.

+ +
+
+ +
+
+ + + + +
#define LH_PRIME   0x9e370001UL
+
+

golden prime used in hash functions

+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef void( lh_entry_free_fn)(struct lh_entry *e)
+
+

callback function prototypes

+ +
+
+ +
+
+ + + + +
typedef int( lh_equal_fn)(const void *k1, const void *k2)
+
+

callback function prototypes

+ +
+
+ +
+
+ + + + +
typedef unsigned long( lh_hash_fn)(const void *k)
+
+

callback function prototypes

+ +
+
+ +
+
+ + + + +
typedef struct lh_table lh_table
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + +
int json_global_set_string_hash (const int h)
+
+

This function sets the hash function to be used for strings. Must be one of the JSON_C_STR_HASH_* values.

+
Returns
0 - ok, -1 if parameter was invalid
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
static void* lh_entry_k (const struct lh_entry * e)
+ 		+inlinestatic
+
+

Return a non-const version of lh_entry.k.

+

lh_entry.k is const to indicate and help ensure that linkhash itself doesn't modify it, but callers are allowed to do what they want with it.

+
See Also
lh_entry_k_is_constant()
+ +

References lh_entry::k.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
static int lh_entry_k_is_constant (const struct lh_entry * e)
+ 		+inlinestatic
+
+

Returns 1 if the key for the given entry is constant, and thus does not need to be freed when the lh_entry is freed.

+
See Also
lh_table_insert_w_hash()
+ +

References lh_entry::k_is_constant.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
static struct lh_entry* lh_entry_next (const struct lh_entry * e)
+ 		+staticread
+
+

Return the next element, or NULL if there is no next element.

+
See Also
lh_table_head()
+
+lh_entry_prev()
+ +

References lh_entry::next.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
static struct lh_entry* lh_entry_prev (const struct lh_entry * e)
+ 		+staticread
+
+

Return the previous element, or NULL if there is no previous element.

+
See Also
lh_table_head()
+
+lh_entry_next()
+ +

References lh_entry::prev.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
static void lh_entry_set_val (struct lh_entry * e,
void * newval 
)
+ 		+inlinestatic
+
+

Change the value for an entry. The caller is responsible for freeing the previous value.

+ +

References lh_entry::v.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
static void* lh_entry_v (const struct lh_entry * e)
+ 		+inlinestatic
+
+

Return a non-const version of lh_entry.v.

+

v is const to indicate and help ensure that linkhash itself doesn't modify it, but callers are allowed to do what they want with it.

+ +

References lh_entry::v.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
static unsigned long lh_get_hash (const struct lh_table * t,
const void * k 
)
+ 		+inlinestatic
+
+

Calculate the hash of a key for a given table.

+

This is an extension to support functions that need to calculate the hash several times and allows them to do it just once and then pass in the hash to all utility functions. Depending on use case, this can be a considerable performance improvement.

+
Parameters
+ + + +
tthe table (used to obtain hash function)
ka pointer to the key to lookup
+
+
+
Returns
the key's hash
+ +

References lh_table::hash_fn.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
struct lh_table* lh_kchar_table_new (int size,
lh_entry_free_fn * free_fn 
)
+ 		+read
+
+

Convenience function to create a new linkhash table with char keys.

+
Parameters
+ + + +
sizeinitial table size.
free_fncallback function used to free memory for entries.
+
+
+
Returns
On success, a pointer to the new linkhash table is returned. On error, a null pointer is returned.
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
struct lh_table* lh_kptr_table_new (int size,
lh_entry_free_fn * free_fn 
)
+ 		+read
+
+

Convenience function to create a new linkhash table with ptr keys.

+
Parameters
+ + + +
sizeinitial table size.
free_fncallback function used to free memory for entries.
+
+
+
Returns
On success, a pointer to the new linkhash table is returned. On error, a null pointer is returned.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
int lh_table_delete (struct lh_table * t,
const void * k 
)
+
+

Delete a record from the table.

+

If a callback free function is provided then it is called for the for the item being deleted.

+
Parameters
+ + + +
tthe table to delete from.
ka pointer to the key to delete.
+
+
+
Returns
0 if the item was deleted.
+
+-1 if it was not found.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
int lh_table_delete_entry (struct lh_table * t,
struct lh_entry * e 
)
+
+

Delete a record from the table.

+

If a callback free function is provided then it is called for the for the item being deleted.

+
Parameters
+ + + +
tthe table to delete from.
ea pointer to the entry to delete.
+
+
+
Returns
0 if the item was deleted.
+
+-1 if it was not found.
+ +
+
+ +
+
+ + + + + + + + +
void lh_table_free (struct lh_table * t)
+
+

Free a linkhash table.

+

If a lh_entry_free_fn callback free function was provided then it is called for all entries in the table.

+
Parameters
+ + +
ttable to free.
+
+
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
static struct lh_entry* lh_table_head (const lh_table * t)
+ 		+staticread
+
+

Return the first entry in the lh_table.

+
See Also
lh_entry_next()
+ +

References lh_table::head.

+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int lh_table_insert (struct lh_table * t,
const void * k,
const void * v 
)
+
+

Insert a record into the table.

+
Parameters
+ + + + +
tthe table to insert into.
ka pointer to the key to insert.
va pointer to the value to insert.
+
+
+
Returns
On success, 0 is returned. On error, a negative value is returned.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int lh_table_insert_w_hash (struct lh_table * t,
const void * k,
const void * v,
const unsigned long h,
const unsigned opts 
)
+
+

Insert a record into the table using a precalculated key hash.

+

The hash h, which should be calculated with lh_get_hash() on k, is provided by the caller, to allow for optimization when multiple operations with the same key are known to be needed.

+
Parameters
+ + + + + + +
tthe table to insert into.
ka pointer to the key to insert.
va pointer to the value to insert.
hhash value of the key to insert
optsif set to JSON_C_OBJECT_ADD_CONSTANT_KEY, sets lh_entry.k_is_constant so t's free function knows to avoid freeing the key.
+
+
+ +
+
+ +
+
+ + + + + + + + +
int lh_table_length (struct lh_table * t)
+
+

Return the number of entries in the table.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
struct lh_entry* lh_table_lookup_entry (struct lh_table * t,
const void * k 
)
+ 		+read
+
+

Lookup a record in the table.

+
Parameters
+ + + +
tthe table to lookup
ka pointer to the key to lookup
+
+
+
Returns
a pointer to the record structure of the value or NULL if it does not exist.
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
struct lh_entry* lh_table_lookup_entry_w_hash (struct lh_table * t,
const void * k,
const unsigned long h 
)
+ 		+read
+
+

Lookup a record in the table using a precalculated key hash.

+

The hash h, which should be calculated with lh_get_hash() on k, is provided by the caller, to allow for optimization when multiple operations with the same key are known to be needed.

+
Parameters
+ + + + +
tthe table to lookup
ka pointer to the key to lookup
hhash value of the key to lookup
+
+
+
Returns
a pointer to the record structure of the value or NULL if it does not exist.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
json_bool lh_table_lookup_ex (struct lh_table * t,
const void * k,
void ** v 
)
+
+

Lookup a record in the table.

+
Parameters
+ + + + +
tthe table to lookup
ka pointer to the key to lookup
va pointer to a where to store the found value (set to NULL if it doesn't exist).
+
+
+
Returns
whether or not the key was found
+ +
+
+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
struct lh_table* lh_table_new (int size,
lh_entry_free_fn * free_fn,
lh_hash_fn * hash_fn,
lh_equal_fn * equal_fn 
)
+ 		+read
+
+

Create a new linkhash table.

+
Parameters
+ + + + + +
sizeinitial table size. The table is automatically resized although this incurs a performance penalty.
free_fncallback function used to free memory for entries when lh_table_free or lh_table_delete is called. If NULL is provided, then memory for keys and values must be freed by the caller.
hash_fnfunction used to hash keys. 2 standard ones are defined: lh_ptr_hash and lh_char_hash for hashing pointer values and C strings respectively.
equal_fncomparison function to compare keys. 2 standard ones defined: lh_ptr_hash and lh_char_hash for comparing pointer values and C strings respectively.
+
+
+
Returns
On success, a pointer to the new linkhash table is returned. On error, a null pointer is returned.
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
int lh_table_resize (struct lh_table * t,
int new_size 
)
+
+

Resizes the specified table.

+
Parameters
+ + + +
tPointer to table to resize.
new_sizeNew table size. Must be positive.
+
+
+
Returns
On success, 0 is returned. On error, a negative value is returned.
+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/md_README.html b/doc/html/md_README.html new file mode 100644 index 0000000..6510b63 --- /dev/null +++ b/doc/html/md_README.html @@ -0,0 +1,51 @@ + + + + + +json-c: README + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + +
+
+
+
README
+
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/md_issues_closed_for_0.html b/doc/html/md_issues_closed_for_0.html new file mode 100644 index 0000000..84e8993 --- /dev/null +++ b/doc/html/md_issues_closed_for_0.html @@ -0,0 +1,695 @@ + + + + + +json-c: issues_closed_for_0 + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + +
+
+
+
issues_closed_for_0
+
+
+

This list was created with:

+
curl https://api.github.com/search/issues?q="repo%3Ajson-c%2Fjson-c+closed%3A>2014-04-10+created%3A<2017-12-01&sort=created&order=asc&per_page=400&page=1" > issues1.out
+curl https://api.github.com/search/issues?q="repo%3Ajson-c%2Fjson-c+closed%3A>2014-04-10+created%3A<2017-12-01&sort=created&order=asc&per_page=400&page=2" > issues2.out
+curl https://api.github.com/search/issues?q="repo%3Ajson-c%2Fjson-c+closed%3A>2014-04-10+created%3A<2017-12-01&sort=created&order=asc&per_page=400&page=3" > issues3.out
+jq -r '.items[] | "[" + .title + "](" + .url + ")" | tostring' issues?.out  > issues.md
+sed -e's,^\[ *\(.*\)\](https://api.github.com/.*/\([0-9].*\)),[Issue #\2](https://github.com/json-c/json-c/issues/\2) - \1,' -i issues.md
+#... manual editing ...
+
+

Issues and Pull Requests closed for the 0.13 release (since commit f84d9c, the 0.12 branch point, 2014-04-10)

+ +

This list was created with:

+
curl https://api.github.com/search/issues?q="repo%3Ajson-c%2Fjson-c+closed%3A>2017-12-07+created%3A<2020-04-17&sort=created&order=asc&per_page=400&page=1" > issues1.out
+curl https://api.github.com/search/issues?q="repo%3Ajson-c%2Fjson-c+closed%3A>2017-12-07+created%3A<2020-04-17&sort=created&order=asc&per_page=400&page=2" > issues2.out
+curl https://api.github.com/search/issues?q="repo%3Ajson-c%2Fjson-c+closed%3A>2017-12-07+created%3A<2020-04-17&sort=created&order=asc&per_page=400&page=3" > issues3.out
+jq -r '.items[] | "[" + .title + "](" + .url + ")" | tostring' issues?.out > issues.md
+sed -e's,^\[ *\(.*\)\](https://api.github.com/.*/\([0-9].*\)),[Issue #\2](https://github.com/json-c/json-c/issues/\2) - \1,' -i issues.md
+#... manual editing ...
+
+

Issues and Pull Requests closed for the 0.14 release (since commit d582d3a(2017-12-07) to a911439(2020-04-17))

+ +

This list was created with:

+
curl "https://api.github.com/search/issues?q=repo%3Ajson-c%2Fjson-c+closed%3A>2020-04-18+created%3A<2020-07-23&sort=created&order=asc&per_page=100&page=1" > issues1.out
+jq -r '.items[] | "[" + .title + "](" + .url + ")" | tostring' issues?.out > issues.md
+sed -e's,^\[ *\(.*\)\](https://api.github.com/.*/\([0-9].*\)),* [Issue #\2](https://github.com/json-c/json-c/issues/\2) - \1,' -i issues.md
+#... manual editing ...
+
+

Issues and Pull Requests closed for the 0.15 release (since commit 31ab57ca, the 0.14 branch point, 2020-04-19)

+
    +
  • Issue #428 - Added new_null() function
    • +
  • Issue #429 - Conflict of interest between JSON_C_TO_STRING_SPACED and JSON_C_TO_STRING_PRETTY
    • +
  • Issue #451 - Add option to disable HAVE___THREAD
    • +
  • Issue #471 - create folders with mode 0755 when building
    • +
  • Issue #476 - Add new function named json_object_new_string_noalloc
    • +
  • Issue #484 - Add support for uint64
    • +
  • Issue #487 - Any plans to make new release? (0.14)
    • +
  • Issue #493 - Kdopen rename library
    • +
  • Issue #507 - Double value -1.0 converts to integer in json_object_to_json_string()
    • +
  • Issue #508 - Recommend enabling the -fPIC compiler flag by default
    • +
  • Issue #517 - Lja mods
    • +
  • Issue #534 - Both json-c and json-glib have json_object_get_type()
    • +
  • Issue #584 - CMake: SOVERSION and the major library VERSION need to be in lockstep.
    • +
  • Issue #585 - CMake: Do not install config.h, as it is not a public header file.
    • +
  • Issue #586 - 10796 Segmentation fault
    • +
  • Issue #588 - Broken RDRAND causes infinite looping
    • +
  • Issue #589 - Detect broken RDRAND during initialization
    • +
  • Issue #590 - Fix segmentation fault in CPUID check
    • +
  • Issue #591 - Update README.md
    • +
  • Issue #592 - Prevent out of boundary write on malicious input
    • +
  • Issue #593 - Building both static and shared libraries
    • +
  • Issue #594 - Some subsequent call of lh_get_hash not working
    • +
  • Issue #595 - Support to build both static and shared libraries
    • +
  • Issue #596 - QA Notice: Package triggers severe warnings
    • +
  • Issue #597 - json_parse demo: fix and use usage() function
    • +
  • Issue #598 - Turning off shared libs causes target duplication or build error
    • +
  • Issue #599 - cannot add more than 11 objects. Is this a known issue?
    • +
  • Issue #600 - Library name conflicts on Windows are back again
    • +
  • Issue #601 - json_tokener_parse() in master sets errno=1 "Operation not permitted"
    • +
  • Issue #602 - fix json_parse_uint64() internal error checking with errno
    • +
  • Issue #603 - Backport of fixes from master branch.
    • +
  • Issue #604 - commit f2e991a3419ee4078e8915e840b1a0d9003b349e breaks cross-compilation with mingw
    • +
  • Issue #605 - Update to 0.15 release
    • +
  • Issue #606 - Improved support for IBM operating systems
    • +
  • Issue #607 - json-c-0.13.x: Fix CVE-2020-12762 - json-c through 0.14 has an integer overflow and out-of-bounds write ...
    • +
  • Issue #608 - json-c-0.14: Fix CVE-2020-12762 - json-c through 0.14 has an integer overflow and out-of-bounds write ...
    • +
  • Issue #609 - use unsigned types for sizes in lh_table and entries
    • +
  • Issue #610 - let's not call lh_table_resize with INT_MAX
    • +
  • Issue #611 - json-c-0.12.x: Fix CVE-2020-12762 - json-c through 0.14 has an integer overflow and out-of-bounds write ...
    • +
  • Issue #613 - json-c-0.10: Fix CVE-2020-12762 - json-c through 0.14 has an integer overflow and out-of-bounds write ...
    • +
  • Issue #614 - Prevent truncation on custom double formatters.
    • +
  • Issue #615 - New release with security fix
    • +
  • Issue #616 - Parsing fails if UTF-16 low surrogate pair is not in same chunk is the high pair
    • +
  • Issue #617 - Add an option to disable the use of thread-local storage.
    • +
  • Issue #618 - test_deep_copy: Fix assertion value.
    • +
  • Issue #619 - CMake: Fix out-of-tree build for Doxygen documentation.
    • +
  • Issue #621 - json-c and jansson libraries have symbol conflicts
    • +
  • Issue #622 - doc: Move Doxyfile into doc subdir.
    • +
  • Issue #623 - json_tokener_parse : Segmentation fault
    • +
  • Issue #626 - Fixes for cmake 2.8.12 + link issue on AIX 6.1/cc 11.01
    • +
  • Issue #627 - Compat fixes
    • +
  • Issue #628 - get_cryptgenrandom_seed: compat with old windows + fallback
    • +
  • Issue #629 - [0.12] Remove the Visual Studio project file
    • +
  • Issue #630 - Linking with Windows MINGW not working
    • +
  • Issue #632 - Json object split
    • +
  • Issue #633 - fix issue 616: support the surrogate pair in split file.
    • +
  • Issue #634 - Issue #508: -fPIC to link libjson-c.a with libs
    • +
  • Issue #635 - expression has no effect warning in json_tokener.c
    • +
  • Issue #636 - json_object_get_string free str memory
    • +
  • Issue #637 - json_object_put() has 'double free or corruption (out) '
    • +
  • Issue #638 - json-c/json_object.c:50:2: error: #error Unable to determine size of ssize_t
    • +
  • Issue #639 - build: Add a symbol version to all exported symbols
    • +
  • Issue #640 - Fix build issues with SSIZE_MAX on 64bit Linux
    • +
  • Issue #641 - Formal verification of your test suite
    • +
  • Issue #642 - Please provide more precise informations about when to call json_object_put
    • +
  • Issue #643 - not able to compare with string
    • +
  • Issue #644 - Why src->_userdata not checked before calling strdup?
    • +
  • Issue #645 - Misuse of tolower() in json_tokener.c
    • +
  • Issue #646 - Cast to unsigned char instead of int when calling tolower (Fixes #645)
    • +
+

This list was created with:

+
PREV=2020-07-23
+NOW=2022-04-13
+curl "https://api.github.com/search/issues?q=repo%3Ajson-c%2Fjson-c+closed%3A>${PREV}+created%3A<${NOW}&sort=created&order=asc&per_page=100&page=1" > issues1.out
+jq -r '.items[] | "[" + .title + "](" + .url + ")" | tostring' issues?.out > issues.md
+sed -e's,^\[ *\(.*\)\](https://api.github.com/.*/\([0-9].*\)),* [Issue #\2](https://github.com/json-c/json-c/issues/\2) - \1,' -i issues.md
+cat issues.md >> issues_closed_for_0.16.md
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/nav_f.png b/doc/html/nav_f.png new file mode 100644 index 0000000..72a58a5 Binary files /dev/null and b/doc/html/nav_f.png differ diff --git a/doc/html/nav_g.png b/doc/html/nav_g.png new file mode 100644 index 0000000..2093a23 Binary files /dev/null and b/doc/html/nav_g.png differ diff --git a/doc/html/nav_h.png b/doc/html/nav_h.png new file mode 100644 index 0000000..33389b1 Binary files /dev/null and b/doc/html/nav_h.png differ diff --git a/doc/html/open.png b/doc/html/open.png new file mode 100644 index 0000000..30f75c7 Binary files /dev/null and b/doc/html/open.png differ diff --git a/doc/html/pages.html b/doc/html/pages.html new file mode 100644 index 0000000..83fb122 --- /dev/null +++ b/doc/html/pages.html @@ -0,0 +1,58 @@ + + + + + +json-c: Related Pages + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + +
+
+
+
Related Pages
+
+
+
Here is a list of all related documentation pages:
+ + + + +
oissues_closed_for_0
oREADME
\Deprecated List
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/printbuf_8h.html b/doc/html/printbuf_8h.html new file mode 100644 index 0000000..1b496f4 --- /dev/null +++ b/doc/html/printbuf_8h.html @@ -0,0 +1,384 @@ + + + + + +json-c: printbuf.h File Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Structures | +Macros | +Typedefs | +Functions
+
+
printbuf.h File Reference
+
+
+ +

Internal string buffer handling. Unless you're writing a json_object_to_json_string_fn implementation for use with json_object_set_serializer() direct use of this is not recommended. +More...

+ + + + +

+Data Structures

struct  printbuf
 
+ + + + + + + + + +

+Macros

#define JSON_EXPORT   extern
 
#define printbuf_memappend_fast(p, bufptr, bufsize)
 
#define printbuf_length(p)   ((p)->bpos)
 
#define printbuf_strappend(pb, str)   printbuf_memappend((pb), _printbuf_check_literal(str), sizeof(str) - 1)
 
+ + + +

+Typedefs

typedef struct printbuf printbuf
 
+ + + + + + + + + + + + + +

+Functions

JSON_EXPORT struct printbuf * printbuf_new (void)
 
JSON_EXPORT int printbuf_memappend (struct printbuf *p, const char *buf, int size)
 
JSON_EXPORT int printbuf_memset (struct printbuf *pb, int offset, int charvalue, int len)
 
JSON_EXPORT int sprintbuf (struct printbuf *p, const char *msg,...)
 
JSON_EXPORT void printbuf_reset (struct printbuf *p)
 
JSON_EXPORT void printbuf_free (struct printbuf *p)
 
+

Detailed Description

+

Internal string buffer handling. Unless you're writing a json_object_to_json_string_fn implementation for use with json_object_set_serializer() direct use of this is not recommended.

+

Macro Definition Documentation

+ +
+
+ + + + +
#define JSON_EXPORT   extern
+
+ +
+
+ +
+
+ + + + + + + + +
#define printbuf_length( p)   ((p)->bpos)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
#define printbuf_memappend_fast( p,
 bufptr,
 bufsize 
)
+
+Value:
do \
+
{ \
+
if ((p->size - p->bpos) > bufsize) \
+
{ \
+
memcpy(p->buf + p->bpos, (bufptr), bufsize); \
+
p->bpos += bufsize; \
+
p->buf[p->bpos] = '\0'; \
+
} \
+
else \
+
{ \
+
printbuf_memappend(p, (bufptr), bufsize); \
+
} \
+
} while (0)
+
+
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
#define printbuf_strappend( pb,
 str 
)   printbuf_memappend((pb), _printbuf_check_literal(str), sizeof(str) - 1)
+
+

This is an optimization wrapper around printbuf_memappend() that is useful for appending string literals. Since the size of string constants is known at compile time, using this macro can avoid a costly strlen() call. This is especially helpful when a constant string must be appended many times. If you got here because of a compilation error caused by passing something other than a string literal, use printbuf_memappend_fast() in conjunction with strlen().

+

See also: printbuf_memappend_fast() printbuf_memappend() sprintbuf()

+ +
+
+

Typedef Documentation

+ +
+
+ + + + +
typedef struct printbuf printbuf
+
+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + +
JSON_EXPORT void printbuf_free (struct printbuf * p)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int printbuf_memappend (struct printbuf * p,
const char * buf,
int size 
)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int printbuf_memset (struct printbuf * pb,
int offset,
int charvalue,
int len 
)
+
+

Set len bytes of the buffer to charvalue, starting at offset offset. Similar to calling memset(x, charvalue, len);

+

The memory allocated for the buffer is extended as necessary.

+

If offset is -1, this starts at the end of the current data in the buffer.

+ +
+
+ +
+
+ + + + + +
+ + + + + + + + +
JSON_EXPORT struct printbuf* printbuf_new (void )
+ 		+read
+
+ +
+
+ +
+
+ + + + + + + + +
JSON_EXPORT void printbuf_reset (struct printbuf * p)
+
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
JSON_EXPORT int sprintbuf (struct printbuf * p,
const char * msg,
 ... 
)
+
+

Formatted print to printbuf.

+

This function is the most expensive of the available functions for appending string data to a printbuf and should be used only where convenience is more important than speed. Avoid using this function in high performance code or tight loops; in these scenarios, consider using snprintf() with a static buffer in conjunction with one of the printbuf_*append() functions.

+

See also: printbuf_memappend_fast() printbuf_memappend() printbuf_strappend()

+ +
+
+
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structarray__list.html b/doc/html/structarray__list.html new file mode 100644 index 0000000..ef75d74 --- /dev/null +++ b/doc/html/structarray__list.html @@ -0,0 +1,123 @@ + + + + + +json-c: array_list Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
array_list Struct Reference
+
+
+ + + + + + + + + + +

+Data Fields

void ** array
 
size_t length
 
size_t size
 
array_list_free_fn * free_fn
 
+

Field Documentation

+ +
+
+ + + + +
void** array_list::array
+
+ +
+
+ +
+
+ + + + +
array_list_free_fn* array_list::free_fn
+
+ +
+
+ +
+
+ + + + +
size_t array_list::length
+
+ +
+
+ +
+
+ + + + +
size_t array_list::size
+
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structjson__object__iter.html b/doc/html/structjson__object__iter.html new file mode 100644 index 0000000..7783fc7 --- /dev/null +++ b/doc/html/structjson__object__iter.html @@ -0,0 +1,111 @@ + + + + + +json-c: json_object_iter Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
json_object_iter Struct Reference
+
+
+ + + + + + + + +

+Data Fields

char * key
 
struct json_object * val
 
struct lh_entry * entry
 
+

Detailed Description

+

A structure to use with json_object_object_foreachC() loops. Contains key, val and entry members.

+

Field Documentation

+ +
+
+ + + + +
struct lh_entry* json_object_iter::entry
+
+ +
+
+ +
+
+ + + + +
char* json_object_iter::key
+
+ +
+
+ +
+
+ + + + +
struct json_object* json_object_iter::val
+
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structjson__object__iterator.html b/doc/html/structjson__object__iterator.html new file mode 100644 index 0000000..6784fcc --- /dev/null +++ b/doc/html/structjson__object__iterator.html @@ -0,0 +1,83 @@ + + + + + +json-c: json_object_iterator Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
json_object_iterator Struct Reference
+
+
+ + + + +

+Data Fields

const void * opaque_
 
+

Detailed Description

+

The opaque iterator that references a name/value pair within a JSON Object instance or the "end" iterator value.

+

Field Documentation

+ +
+
+ + + + +
const void* json_object_iterator::opaque_
+
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structjson__tokener.html b/doc/html/structjson__tokener.html new file mode 100644 index 0000000..9d55b8e --- /dev/null +++ b/doc/html/structjson__tokener.html @@ -0,0 +1,254 @@ + + + + + +json-c: json_tokener Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
json_tokener Struct Reference
+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Data Fields

char * str
 
struct printbuf * pb
 
int max_depth
 
int depth
 
int is_double
 
int st_pos
 
int char_offset
 
enum json_tokener_error err
 
unsigned int ucs_char
 
unsigned int high_surrogate
 
char quote_char
 
struct json_tokener_srec * stack
 
int flags
 
+

Detailed Description

+

Internal state of the json parser. Do not access any fields of this structure directly. Its definition is published due to historical limitations in the json tokener API, and will be changed to be an opaque type in the future.

+

Field Documentation

+ +
+
+ + + + +
int json_tokener::char_offset
+
+
Deprecated:
See json_tokener_get_parse_end() instead.
+ +
+
+ +
+
+ + + + +
int json_tokener::depth
+
+ +
+
+ +
+
+ + + + +
enum json_tokener_error json_tokener::err
+
+
Deprecated:
See json_tokener_get_error() instead.
+ +
+
+ +
+
+ + + + +
int json_tokener::flags
+
+ +
+
+ +
+
+ + + + +
unsigned int json_tokener::high_surrogate
+
+ +
+
+ +
+
+ + + + +
int json_tokener::is_double
+
+ +
+
+ +
+
+ + + + +
int json_tokener::max_depth
+
+ +
+
+ +
+
+ + + + +
struct printbuf* json_tokener::pb
+
+ +
+
+ +
+
+ + + + +
char json_tokener::quote_char
+
+ +
+
+ +
+
+ + + + +
int json_tokener::st_pos
+
+ +
+
+ +
+
+ + + + +
struct json_tokener_srec* json_tokener::stack
+
+ +
+
+ +
+
+ + + + +
char* json_tokener::str
+
+
Deprecated:
Do not access any of these fields outside of json_tokener.c
+ +
+
+ +
+
+ + + + +
unsigned int json_tokener::ucs_char
+
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structjson__tokener__srec.html b/doc/html/structjson__tokener__srec.html new file mode 100644 index 0000000..a85c491 --- /dev/null +++ b/doc/html/structjson__tokener__srec.html @@ -0,0 +1,125 @@ + + + + + +json-c: json_tokener_srec Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
json_tokener_srec Struct Reference
+
+
+ + + + + + + + + + +

+Data Fields

enum json_tokener_state state saved_state
 
struct json_object * obj
 
struct json_object * current
 
char * obj_field_name
 
+

Detailed Description

+
Deprecated:
Don't use this outside of json_tokener.c, it will be made private in a future release.
+

Field Documentation

+ +
+
+ + + + +
struct json_object* json_tokener_srec::current
+
+ +
+
+ +
+
+ + + + +
struct json_object* json_tokener_srec::obj
+
+ +
+
+ +
+
+ + + + +
char* json_tokener_srec::obj_field_name
+
+ +
+
+ +
+
+ + + + +
enum json_tokener_state state json_tokener_srec::saved_state
+
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structlh__entry.html b/doc/html/structlh__entry.html new file mode 100644 index 0000000..b8235b3 --- /dev/null +++ b/doc/html/structlh__entry.html @@ -0,0 +1,159 @@ + + + + + +json-c: lh_entry Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
lh_entry Struct Reference
+
+
+ + + + + + + + + + + + +

+Data Fields

const void * k
 
int k_is_constant
 
const void * v
 
struct lh_entry * next
 
struct lh_entry * prev
 
+

Detailed Description

+

An entry in the hash table. Outside of linkhash.c, treat this as opaque.

+

Field Documentation

+ +
+
+ + + + +
const void* lh_entry::k
+
+

The key.

+
Deprecated:
Use lh_entry_k() instead of accessing this directly.
+ +

Referenced by lh_entry_k().

+ +
+
+ +
+
+ + + + +
int lh_entry::k_is_constant
+
+

A flag for users of linkhash to know whether or not they need to free k.

+
Deprecated:
use lh_entry_k_is_constant() instead.
+ +

Referenced by lh_entry_k_is_constant().

+ +
+
+ +
+
+ + + + +
struct lh_entry* lh_entry::next
+
+

The next entry.

+
Deprecated:
Use lh_entry_next() instead of accessing this directly.
+ +

Referenced by lh_entry_next().

+ +
+
+ +
+
+ + + + +
struct lh_entry* lh_entry::prev
+
+

The previous entry.

+
Deprecated:
Use lh_entry_prev() instead of accessing this directly.
+ +

Referenced by lh_entry_prev().

+ +
+
+ +
+
+ + + + +
const void* lh_entry::v
+
+

The value.

+
Deprecated:
Use lh_entry_v() instead of accessing this directly.
+ +

Referenced by lh_entry_set_val(), and lh_entry_v().

+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structlh__table.html b/doc/html/structlh__table.html new file mode 100644 index 0000000..448d42b --- /dev/null +++ b/doc/html/structlh__table.html @@ -0,0 +1,199 @@ + + + + + +json-c: lh_table Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
lh_table Struct Reference
+
+
+ + + + + + + + + + + + + + + + + + +

+Data Fields

int size
 
int count
 
struct lh_entry * head
 
struct lh_entry * tail
 
struct lh_entry * table
 
lh_entry_free_fn * free_fn
 
lh_hash_fn * hash_fn
 
lh_equal_fn * equal_fn
 
+

Detailed Description

+

The hash table structure. Outside of linkhash.c, treat this as opaque.

+

Field Documentation

+ +
+
+ + + + +
int lh_table::count
+
+

Numbers of entries.

+
Deprecated:
Use lh_table_length() instead.
+ +
+
+ +
+
+ + + + +
lh_equal_fn* lh_table::equal_fn
+
+
Deprecated:
do not use outside of linkhash.c
+ +
+
+ +
+
+ + + + +
lh_entry_free_fn* lh_table::free_fn
+
+

A pointer to the function responsible for freeing an entry.

+
Deprecated:
do not use outside of linkhash.c
+ +
+
+ +
+
+ + + + +
lh_hash_fn* lh_table::hash_fn
+
+
Deprecated:
do not use outside of linkhash.c
+ +

Referenced by lh_get_hash().

+ +
+
+ +
+
+ + + + +
struct lh_entry* lh_table::head
+
+

The first entry.

+
Deprecated:
Use lh_table_head() instead.
+ +

Referenced by lh_table_head().

+ +
+
+ +
+
+ + + + +
int lh_table::size
+
+

Size of our hash.

+
Deprecated:
do not use outside of linkhash.c
+ +
+
+ +
+
+ + + + +
struct lh_entry* lh_table::table
+
+

Internal storage of the actual table of entries.

+
Deprecated:
do not use outside of linkhash.c
+ +
+
+ +
+
+ + + + +
struct lh_entry* lh_table::tail
+
+

The last entry.

+
Deprecated:
Do not use, may be removed in a future release.
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/structprintbuf.html b/doc/html/structprintbuf.html new file mode 100644 index 0000000..bf133b6 --- /dev/null +++ b/doc/html/structprintbuf.html @@ -0,0 +1,109 @@ + + + + + +json-c: printbuf Struct Reference + + + + + + +
+
+ + + + + + +
+
json-c +  0.16 +
+
+
+ + + + +
+
+
+Data Fields
+
+
printbuf Struct Reference
+
+
+ + + + + + + + +

+Data Fields

char * buf
 
int bpos
 
int size
 
+

Field Documentation

+ +
+
+ + + + +
int printbuf::bpos
+
+ +
+
+ +
+
+ + + + +
char* printbuf::buf
+
+ +
+
+ +
+
+ + + + +
int printbuf::size
+
+ +
+
+
The documentation for this struct was generated from the following file: +
+ +
+Generated on Thu Apr 14 2022 01:11:24 for json-c by   +doxygen + 1.8.2 +
+ + diff --git a/doc/html/sync_off.png b/doc/html/sync_off.png new file mode 100644 index 0000000..3b443fc Binary files /dev/null and b/doc/html/sync_off.png differ diff --git a/doc/html/sync_on.png b/doc/html/sync_on.png new file mode 100644 index 0000000..e08320f Binary files /dev/null and b/doc/html/sync_on.png differ diff --git a/doc/html/tab_a.png b/doc/html/tab_a.png new file mode 100644 index 0000000..3b725c4 Binary files /dev/null and b/doc/html/tab_a.png differ diff --git a/doc/html/tab_b.png b/doc/html/tab_b.png new file mode 100644 index 0000000..5f6601a Binary files /dev/null and b/doc/html/tab_b.png differ diff --git a/doc/html/tab_h.png b/doc/html/tab_h.png new file mode 100644 index 0000000..fd5cb70 Binary files /dev/null and b/doc/html/tab_h.png differ diff --git a/doc/html/tab_s.png b/doc/html/tab_s.png new file mode 100644 index 0000000..ab478c9 Binary files /dev/null and b/doc/html/tab_s.png differ diff --git a/doc/html/tabs.css b/doc/html/tabs.css new file mode 100644 index 0000000..9cf578f --- /dev/null +++ b/doc/html/tabs.css @@ -0,0 +1,60 @@ +.tabs, .tabs2, .tabs3 { + background-image: url('tab_b.png'); + width: 100%; + z-index: 101; + font-size: 13px; + font-family: 'Lucida Grande',Geneva,Helvetica,Arial,sans-serif; +} + +.tabs2 { + font-size: 10px; +} +.tabs3 { + font-size: 9px; +} + +.tablist { + margin: 0; + padding: 0; + display: table; +} + +.tablist li { + float: left; + display: table-cell; + background-image: url('tab_b.png'); + line-height: 36px; + list-style: none; +} + +.tablist a { + display: block; + padding: 0 20px; + font-weight: bold; + background-image:url('tab_s.png'); + background-repeat:no-repeat; + background-position:right; + color: #283A5D; + text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9); + text-decoration: none; + outline: none; +} + +.tabs3 .tablist a { + padding: 0 10px; +} + +.tablist a:hover { + background-image: url('tab_h.png'); + background-repeat:repeat-x; + color: #fff; + text-shadow: 0px 1px 1px rgba(0, 0, 0, 1.0); + text-decoration: none; +} + +.tablist li.current a { + background-image: url('tab_a.png'); + background-repeat:repeat-x; + color: #fff; + text-shadow: 0px 1px 1px rgba(0, 0, 0, 1.0); +}