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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
// BSD 3-Clause License; see https://github.com/scikit-hep/awkward/blob/main/LICENSE
#ifndef AWKWARD_RECORDBUILDER_H_
#define AWKWARD_RECORDBUILDER_H_
#include <vector>
#include "awkward/common.h"
#include "awkward/BuilderOptions.h"
#include "awkward/GrowableBuffer.h"
#include "awkward/builder/Builder.h"
namespace awkward {
/// @class RecordBuilder
///
/// @brief Builder node for accumulated records.
class EXPORT_SYMBOL RecordBuilder: public Builder {
public:
/// @brief Create an empty RecordBuilder.
/// @param options Configuration options for building an array;
/// these are passed to every Builder's constructor.
static const BuilderPtr
fromempty(const BuilderOptions& options);
/// @brief Create a RecordBuilder from a full set of parameters.
///
/// @param options Configuration options for building an array;
/// these are passed to every Builder's constructor.
/// @param contents A Builder for each record field.
/// @param keys Names for each record field.
/// @param pointers String pointers for each record field name.
/// @param name String name of the record.
/// @param nameptr String pointer for the name of the record.
/// @param length Length of accumulated array (same as #length).
/// @param begun If `true`, the RecordBuilder is in an active state;
/// `false` otherwise.
/// @param nextindex The next field index to fill with data.
/// @param nexttotry The next field index to check against a key string.
RecordBuilder(const BuilderOptions& options,
const std::vector<BuilderPtr>& contents,
const std::vector<std::string>& keys,
const std::vector<const char*>& pointers,
const std::string& name,
const char* nameptr,
int64_t length,
bool begun,
int64_t nextindex,
int64_t nexttotry);
/// @brief Name of the record (STL wrapped #nameptr).
const std::string
name() const;
/// @brief String pointer for the name of the record.
const char*
nameptr() const;
/// @brief User-friendly name of this class: `"RecordBuilder"`.
const std::string
classname() const override;
const std::string
to_buffers(BuffersContainer& container, int64_t& form_key_id) const override;
int64_t
length() const override;
void
clear() override;
/// @copydoc Builder::active()
///
/// Calling #beginrecord makes a RecordBuilder active; #endrecord makes it
/// inactive.
bool
active() const override;
const BuilderPtr
null() override;
const BuilderPtr
boolean(bool x) override;
const BuilderPtr
integer(int64_t x) override;
const BuilderPtr
real(double x) override;
const BuilderPtr
complex(std::complex<double> x) override;
const BuilderPtr
datetime(int64_t x, const std::string& unit) override;
const BuilderPtr
timedelta(int64_t x, const std::string& unit) override;
const BuilderPtr
string(const char* x, int64_t length, const char* encoding) override;
const BuilderPtr
beginlist() override;
const BuilderPtr
endlist() override;
const BuilderPtr
begintuple(int64_t numfields) override;
const BuilderPtr
index(int64_t index) override;
const BuilderPtr
endtuple() override;
const BuilderPtr
beginrecord(const char* name, bool check) override;
void
field(const char* key, bool check) override;
const BuilderPtr
endrecord() override;
const BuilderOptions&
options() const { return options_; }
const std::vector<std::string>& keys() const { return keys_; }
const std::vector<BuilderPtr>& builders() const { return contents_; }
bool begun() { return begun_; }
int64_t nextindex() { return nextindex_; }
void
maybeupdate(int64_t i, const BuilderPtr builder);
private:
void
field_fast(const char* key);
void
field_check(const char* key);
const BuilderOptions options_;
std::vector<BuilderPtr> contents_;
std::vector<std::string> keys_;
std::vector<const char*> pointers_;
std::string name_;
const char* nameptr_;
int64_t length_;
bool begun_;
int64_t nextindex_;
int64_t nexttotry_;
int64_t keys_size_;
};
}
#endif // AWKWARD_RECORDBUILDER_H_
|
