Serializer¶

Configure¶

struct ntl_serializer¶

Structure to assisti null-terminated list serialization.

Public Members

struct ntl_str_delimiter *delimiter¶: optional string delimiters

ntl_elem_serializer elem_to_buf¶: the callback for serializing and appending each NTL element to buf elem_to_buf(NULL,0,p) calculates the size needed to serializer p elem_to_buf(buf,n,p) serialize p to a buffer elem_to_buf should return a negative value for any errors

ntl_t ntl_provider¶: the NTL to be serialized

struct ntl_str_delimiter¶

Configure serialized NTL string delimiters.

Public Members

char start_delimiter¶: defaults to ‘[’

char *element_delimiter¶: defaults to ‘,’

char *last_element_delimiter¶: defaults to “” (blank)

char end_delimiter¶: defaults to ‘]’

char *null_ntl¶: defaults to “null”

Serialize NTL to buffer¶

size_t ntl_to_buf2(char *buf, size_t size, struct ntl_serializer *serializer)¶

Behaves similarly to snprintf(), serialize a NTL p to string.

ntl_to_buf(NULL,0,...) return the number of bytes (excluding \0) needed to serialize p ntl_to_buf(buf,n,...) serialize p to buf and return the number of bytes written excluding \0

Parameters

buf – the buffer to store the serialized NTL
size – the buffer size
serializer – the serializer config structure

Returns

the amount written to buf in bytes

size_t ntl_to_abuf2(char **buf_p, struct ntl_serializer *serializer)¶

Analogous ntl_to_buf(), but will create a buffer thats large enough to hold the output (including the null byte ‘\0’)

Note

buf_p should be free’d accordingly after done being used

Parameters

buf_p – the buffer to be created (expects a char* address)
serializer – the serializer config structure

Returns

the amount written to buf_p in bytes

Utilities

De-serializer