vl_msgpack_io.h

Go to the documentation of this file.

 
#ifndef VL_MSGPACK_IO_H
#define VL_MSGPACK_IO_H
 
#include "vl_buffer.h"
#include "vl_msgpack.h"
#include "vl_stack.h"
 
typedef enum vl_msgpack_io_error_
{
    VL_MSGPACK_IO_ERR_NONE, // No error. All good!
    VL_MSGPACK_IO_ERR_STACK_UNDERFLOW, // Erroneous call to a container end
                                       // encoding function.
    VL_MSGPACK_IO_ERR_UNEXPECTED_TOKEN, // Expected a different token as "next"
                                        // when decoding.
    VL_MSGPACK_IO_ERR_UNBALANCED_MAP, // Map does not have an even number of
                                      // values when encoding (must be key/value
                                      // pairs)
    VL_MSGPACK_IO_ERR_UNEXPECTED_EOF, // Found end of buffer at an unexpected
                                      // point when decoding
} vl_msgpack_io_error;
 
typedef struct vl_msgpack_encoder_
{
    // Holds state of current structure (map/array), including how many elements.
    vl_stack stateStack;
    // Holds encoded data.
    vl_buffer buffer;
 
    vl_msgpack_io_error error;
    vl_msgpack_type errorType;
    vl_dsidx_t errorDepth;
} vl_msgpack_encoder;
 
VL_API void vlMsgPackIOEncoderInit(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncoderFree(vl_msgpack_encoder* enc);
 
VL_API vl_msgpack_encoder* vlMsgPackIOEncoderNew(void);
 
VL_API void vlMsgPackIOEncoderDelete(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncoderClear(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncodeMapBegin(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncodeMapEnd(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncodeArrayBegin(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncodeArrayEnd(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncodeBool(vl_msgpack_encoder* enc, vl_bool_t value);
 
VL_API void vlMsgPackIOEncodeStringLen(vl_msgpack_encoder* enc, const char* value, vl_uint32_t len);
 
static inline void vlMsgPackIOEncodeString(vl_msgpack_encoder* enc, const char* value)
{
    vlMsgPackIOEncodeStringLen(enc, value, (vl_uint32_t)strlen(value));
}
 
VL_API void vlMsgPackIOEncodeFloat32(vl_msgpack_encoder* enc, vl_float32_t value);
 
VL_API void vlMsgPackIOEncodeFloat64(vl_msgpack_encoder* enc, vl_float64_t value);
 
VL_API void vlMsgPackIOEncodeBinary(vl_msgpack_encoder* enc, const void* value, vl_uint32_t len);
 
VL_API void vlMsgPackIOEncodeExt(vl_msgpack_encoder* enc, vl_int8_t type, const void* value, vl_uint32_t len);
 
VL_API void vlMsgPackIOEncodeInt(vl_msgpack_encoder* enc, vl_ilarge_t value);
 
VL_API void vlMsgPackIOEncodeUInt(vl_msgpack_encoder* enc, vl_ularge_t value);
 
VL_API void vlMsgPackIOEncodeNil(vl_msgpack_encoder* enc);
 
VL_API void vlMsgPackIOEncodeFromDOM(vl_msgpack_encoder* encoder, vl_msgpack* src, vl_msgpack_iter curIter);
 
typedef struct vl_msgpack_io_token_
{
    union
    {
        struct
        {
            vl_dsidx_t elements;
        } array;
 
        struct
        {
            vl_dsidx_t keyValuePairs;
        } map;
 
        struct
        {
            vl_ilarge_t value;
        } integer;
 
        struct
        {
            vl_ularge_t value;
        } uinteger;
 
        struct
        {
            vl_float32_t value;
        } float32;
 
        struct
        {
            vl_float64_t value;
        } float64;
 
        struct
        {
            vl_bool_t value;
        } boolean;
 
        struct
        {
            // UTF-8 Encoded
            const char* ptr;
            vl_uint32_t length;
        } string;
 
        struct
        {
            const void* ptr;
            vl_uint32_t length;
        } binary;
 
        struct
        {
            vl_int8_t extType;
            const void* ptr;
            vl_uint32_t length;
        } ext;
    };
 
    vl_msgpack_type type;
} vl_msgpack_io_token;
 
typedef struct vl_msgpack_decoder_
{
    const vl_uint8_t* srcMem;
    vl_memsize_t srcLen;
    vl_dsoffs_t srcOffset;
 
    vl_msgpack_io_error error; // Error.
    vl_msgpack_type errorType; // Type associated with error.
    vl_dsoffs_t errorOffset; // Offset in source buffer where error occurred.
} vl_msgpack_decoder;
 
VL_API void vlMsgPackIODecoderStart(vl_msgpack_decoder* dec, const void* srcMem, vl_memsize_t srcLen);
 
VL_API vl_bool_t vlMsgPackIODecoderNext(vl_msgpack_decoder* decoder, vl_msgpack_io_token* tkPtr);
 
VL_API vl_msgpack_iter vlMsgPackIODecodeToDOM(vl_msgpack_decoder* decoder, vl_msgpack* dest, vl_msgpack_iter parent,
                                              const void* key, vl_memsize_t keyLen);
 
#endif // VL_MSGPACK_IO_H