json.h 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226
  1. /*
  2. * File: json.h
  3. * Author: Arthur Brandao
  4. *
  5. * Created on 28 octobre 2018
  6. */
  7. #ifndef JSON_H
  8. #define JSON_H
  9. /* --- Include --- */
  10. #include "str.h"
  11. #include "constante.h"
  12. /* --- Constante --- */
  13. #define JSON_ERROR -1
  14. #define JSON_OK 0
  15. #define JSON_STRING 1
  16. #define JSON_NUMBER 2
  17. #define JSON_BOOLEAN 3
  18. #define JSON_ARRAY 4
  19. #define JSON_OBJECT 5
  20. /* --- Structure --- */
  21. typedef struct JsonNode JsonNode;
  22. typedef struct{
  23. char* str; //La chaine de carac json
  24. int elt; //Le nombre d'element
  25. char** key; //La position des clef dans la chaine
  26. char** val; //La position de la valeur
  27. int* key_length; //La taille des clefs
  28. int* val_length; //La taille des valeurs
  29. int* type; //Le type des valeurs
  30. }JsonParser;
  31. typedef struct{
  32. JsonNode* head;
  33. JsonNode* tail;
  34. int length;
  35. }JsonEncoder;
  36. struct JsonNode{
  37. JsonNode* prev;
  38. JsonNode* next;
  39. char* str;
  40. };
  41. /* --- Fonctions ---- */
  42. //JsonParser
  43. /**
  44. * Parse une chaine JSON en JsonParser
  45. * Initialise ou écrase les données du JsonParser
  46. * @param JsonParser* La structure de resultat (doit être alloué)
  47. * @param char* La chaine en JSON
  48. * @return int JSON_ERROR en cas d'erreur sinon JSON_OK
  49. */
  50. int json_parse(JsonParser*, char*);
  51. /**
  52. * Donne la clef à un index donné
  53. * @param JsonParser* Le resultat de json_parse
  54. * @param int La position à regarder
  55. * @return char* La clef
  56. */
  57. char* key_index(JsonParser*, int);
  58. /**
  59. * Donne la valeur à un index donné
  60. * @param JsonParser* Le resultat de json_parse
  61. * @param int La position à regarder
  62. * @return char* La valeur
  63. */
  64. char* get_index(JsonParser*, int);
  65. /**
  66. * Donne la positon d'une valeur dans le JsonParser
  67. * @param JsonParser* Le resultat de json_parse
  68. * @param char* La clef lié à la valeur
  69. * @return int La position
  70. */
  71. int get_pos(JsonParser*, char*);
  72. /**
  73. * Retourne le type de la vl=aleur
  74. * @param JsonParser* Le resultat de json_parse
  75. * @param char* La clef lié à la valeur
  76. * @return int constante JSON_XXXX du type de la valeur
  77. */
  78. int get_type(JsonParser*, char*);
  79. /**
  80. * Retourne la valeur d'un element
  81. * @param JsonParser* Le resultat de json_parse
  82. * @param char* La clef lié à la valeur
  83. * @return char* La valeur, NULL en cas d'erreur (clef introuvable)
  84. */
  85. char* get_value(JsonParser*, char*);
  86. /**
  87. * Retourne la valeur d'un element de type number
  88. * @param JsonParser* Le resultat de json_parse
  89. * @param char* La clef lié à la valeur
  90. * @return double La valeur, JSON_ERROR en cas d'erreur (type incorrect, clef introuvable)
  91. */
  92. double get_number(JsonParser*, char*);
  93. /**
  94. * Retourne la valeur d'un element de type number
  95. * @param JsonParser* Le resultat de json_parse
  96. * @param char* La clef lié à la valeur
  97. * @return int La valeur, JSON_ERROR en cas d'erreur (type incorrect, clef introuvable)
  98. */
  99. int get_integer(JsonParser*, char*);
  100. /**
  101. * Retourne la valeur d'un element de type boolean
  102. * @param JsonParser* Le resultat de json_parse
  103. * @param char* La clef lié à la valeur
  104. * @return boolean La valeur, false en cas d'erreur (type incorrect, clef introuvable)
  105. */
  106. boolean get_boolean(JsonParser*, char*);
  107. /**
  108. * Retourne la valeur d'un element de type array
  109. * @param JsonParser* Le resultat de json_parse
  110. * @param char* La clef lié à la valeur
  111. * @return char* La valeur, NULL en cas d'erreur (type incorrect, clef introuvable)
  112. */
  113. char* get_array(JsonParser*, char*);
  114. /**
  115. * Retourne la valeur d'un element de type object
  116. * @param JsonParser* Le resultat de json_parse
  117. * @param char* La clef lié à la valeur
  118. * @return JsonParser* L'object json analysé, NULL en cas d'erreur (type incorrect, clef introuvable, ...)
  119. */
  120. JsonParser* get_object(JsonParser*, char*);
  121. /**
  122. * Supprime un JsonParser
  123. * @param JsonParser* Le JsonParser à supprimer
  124. */
  125. void clean_json_parser(JsonParser*);
  126. //Json Encoder
  127. /**
  128. * Initialise le JsonEncoder
  129. * @param JsonEncoder* Le JsonEncoder à initialiser
  130. */
  131. void ini_encoder(JsonEncoder*);
  132. /**
  133. * Ajoute une valeur au JSON
  134. * @param JsonEncoder* La structure pour encoder
  135. * @param char* La chaine à ajouter (sous la forme "key": val)
  136. */
  137. void add_value(JsonEncoder*, char*);
  138. /**
  139. * Ajoute un string au JSON
  140. * @param JsonEncoder* La structure pour encoder
  141. * @param char* La clef pour acceder à la valeur
  142. * @param char* La valeur
  143. */
  144. void add_string(JsonEncoder*, char*, char*);
  145. /**
  146. * Ajoute un nombre au JSON
  147. * @param JsonEncoder* La structure pour encoder
  148. * @param char* La clef pour acceder à la valeur
  149. * @param double La valeur
  150. * @param int Le nombre de chiffre après la virgule
  151. */
  152. void add_number(JsonEncoder*, char*, double, int);
  153. /**
  154. * Ajoute un entier au JSON
  155. * @param JsonEncoder* La structure pour encoder
  156. * @param char* La clef pour acceder à la valeur
  157. * @param int La valeur
  158. */
  159. void add_integer(JsonEncoder*, char*, int);
  160. /**
  161. * Ajoute un boolean au JSON
  162. * @param JsonEncoder* La structure pour encoder
  163. * @param char* La clef pour acceder à la valeur
  164. * @param boolean La valeur
  165. */
  166. void add_boolean(JsonEncoder*, char*, boolean);
  167. /**
  168. * Ajoute un tableau au JSON
  169. * @param JsonEncoder* La structure pour encoder
  170. * @param char* La clef pour acceder à la valeur
  171. * @param char* La valeur
  172. */
  173. void add_array(JsonEncoder*, char*, char*);
  174. /**
  175. * Ajoute un objet JSON au JSON
  176. * @param JsonEncoder* La structure pour encoder
  177. * @param char* La clef pour acceder à la valeur
  178. * @param JsonEncoder La valeur
  179. */
  180. void add_object(JsonEncoder*, char*, JsonEncoder);
  181. /**
  182. * Transforma en chaine de caractère au format JSON
  183. * @param JsonEncoder* La structure pour encoder
  184. * @return char* La chaine au format JSON
  185. */
  186. char* json_encode(JsonEncoder*);
  187. /**
  188. * Supprime les données du JsonEncoder
  189. * Après cette méthode la structure peut directement être réutilisée
  190. * @param JsonEncoder* La structure à supprimer
  191. */
  192. void clean_json_encoder(JsonEncoder*);
  193. #endif /* JSON_H */