xs.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769
  1. /* copyright (c) 2022 grunfink - MIT license */
  2. #ifndef _XS_H
  3. #define _XS_H
  4. #include <stdio.h>
  5. #include <string.h>
  6. #include <stdlib.h>
  7. #include <ctype.h>
  8. #include <unistd.h>
  9. #include <stdarg.h>
  10. #include <signal.h>
  11. #include <errno.h>
  12. typedef enum {
  13. XSTYPE_NULL = 0x18,
  14. XSTYPE_TRUE = 0x06,
  15. XSTYPE_FALSE = 0x15,
  16. XSTYPE_LIST = 0x11,
  17. XSTYPE_LITEM = 0x1f,
  18. XSTYPE_EOL = 0x12,
  19. XSTYPE_DICT = 0x13,
  20. XSTYPE_DITEM = 0x1e,
  21. XSTYPE_EOD = 0x14,
  22. XSTYPE_NUMBER = 0x17,
  23. XSTYPE_STRING = 0x02
  24. } xstype;
  25. /* dynamic strings */
  26. typedef char d_char;
  27. /* auto-destroyable strings */
  28. #define xs __attribute__ ((__cleanup__ (_xs_destroy))) d_char
  29. int _xs_blk_size(int sz);
  30. void _xs_destroy(char **var);
  31. #define xs_debug() raise(SIGTRAP)
  32. xstype xs_type(const char *data);
  33. int xs_size(const char *data);
  34. int xs_is_null(const char *data);
  35. d_char *xs_dup(const char *data);
  36. void *xs_realloc(void *ptr, size_t size);
  37. d_char *xs_expand(d_char *data, int offset, int size);
  38. d_char *xs_collapse(d_char *data, int offset, int size);
  39. d_char *xs_insert_m(d_char *data, int offset, const char *mem, int size);
  40. #define xs_insert(data, offset, data2) xs_insert_m(data, offset, data2, xs_size(data2))
  41. #define xs_append_m(data, mem, size) xs_insert_m(data, xs_size(data) - 1, mem, size)
  42. d_char *xs_str_new(const char *str);
  43. #define xs_str_cat(str1, str2) xs_insert(str1, xs_size(str1) - 1, str2)
  44. d_char *xs_replace_i(d_char *str, const char *sfrom, const char *sto);
  45. #define xs_replace(str, sfrom, sto) xs_replace_i(xs_dup(str), sfrom, sto)
  46. d_char *xs_fmt(const char *fmt, ...);
  47. int xs_str_in(const char *haystack, const char *needle);
  48. int xs_startswith(const char *str, const char *prefix);
  49. int xs_endswith(const char *str, const char *postfix);
  50. d_char *xs_crop(d_char *str, int start, int end);
  51. d_char *xs_strip(d_char *str);
  52. d_char *xs_tolower(d_char *str);
  53. d_char *xs_list_new(void);
  54. d_char *xs_list_append_m(d_char *list, const char *mem, int dsz);
  55. #define xs_list_append(list, data) xs_list_append_m(list, data, xs_size(data))
  56. int xs_list_iter(char **list, char **value);
  57. int xs_list_len(char *list);
  58. char *xs_list_get(char *list, int num);
  59. int xs_list_in(char *list, char *val);
  60. d_char *xs_join(char *list, const char *sep);
  61. d_char *xs_split_n(const char *str, const char *sep, int times);
  62. #define xs_split(str, sep) xs_split_n(str, sep, 0xfffffff)
  63. d_char *xs_dict_new(void);
  64. d_char *xs_dict_append_m(d_char *dict, const char *key, const char *mem, int dsz);
  65. #define xs_dict_append(dict, key, data) xs_dict_append_m(dict, key, data, xs_size(data))
  66. int xs_dict_iter(char **dict, char **key, char **value);
  67. char *xs_dict_get(char *dict, const char *key);
  68. d_char *xs_dict_del(d_char *dict, const char *key);
  69. d_char *xs_dict_set(d_char *dict, const char *key, const char *data);
  70. d_char *xs_val_new(xstype t);
  71. d_char *xs_number_new(double f);
  72. double xs_number_get(const char *v);
  73. const char *xs_number_str(const char *v);
  74. extern int _xs_debug;
  75. #ifdef XS_IMPLEMENTATION
  76. int _xs_debug = 0;
  77. void _xs_destroy(char **var)
  78. {
  79. if (_xs_debug)
  80. printf("_xs_destroy %p\n", var);
  81. free(*var);
  82. }
  83. int _xs_blk_size(int sz)
  84. /* calculates the block size */
  85. {
  86. int blk_size = 4096;
  87. if (sz < 256)
  88. blk_size = 32;
  89. else
  90. if (sz < 4096)
  91. blk_size = 256;
  92. return ((((sz) + blk_size) / blk_size) * blk_size);
  93. }
  94. xstype xs_type(const char *data)
  95. /* return the type of data */
  96. {
  97. xstype t;
  98. switch (data[0]) {
  99. case XSTYPE_NULL:
  100. case XSTYPE_TRUE:
  101. case XSTYPE_FALSE:
  102. case XSTYPE_LIST:
  103. case XSTYPE_EOL:
  104. case XSTYPE_DICT:
  105. case XSTYPE_EOD:
  106. case XSTYPE_LITEM:
  107. case XSTYPE_DITEM:
  108. case XSTYPE_NUMBER:
  109. t = data[0];
  110. break;
  111. default:
  112. t = XSTYPE_STRING;
  113. break;
  114. }
  115. return t;
  116. }
  117. int xs_size(const char *data)
  118. /* returns the size of data in bytes */
  119. {
  120. int len = 0;
  121. int c = 0;
  122. const char *p;
  123. if (data == NULL)
  124. return 0;
  125. switch (xs_type(data)) {
  126. case XSTYPE_STRING:
  127. len = strlen(data) + 1;
  128. break;
  129. case XSTYPE_LIST:
  130. /* look for a balanced EOL */
  131. do {
  132. c += data[len] == XSTYPE_LIST ? 1 : data[len] == XSTYPE_EOL ? -1 : 0;
  133. len++;
  134. } while (c);
  135. break;
  136. case XSTYPE_DICT:
  137. /* look for a balanced EOD */
  138. do {
  139. c += data[len] == XSTYPE_DICT ? 1 : data[len] == XSTYPE_EOD ? -1 : 0;
  140. len++;
  141. } while (c);
  142. break;
  143. case XSTYPE_DITEM:
  144. /* calculate the size of the key and the value */
  145. p = data + 1;
  146. p += xs_size(p);
  147. p += xs_size(p);
  148. len = p - data;
  149. break;
  150. case XSTYPE_LITEM:
  151. /* it's the size of the item + 1 */
  152. p = data + 1;
  153. p += xs_size(p);
  154. len = p - data;
  155. break;
  156. case XSTYPE_NUMBER:
  157. len = 1 + xs_size(data + 1);
  158. break;
  159. default:
  160. len = 1;
  161. }
  162. return len;
  163. }
  164. int xs_is_null(const char *data)
  165. /* checks for null */
  166. {
  167. return !!(data == NULL || xs_type(data) == XSTYPE_NULL);
  168. }
  169. d_char *xs_dup(const char *data)
  170. /* creates a duplicate of data */
  171. {
  172. int sz = xs_size(data);
  173. d_char *s = xs_realloc(NULL, _xs_blk_size(sz));
  174. memcpy(s, data, sz);
  175. return s;
  176. }
  177. void *xs_realloc(void *ptr, size_t size)
  178. {
  179. d_char *ndata = realloc(ptr, size);
  180. if (ndata == NULL) {
  181. fprintf(stderr, "**OUT OF MEMORY**\n");
  182. abort();
  183. }
  184. return ndata;
  185. }
  186. d_char *xs_expand(d_char *data, int offset, int size)
  187. /* opens a hole in data */
  188. {
  189. int sz = xs_size(data);
  190. /* open room */
  191. if (sz == 0 || _xs_blk_size(sz) != _xs_blk_size(sz + size))
  192. data = xs_realloc(data, _xs_blk_size(sz + size));
  193. /* move up the rest of the data */
  194. if (data != NULL)
  195. memmove(data + offset + size, data + offset, sz - offset);
  196. return data;
  197. }
  198. d_char *xs_collapse(d_char *data, int offset, int size)
  199. /* shrinks data */
  200. {
  201. int sz = xs_size(data);
  202. int n;
  203. /* don't try to delete beyond the limit */
  204. if (offset + size > sz)
  205. size = sz - offset;
  206. /* shrink total size */
  207. sz -= size;
  208. for (n = offset; n < sz; n++)
  209. data[n] = data[n + size];
  210. return xs_realloc(data, _xs_blk_size(sz));
  211. }
  212. d_char *xs_insert_m(d_char *data, int offset, const char *mem, int size)
  213. /* inserts a memory block */
  214. {
  215. data = xs_expand(data, offset, size);
  216. memcpy(data + offset, mem, size);
  217. return data;
  218. }
  219. /** strings **/
  220. d_char *xs_str_new(const char *str)
  221. /* creates a new string */
  222. {
  223. return xs_insert(NULL, 0, str ? str : "");
  224. }
  225. d_char *xs_replace_i(d_char *str, const char *sfrom, const char *sto)
  226. /* replaces inline all sfrom with sto */
  227. {
  228. int sfsz = strlen(sfrom);
  229. int stsz = strlen(sto);
  230. char *ss;
  231. int offset = 0;
  232. while ((ss = strstr(str + offset, sfrom)) != NULL) {
  233. int n_offset = ss - str;
  234. str = xs_collapse(str, n_offset, sfsz);
  235. str = xs_expand(str, n_offset, stsz);
  236. memcpy(str + n_offset, sto, stsz);
  237. offset = n_offset + stsz;
  238. }
  239. return str;
  240. }
  241. d_char *xs_fmt(const char *fmt, ...)
  242. /* formats a string with printf()-like marks */
  243. {
  244. int n;
  245. d_char *s = NULL;
  246. va_list ap;
  247. va_start(ap, fmt);
  248. n = vsnprintf(s, 0, fmt, ap);
  249. va_end(ap);
  250. if (n > 0) {
  251. n = _xs_blk_size(n + 1);
  252. s = calloc(n, 1);
  253. va_start(ap, fmt);
  254. vsnprintf(s, n, fmt, ap);
  255. va_end(ap);
  256. }
  257. return s;
  258. }
  259. int xs_str_in(const char *haystack, const char *needle)
  260. /* finds needle in haystack and returns the offset or -1 */
  261. {
  262. char *s;
  263. int r = -1;
  264. if ((s = strstr(haystack, needle)) != NULL)
  265. r = s - haystack;
  266. return r;
  267. }
  268. int xs_startswith(const char *str, const char *prefix)
  269. /* returns true if str starts with prefix */
  270. {
  271. return !!(xs_str_in(str, prefix) == 0);
  272. }
  273. int xs_endswith(const char *str, const char *postfix)
  274. /* returns true if str ends with postfix */
  275. {
  276. int ssz = strlen(str);
  277. int psz = strlen(postfix);
  278. return !!(ssz >= psz && memcmp(postfix, str + ssz - psz, psz) == 0);
  279. }
  280. d_char *xs_crop(d_char *str, int start, int end)
  281. /* crops the d_char to be only from start to end */
  282. {
  283. int sz = strlen(str);
  284. if (end <= 0)
  285. end = sz + end;
  286. /* crop from the top */
  287. str[end] = '\0';
  288. /* crop from the bottom */
  289. str = xs_collapse(str, 0, start);
  290. return str;
  291. }
  292. d_char *xs_strip(d_char *str)
  293. /* strips the string of blanks from the start and the end */
  294. {
  295. int s, e;
  296. for (s = 0; isspace(str[s]); s++);
  297. for (e = strlen(str); e > 0 && isspace(str[e - 1]); e--);
  298. return xs_crop(str, s, e);
  299. }
  300. d_char *xs_tolower(d_char *str)
  301. /* convert to lowercase */
  302. {
  303. int n;
  304. for (n = 0; str[n]; n++)
  305. str[n] = tolower(str[n]);
  306. return str;
  307. }
  308. /** lists **/
  309. d_char *xs_list_new(void)
  310. /* creates a new list */
  311. {
  312. d_char *list;
  313. list = xs_realloc(NULL, _xs_blk_size(2));
  314. list[0] = XSTYPE_LIST;
  315. list[1] = XSTYPE_EOL;
  316. return list;
  317. }
  318. d_char *xs_list_append_m(d_char *list, const char *mem, int dsz)
  319. /* adds a memory block to the list */
  320. {
  321. char c = XSTYPE_LITEM;
  322. int lsz = xs_size(list);
  323. list = xs_insert_m(list, lsz - 1, &c, 1);
  324. list = xs_insert_m(list, lsz, mem, dsz);
  325. return list;
  326. }
  327. int xs_list_iter(char **list, char **value)
  328. /* iterates a list value */
  329. {
  330. int goon = 1;
  331. char *p;
  332. if (list == NULL || *list == NULL)
  333. return 0;
  334. p = *list;
  335. /* skip a possible start of the list */
  336. if (*p == XSTYPE_LIST)
  337. p++;
  338. /* an element? */
  339. if (*p == XSTYPE_LITEM) {
  340. p++;
  341. *value = p;
  342. p += xs_size(*value);
  343. }
  344. else {
  345. /* end of list */
  346. p++;
  347. goon = 0;
  348. }
  349. /* store back the pointer */
  350. *list = p;
  351. return goon;
  352. }
  353. int xs_list_len(char *list)
  354. /* returns the number of elements in the list */
  355. {
  356. int c = 0;
  357. char *v;
  358. while (xs_list_iter(&list, &v))
  359. c++;
  360. return c;
  361. }
  362. char *xs_list_get(char *list, int num)
  363. /* returns the element #num */
  364. {
  365. char *v;
  366. int c = 0;
  367. if (num < 0)
  368. num = xs_list_len(list) + num;
  369. while (xs_list_iter(&list, &v)) {
  370. if (c == num)
  371. return v;
  372. c++;
  373. }
  374. return NULL;
  375. }
  376. int xs_list_in(char *list, char *val)
  377. /* returns the position of val in list or -1 */
  378. {
  379. int n = 0;
  380. char *v;
  381. int sz = xs_size(val);
  382. while (xs_list_iter(&list, &v)) {
  383. if (sz == xs_size(v) && memcmp(val, v, sz) == 0)
  384. return n;
  385. n++;
  386. }
  387. return -1;
  388. }
  389. d_char *xs_join(char *list, const char *sep)
  390. /* joins a list into a string */
  391. {
  392. d_char *s;
  393. char *v;
  394. int c = 0;
  395. s = xs_str_new(NULL);
  396. while (xs_list_iter(&list, &v)) {
  397. /* refuse to join non-string values */
  398. if (xs_type(v) == XSTYPE_STRING) {
  399. /* add the separator */
  400. if (c != 0)
  401. s = xs_str_cat(s, sep);
  402. /* add the element */
  403. s = xs_str_cat(s, v);
  404. c++;
  405. }
  406. }
  407. return s;
  408. }
  409. d_char *xs_split_n(const char *str, const char *sep, int times)
  410. /* splits a string into a list upto n times */
  411. {
  412. int sz = strlen(sep);
  413. char *ss;
  414. d_char *list;
  415. list = xs_list_new();
  416. while (times > 0 && (ss = strstr(str, sep)) != NULL) {
  417. /* add the first part (without the asciiz) */
  418. list = xs_list_append_m(list, str, ss - str);
  419. /* add the asciiz */
  420. list = xs_str_cat(list, "");
  421. /* skip past the separator */
  422. str = ss + sz;
  423. times--;
  424. }
  425. /* add the rest of the string */
  426. list = xs_list_append(list, str);
  427. return list;
  428. }
  429. /** dicts **/
  430. d_char *xs_dict_new(void)
  431. /* creates a new dict */
  432. {
  433. d_char *dict;
  434. dict = xs_realloc(NULL, _xs_blk_size(2));
  435. dict[0] = XSTYPE_DICT;
  436. dict[1] = XSTYPE_EOD;
  437. return dict;
  438. }
  439. d_char *xs_dict_append_m(d_char *dict, const char *key, const char *mem, int dsz)
  440. /* adds a memory block to the dict */
  441. {
  442. char c = XSTYPE_DITEM;
  443. int sz = xs_size(dict);
  444. int ksz = xs_size(key);
  445. dict = xs_insert_m(dict, sz - 1, &c, 1);
  446. dict = xs_insert_m(dict, sz, key, ksz);
  447. dict = xs_insert_m(dict, sz + ksz, mem, dsz);
  448. return dict;
  449. }
  450. int xs_dict_iter(char **dict, char **key, char **value)
  451. /* iterates a dict value */
  452. {
  453. int goon = 1;
  454. char *p;
  455. if (dict == NULL || *dict == NULL)
  456. return 0;
  457. p = *dict;
  458. /* skip a possible start of the list */
  459. if (*p == XSTYPE_DICT)
  460. p++;
  461. /* an element? */
  462. if (*p == XSTYPE_DITEM) {
  463. p++;
  464. *key = p;
  465. p += xs_size(*key);
  466. *value = p;
  467. p += xs_size(*value);
  468. }
  469. else {
  470. /* end of list */
  471. p++;
  472. goon = 0;
  473. }
  474. /* store back the pointer */
  475. *dict = p;
  476. return goon;
  477. }
  478. char *xs_dict_get(char *dict, const char *key)
  479. /* returns the value directed by key */
  480. {
  481. char *k, *v;
  482. while (xs_dict_iter(&dict, &k, &v)) {
  483. if (strcmp(k, key) == 0)
  484. return v;
  485. }
  486. return NULL;
  487. }
  488. d_char *xs_dict_del(d_char *dict, const char *key)
  489. /* deletes a key */
  490. {
  491. char *k, *v;
  492. char *p = dict;
  493. while (xs_dict_iter(&p, &k, &v)) {
  494. if (strcmp(k, key) == 0) {
  495. /* the address of the item is just behind the key */
  496. char *i = k - 1;
  497. dict = xs_collapse(dict, i - dict, xs_size(i));
  498. break;
  499. }
  500. }
  501. return dict;
  502. }
  503. d_char *xs_dict_set(d_char *dict, const char *key, const char *data)
  504. /* sets (replaces) a key */
  505. {
  506. /* delete the possibly existing key */
  507. dict = xs_dict_del(dict, key);
  508. /* append the data */
  509. dict = xs_dict_append(dict, key, data);
  510. return dict;
  511. }
  512. /** other values **/
  513. d_char *xs_val_new(xstype t)
  514. /* adds a new special value */
  515. {
  516. d_char *v = xs_realloc(NULL, _xs_blk_size(1));
  517. v[0] = t;
  518. return v;
  519. }
  520. /** numbers */
  521. d_char *xs_number_new(double f)
  522. /* adds a new number value */
  523. {
  524. d_char *v;
  525. char tmp[64];
  526. snprintf(tmp, sizeof(tmp), "%.15lf", f);
  527. /* strip useless zeros */
  528. if (strchr(tmp, '.') != NULL) {
  529. char *ptr;
  530. for (ptr = tmp + strlen(tmp) - 1; *ptr == '0'; ptr--);
  531. if (*ptr != '.')
  532. ptr++;
  533. *ptr = '\0';
  534. }
  535. /* alloc for the marker and the full string */
  536. v = xs_realloc(NULL, _xs_blk_size(1 + xs_size(tmp)));
  537. v[0] = XSTYPE_NUMBER;
  538. memcpy(&v[1], tmp, xs_size(tmp));
  539. return v;
  540. }
  541. double xs_number_get(const char *v)
  542. /* gets the number as a double */
  543. {
  544. double f = 0.0;
  545. if (v != NULL && v[0] == XSTYPE_NUMBER)
  546. f = atof(&v[1]);
  547. return f;
  548. }
  549. const char *xs_number_str(const char *v)
  550. /* gets the number as a string */
  551. {
  552. const char *p = NULL;
  553. if (v != NULL && v[0] == XSTYPE_NUMBER)
  554. p = &v[1];
  555. return p;
  556. }
  557. #endif /* XS_IMPLEMENTATION */
  558. #endif /* _XS_H */