dtob-sys 0.1.1

Raw FFI bindings to the dtob C library (encoder + decoder).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

#ifndef DTOB_TYPES_H
#define DTOB_TYPES_H

#include "dtob.h"

/*
 * dtob_types.h — macros for defining custom type schemas without boilerplate.
 *
 * Usage:
 *
 *   DTOB_DEFINE_CUSTOM_TYPES(myapp, th,
 *       DTOB_CUSTOM_TYPE_RAW     (th, MY_NAME,   "name")
 *       DTOB_CUSTOM_TYPE_NULLABLE(th, MY_TRUE,   "true")
 *       DTOB_CUSTOM_TYPE_NULLABLE(th, MY_FALSE,  "false")
 *       DTOB_CUSTOM_TYPE_ENUM    (th, MY_BOOL,   "bool",   MY_TRUE, MY_FALSE)
 *       DTOB_CUSTOM_TYPE_UINT64  (th, MY_INODE,  "inode")
 *       DTOB_CUSTOM_TYPE_STRUCT  (th, MY_FILE,   "file",   MY_NAME, MY_INODE)
 *   )
 *
 * This expands to:
 *
 *   static void build_myapp_custom_types(DtobTypesHeader *th) {
 *       dtob_types_init(th);
 *       ...
 *   }
 */

/* generates: static void build_<name>_custom_types(DtobTypesHeader *th) { ... } */
#define DTOB_DEFINE_CUSTOM_TYPES(name, th, ...)                      \
    static void build_##name##_custom_types(DtobTypesHeader *th) {   \
        dtob_types_init(th);                                         \
        __VA_ARGS__                                                   \
    }

/* nullable — no data, used as a sentinel or flag value */
#define DTOB_CUSTOM_TYPE_NULLABLE(th, code, str) \
    dtob_types_add(th, code, str, NULL, 0);

/* raw bytes — inner data is uninterpreted */
#define DTOB_CUSTOM_TYPE_RAW(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_RAW}, 1);

/* signed integers */
#define DTOB_CUSTOM_TYPE_INT8(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_INT8}, 1);
#define DTOB_CUSTOM_TYPE_INT16(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_INT16}, 1);
#define DTOB_CUSTOM_TYPE_INT32(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_INT32}, 1);
#define DTOB_CUSTOM_TYPE_INT64(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_INT64}, 1);

/* unsigned integers */
#define DTOB_CUSTOM_TYPE_UINT8(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_UINT8}, 1);
#define DTOB_CUSTOM_TYPE_UINT16(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_UINT16}, 1);
#define DTOB_CUSTOM_TYPE_UINT32(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_UINT32}, 1);
#define DTOB_CUSTOM_TYPE_UINT64(th, code, str) \
    dtob_types_add(th, code, str, (uint16_t[]){DTOB_CODE_UINT64}, 1);

/* enum — inner_code must be one of the listed variant codes */
#define DTOB_CUSTOM_TYPE_ENUM(th, code, str, ...) \
    dtob_types_add(th, code, str,                 \
        (uint16_t[]){__VA_ARGS__},                \
        sizeof((uint16_t[]){__VA_ARGS__}) / sizeof(uint16_t));

/* struct — ordered fields given as child type codes */
#define DTOB_CUSTOM_TYPE_STRUCT(th, code, str, ...)                       \
    dtob_types_add(th, code, str,                                         \
        (uint16_t[]){__VA_ARGS__},                                        \
        sizeof((uint16_t[]){__VA_ARGS__}) / sizeof(uint16_t));            \
    (th)->entries[(th)->count - 1].is_struct = 1;

#endif /* DTOB_TYPES_H */