mirror of
https://github.com/matrix-construct/construct
synced 2024-10-31 19:08:59 +01:00
391 lines
9.7 KiB
C++
391 lines
9.7 KiB
C++
// Matrix Construct
|
|
//
|
|
// Copyright (C) Matrix Construct Developers, Authors & Contributors
|
|
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
|
|
//
|
|
// Permission to use, copy, modify, and/or distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice is present in all copies. The
|
|
// full license for this software is available in the LICENSE file.
|
|
|
|
#pragma once
|
|
#define HAVE_IRCD_JSON_VALUE_H
|
|
|
|
namespace ircd::json
|
|
{
|
|
struct value;
|
|
|
|
using values = std::initializer_list<value>;
|
|
|
|
enum type type(const value &a);
|
|
bool defined(const value &);
|
|
|
|
size_t serialized(const bool &);
|
|
size_t serialized(const value &);
|
|
size_t serialized(const value *begin, const value *end);
|
|
size_t serialized(const values &);
|
|
|
|
string_view stringify(mutable_buffer &, const value &);
|
|
string_view stringify(mutable_buffer &, const value *begin, const value *end);
|
|
std::ostream &operator<<(std::ostream &, const value &);
|
|
|
|
bool operator==(const value &a, const value &b);
|
|
bool operator!=(const value &a, const value &b);
|
|
bool operator<=(const value &a, const value &b);
|
|
bool operator>=(const value &a, const value &b);
|
|
bool operator<(const value &a, const value &b);
|
|
bool operator>(const value &a, const value &b);
|
|
}
|
|
|
|
/// A primitive of the ircd::json system representing a value at runtime.
|
|
///
|
|
/// This holds state for values apropos a JSON object or array. Value's
|
|
/// data can either be in the form of a JSON string or it can be some native
|
|
/// machine state. The serial flag indicates the former.
|
|
///
|
|
/// Value can can hold any of the JSON types in either of these states.
|
|
/// This is accomplished with runtime switching and branching but this is
|
|
/// still lightweight and without a vtable pointer. The structure is just
|
|
/// the size of two pointers like a string_view; we commandeer bits of the
|
|
/// second word to hold type, flags, and length information. Thus we can hold
|
|
/// large vectors of values at 16 byte alignment and not 24 byte.
|
|
///
|
|
/// Value is capable of allocation and ownership of its internal data and copy
|
|
/// semantics. This is primarily to support recursion and various developer
|
|
/// conveniences like nested initializer_list's etc. It is better to
|
|
/// std::move() a value than copy it, but the full copy semantic is supported;
|
|
/// however, if serial=false then a copy will stringify the data into JSON and
|
|
/// the destination will be serial=true,alloc=true; thus copying of complex
|
|
/// native values never occurs.
|
|
///
|
|
/// Take careful note of a quirk with `operator string_view()`: when the
|
|
/// value is a STRING type string_view()'ing the value will never show
|
|
/// the string with surrounding quotes in view. This is because the value
|
|
/// accepts both quoted and unquoted strings as input from the developer, then
|
|
/// always serializes correctly; unquoted strings are more natural to work
|
|
/// with. This does not apply to other types like OBJECT and array as
|
|
/// string_view()'ing those when in a serial state will show surrounding '{'
|
|
/// etc.
|
|
///
|
|
struct ircd::json::value
|
|
{
|
|
static constexpr const uint &max_string_size {64_KiB};
|
|
|
|
union
|
|
{
|
|
int64_t integer;
|
|
double floating;
|
|
const char *string;
|
|
const struct value *array;
|
|
const struct member *object;
|
|
};
|
|
|
|
uint64_t len : 58; ///< length indicator
|
|
uint64_t type : 3; ///< json::type indicator
|
|
uint64_t serial : 1; ///< only *string is used. type indicates JSON
|
|
uint64_t alloc : 1; ///< indicates the pointer for type is owned
|
|
uint64_t floats : 1; ///< for NUMBER type, integer or floating
|
|
|
|
using create_string_closure = std::function<void (mutable_buffer &)>;
|
|
void create_string(const size_t &len, const create_string_closure &);
|
|
|
|
public:
|
|
bool null() const; ///< literal null or assets are really null
|
|
bool empty() const; ///< null() or assets are empty
|
|
bool undefined() const;
|
|
bool operator!() const; ///< null() or undefined() or empty() or asset Falsy
|
|
|
|
operator string_view() const; ///< NOTE unquote()'s the string value
|
|
explicit operator double() const;
|
|
explicit operator int64_t() const;
|
|
explicit operator std::string() const; ///< NOTE full stringify() of value
|
|
|
|
value(const members &); // alloc = true
|
|
value(const struct member *const &, const size_t &len);
|
|
template<size_t N> value(const struct member (&)[N]);
|
|
value(std::unique_ptr<const struct member[]> &&, const size_t &len); // alloc = true
|
|
value(const struct value *const &, const size_t &len);
|
|
template<size_t N> value(const struct value (&)[N]);
|
|
value(std::unique_ptr<const struct value[]> &&, const size_t &len); // alloc = true
|
|
template<size_t N> value(const char (&)[N], const enum type &);
|
|
template<size_t N> value(const char (&)[N]);
|
|
explicit value(const std::string &, const enum type &);
|
|
explicit value(const std::string &);
|
|
value(const string_view &sv, const enum type &);
|
|
value(const string_view &sv);
|
|
value(const char *const &, const enum type &);
|
|
value(const char *const &s);
|
|
explicit value(const double &);
|
|
explicit value(const int64_t &);
|
|
explicit value(const int32_t &);
|
|
explicit value(const uint32_t &);
|
|
explicit value(const int16_t &);
|
|
explicit value(const uint16_t &);
|
|
explicit value(const int8_t &);
|
|
explicit value(const uint8_t &);
|
|
explicit value(const bool &);
|
|
value(const json::object &);
|
|
value(const json::array &);
|
|
value(const nullptr_t &);
|
|
value() noexcept;
|
|
value(value &&) noexcept;
|
|
value(const value &);
|
|
value &operator=(value &&) noexcept;
|
|
value &operator=(const value &);
|
|
~value() noexcept;
|
|
};
|
|
|
|
static_assert(sizeof(ircd::json::value) == 16, "");
|
|
|
|
inline
|
|
ircd::json::value::value()
|
|
noexcept
|
|
:string{nullptr}
|
|
,len{0}
|
|
,type{STRING}
|
|
,serial{false}
|
|
,alloc{false}
|
|
,floats{false}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const nullptr_t &)
|
|
:value
|
|
{
|
|
literal_null, type::LITERAL
|
|
}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const json::object &sv)
|
|
:value{sv, OBJECT}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const json::array &sv)
|
|
:value{sv, ARRAY}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const bool &boolean)
|
|
:value
|
|
{
|
|
boolean? literal_true : literal_false, type::LITERAL
|
|
}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const uint8_t &integer)
|
|
:value{int64_t{integer}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const int8_t &integer)
|
|
:value{int64_t{integer}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const uint16_t &integer)
|
|
:value{int64_t{integer}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const int16_t &integer)
|
|
:value{int64_t{integer}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const uint32_t &integer)
|
|
:value{int64_t{integer}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const int32_t &integer)
|
|
:value{int64_t{integer}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const int64_t &integer)
|
|
:integer{integer}
|
|
,len{0}
|
|
,type{NUMBER}
|
|
,serial{false}
|
|
,alloc{false}
|
|
,floats{false}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const double &floating)
|
|
:floating{floating}
|
|
,len{0}
|
|
,type{NUMBER}
|
|
,serial{false}
|
|
,alloc{false}
|
|
,floats{true}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const char *const &str)
|
|
:value{string_view{str}}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const char *const &str,
|
|
const enum type &type)
|
|
:value{string_view{str}, type}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const string_view &sv)
|
|
:value{sv, json::type(sv, strict, std::nothrow)}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const string_view &sv,
|
|
const enum type &type)
|
|
:string{sv.data()}
|
|
,len{sv.size()}
|
|
,type{type}
|
|
,serial{type == STRING? surrounds(sv, '"') : true}
|
|
,alloc{false}
|
|
,floats{false}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const std::string &s)
|
|
:value{s, json::type(s, strict, std::nothrow)}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(const struct value *const &array,
|
|
const size_t &len)
|
|
:array{array}
|
|
,len{len}
|
|
,type{ARRAY}
|
|
,serial{false}
|
|
,alloc{false}
|
|
,floats{false}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(std::unique_ptr<const struct value[]> &&array,
|
|
const size_t &len)
|
|
:array{array.get()}
|
|
,len{len}
|
|
,type{ARRAY}
|
|
,serial{false}
|
|
,alloc{true}
|
|
,floats{false}
|
|
{
|
|
array.release();
|
|
}
|
|
|
|
inline
|
|
ircd::json::value::value(const struct member *const &object,
|
|
const size_t &len)
|
|
:object{object}
|
|
,len{len}
|
|
,type{OBJECT}
|
|
,serial{false}
|
|
,alloc{false}
|
|
,floats{false}
|
|
{}
|
|
|
|
inline
|
|
ircd::json::value::value(std::unique_ptr<const struct member[]> &&object,
|
|
const size_t &len)
|
|
:object{object.get()}
|
|
,len{len}
|
|
,type{OBJECT}
|
|
,serial{false}
|
|
,alloc{true}
|
|
,floats{false}
|
|
{
|
|
object.release();
|
|
}
|
|
|
|
inline
|
|
ircd::json::value::value(value &&other)
|
|
noexcept
|
|
:integer{other.integer}
|
|
,len{other.len}
|
|
,type{other.type}
|
|
,serial{other.serial}
|
|
,alloc{other.alloc}
|
|
,floats{other.floats}
|
|
{
|
|
other.alloc = false;
|
|
}
|
|
|
|
template<size_t N>
|
|
inline
|
|
ircd::json::value::value(const char (&str)[N])
|
|
:value{string_view{str, strnlen(str, N)}}
|
|
{}
|
|
|
|
template<size_t N>
|
|
inline
|
|
ircd::json::value::value(const char (&str)[N],
|
|
const enum type &type)
|
|
:value{string_view{str, strnlen(str, N)}, type}
|
|
{}
|
|
|
|
template<size_t N>
|
|
inline
|
|
ircd::json::value::value(const struct value (&val)[N])
|
|
:value{val, N}
|
|
{}
|
|
|
|
template<size_t N>
|
|
inline
|
|
ircd::json::value::value(const struct member (&val)[N])
|
|
:value{val, N}
|
|
{}
|
|
|
|
inline bool
|
|
ircd::json::operator>(const value &a, const value &b)
|
|
{
|
|
return !operator<=(a, b);
|
|
}
|
|
|
|
inline bool
|
|
ircd::json::operator>=(const value &a, const value &b)
|
|
{
|
|
return operator>(a, b) || operator==(a, b);
|
|
}
|
|
|
|
inline bool
|
|
ircd::json::operator<=(const value &a, const value &b)
|
|
{
|
|
return operator<(a, b) || operator==(a, b);
|
|
}
|
|
|
|
inline bool
|
|
ircd::json::operator!=(const value &a, const value &b)
|
|
{
|
|
return !operator==(a, b);
|
|
}
|
|
|
|
inline size_t
|
|
ircd::json::serialized(const bool &b)
|
|
{
|
|
constexpr const size_t tf[2]
|
|
{
|
|
_constexpr_strlen("false"),
|
|
_constexpr_strlen("true"),
|
|
};
|
|
|
|
return tf[b];
|
|
}
|
|
|
|
inline bool
|
|
ircd::json::defined(const value &a)
|
|
{
|
|
return !a.undefined();
|
|
}
|
|
|
|
inline enum ircd::json::type
|
|
ircd::json::type(const value &a)
|
|
{
|
|
return static_cast<enum json::type>(a.type);
|
|
}
|