lbug 0.16.1

An in-process property graph database management system built for query speed and scalability
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

#pragma once

#include <memory>

#include "common/vector/value_vector.h"
#include "main/client_context.h"
#include "yyjson.h"

namespace lbug {
namespace json_extension {

class JsonMutWrapper;

class LBUG_API JsonWrapper {
    JsonWrapper();

public:
    explicit JsonWrapper(yyjson_doc* ptr, std::shared_ptr<char[]> buffer = nullptr);
    ~JsonWrapper();
    JsonWrapper(JsonWrapper& other) = delete;
    JsonWrapper(JsonWrapper&& other);

    yyjson_doc* ptr;
    std::shared_ptr<char[]> buffer;
};

class LBUG_API JsonMutWrapper {
public:
    JsonMutWrapper();
    explicit JsonMutWrapper(yyjson_mut_doc* ptr);
    ~JsonMutWrapper();
    JsonMutWrapper(JsonMutWrapper& other) = delete;
    JsonMutWrapper(JsonMutWrapper&& other);

    yyjson_mut_doc* ptr;
};

LBUG_API JsonWrapper jsonify(const common::ValueVector& vec, uint64_t pos);
LBUG_API yyjson_mut_val* jsonify(JsonMutWrapper& wrapper, const common::ValueVector& vec,
    uint64_t pos);
LBUG_API yyjson_mut_val* jsonifyAsString(JsonMutWrapper& wrapper, const common::ValueVector& vec,
    uint64_t pos);
// Converts an internal Lbug Value into json

LBUG_API std::vector<JsonWrapper> jsonifyQueryResult(
    const std::vector<std::shared_ptr<common::ValueVector>>& columns,
    const std::vector<std::string>& names);
// Converts an entire query result into a sequence of json values
LBUG_API common::LogicalType jsonSchema(const JsonWrapper& wrapper, int64_t depth = -1,
    int64_t breadth = -1);
LBUG_API common::LogicalType jsonSchema(yyjson_val* val, int64_t depth, int64_t breadth);
// depth indicates at what nested depth to stop
// breadth indicates the limit of how many children the root nested type is sampled
// -1 means to scan the whole thing
// may return ANY

LBUG_API void readJsonToValueVector(yyjson_val* val, common::ValueVector& vec, uint64_t pos);

LBUG_API std::string jsonToString(const JsonWrapper& wrapper);
LBUG_API std::string jsonToString(const yyjson_val* val);
LBUG_API JsonWrapper stringToJson(const std::string& str);
LBUG_API JsonWrapper stringToJsonNoError(const std::string& str);
// format can be 'unstructured' or 'array'

LBUG_API JsonWrapper mergeJson(const JsonWrapper& A, const JsonWrapper& B);

LBUG_API std::string jsonExtractToString(const JsonWrapper& wrapper, uint64_t pos);
LBUG_API std::string jsonExtractToString(const JsonWrapper& wrapper, std::string path);

LBUG_API uint32_t jsonArraySize(const JsonWrapper& wrapper);

} // namespace json_extension
} // namespace lbug