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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
#pragma once
#include "public.h"
#include <library/cpp/yt/memory/ref.h>
#include <library/cpp/yt/string/format.h>
#include <variant>
namespace NYT::NYson {
////////////////////////////////////////////////////////////////////////////////
//! Contains a sequence of bytes in YSON encoding annotated with EYsonType describing
//! the content. Could be null. Non-owning.
class TYsonStringBuf
{
public:
//! Constructs a null instance.
TYsonStringBuf();
//! Constructs an instance from TYsonString.
TYsonStringBuf(const TYsonString& ysonString);
//! Constructs a non-null instance with given type and content.
explicit TYsonStringBuf(
const TString& data,
EYsonType type = EYsonType::Node);
//! Constructs a non-null instance with given type and content.
explicit TYsonStringBuf(
TStringBuf data,
EYsonType type = EYsonType::Node);
//! Constructs a non-null instance with given type and content
//! (without this overload there is no way to construct TYsonStringBuf from
//! string literal).
explicit TYsonStringBuf(
const char* data,
EYsonType type = EYsonType::Node);
//! Returns |true| if the instance is not null.
explicit operator bool() const;
//! Returns the underlying YSON bytes. The instance must be non-null.
TStringBuf AsStringBuf() const;
//! Returns type of YSON contained here. The instance must be non-null.
EYsonType GetType() const;
protected:
TStringBuf Data_;
EYsonType Type_;
bool Null_;
};
////////////////////////////////////////////////////////////////////////////////
//! An owning version of TYsonStringBuf.
/*!
* Internally captures the data either via TString or a polymorphic ref-counted holder.
*/
class TYsonString
{
public:
//! Constructs a null instance.
TYsonString();
//! Constructs an instance from TYsonStringBuf.
//! Copies the data into a ref-counted payload.
explicit TYsonString(const TYsonStringBuf& ysonStringBuf);
//! Constructs an instance from TStringBuf.
//! Copies the data into a ref-counted payload.
explicit TYsonString(
TStringBuf data,
EYsonType type = EYsonType::Node);
//! Constructs an instance from TString.
//! Zero-copy for CoW TString: retains the reference to TString in payload.
explicit TYsonString(
const TString& data,
EYsonType type = EYsonType::Node);
//! Constructs an instance from TSharedRef.
//! Zero-copy; retains the reference to TSharedRef holder in payload.
explicit TYsonString(
const TSharedRef& ref,
EYsonType type = EYsonType::Node);
//! Returns |true| if the instance is not null.
explicit operator bool() const;
//! Returns type of YSON contained here. The instance must be non-null.
EYsonType GetType() const;
//! Returns the non-owning data. The instance must be non-null.
TStringBuf AsStringBuf() const;
//! Returns the data represented by TString. The instance must be non-null.
//! Copies the data in case the payload is not TString.
TString ToString() const;
//! Returns the data represented by TSharedRef. The instance must be non-null.
//! The data is never copied.
TSharedRef ToSharedRef() const;
//! Computes the hash code.
size_t ComputeHash() const;
//! Allow to serialize/deserialize using the ::Save ::Load functions. See util/ysaveload.h.
void Save(IOutputStream* s) const;
void Load(IInputStream* s);
private:
struct TNullPayload
{ };
std::variant<TNullPayload, TSharedRangeHolderPtr, TString> Payload_;
const char* Begin_;
ui64 Size_ : 56;
EYsonType Type_ : 8;
};
////////////////////////////////////////////////////////////////////////////////
bool operator == (const TYsonString& lhs, const TYsonString& rhs);
bool operator == (const TYsonString& lhs, const TYsonStringBuf& rhs);
bool operator == (const TYsonStringBuf& lhs, const TYsonString& rhs);
bool operator == (const TYsonStringBuf& lhs, const TYsonStringBuf& rhs);
bool operator != (const TYsonString& lhs, const TYsonString& rhs);
bool operator != (const TYsonString& lhs, const TYsonStringBuf& rhs);
bool operator != (const TYsonStringBuf& lhs, const TYsonString& rhs);
bool operator != (const TYsonStringBuf& lhs, const TYsonStringBuf& rhs);
void FormatValue(TStringBuilderBase* builder, const TYsonString& yson, TStringBuf spec);
void FormatValue(TStringBuilderBase* builder, const TYsonStringBuf& yson, TStringBuf spec);
////////////////////////////////////////////////////////////////////////////////
} // namespace NYT::NYson
#define STRING_INL_H_
#include "string-inl.h"
#undef STRING_INL_H_
|
