PDI 1.8.0-alpha.2024-08-11

the PDI data interface

record_datatype.h
1/*******************************************************************************
2 * Copyright (C) 2015-2021 Commissariat a l'energie atomique et aux energies alternatives (CEA)
3 * Copyright (C) 2020-2021 Institute of Bioorganic Chemistry Polish Academy of Science (PSNC)
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions are met:
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * * Neither the name of CEA nor the names of its contributors may be used to
14 * endorse or promote products derived from this software without specific
15 * prior written permission.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23 * THE SOFTWARE.
24 ******************************************************************************/
25
26#ifndef PDI_RECORD_DATATYPE_H_
27#define PDI_RECORD_DATATYPE_H_
28
29#include <string>
30#include <vector>
31
32#include <pdi/pdi_fwd.h>
33#include <pdi/datatype.h>
34
35namespace PDI {
36
41class PDI_EXPORT Record_datatype: public Datatype
42{
43 // Required to make_shared due to private ctor
44 struct Shared_enabler;
45
46public:
49 class Member
50 {
52 size_t m_displacement;
53
55 Datatype_sptr m_type;
56
58 std::string m_name;
59
60 public:
67 Member(size_t displacement, Datatype_sptr type, const std::string& name);
68
73 Member(const Member& o);
74
79 size_t displacement() const;
80
86
91 const std::string& name() const;
92
98 bool operator== (const Member& rhs) const;
99
105 bool operator!= (const Member& rhs) const;
106 };
107
108private:
110 std::vector<Member> m_members;
111
113 size_t m_buffersize;
114
115public:
118 const std::vector<Member>& members() const;
119
120 Datatype_sptr densify() const override;
121
123
124 bool dense() const override;
125
126 size_t datasize() const override;
127
128 size_t buffersize() const override;
129
130 size_t alignment() const override;
131
132 bool simple() const override;
133
134 void* data_to_dense_copy(void* to, const void*) const override;
135
136 void* data_from_dense_copy(void* to, const void*) const override;
137
138 Datatype_sptr member(const char* name) const override;
139
140 std::pair<void*, Datatype_sptr> member(const char* name, void* data) const override;
141
142 void destroy_data(void*) const override;
143
144 std::string debug_string() const override;
145
146 bool operator== (const Datatype&) const override;
147
148private:
156 Record_datatype(std::vector<Member>&& members, size_t size, const Attributes_map& attributes = {});
157
158public:
166 static std::shared_ptr<Record_datatype> make(std::vector<Member>&& members, size_t size, const Attributes_map& attributes = {});
167};
168
169} // namespace PDI
170
171#endif // PDI_RECORD_DATATYPE_H_
Definition: context.h:44
A Datatype is a Datatype_template that accepts no argument.
Definition: datatype.h:47
A Member is one of the elements inside a Record_datatype.
Definition: record_datatype.h:50
Member(const Member &o)
Construct a new member by copy.
const std::string & name() const
Access the name of this specific member.
Datatype_sptr type() const
Access the type of the contained member.
size_t displacement() const
Access the offset or distance in byte from the Record_datatype start.
Member(size_t displacement, Datatype_sptr type, const std::string &name)
Construct a new member.
A Record_datatype is a Datatype that represents a fixed number of elements of potentially different t...
Definition: record_datatype.h:42
static std::shared_ptr< Record_datatype > make(std::vector< Member > &&members, size_t size, const Attributes_map &attributes={})
Constructs a new Record_datatype.
std::string debug_string() const override
Returns the datatype yaml representation as a string.
size_t alignment() const override
Returns the required alignment for a type.
void * data_to_dense_copy(void *to, const void *) const override
Creates a dense deep copy of data.
bool simple() const override
Tells if data can be copied as bytes (if type is dense) and doesn't need a destroyer.
Datatype_sptr member(const char *name) const override
Access the type of the member with the provided name.
size_t datasize() const override
Computes the data size of a type, excluding potentially unused memory from a sparse type.
Datatype_sptr evaluate(Context &) const override
Creates a new datatype by resolving the value of all metadata references.
Datatype_sptr densify() const override
Creates a new datatype as the dense copy of this one.
bool dense() const override
Indicate if the datatype is dense or not.
std::pair< void *, Datatype_sptr > member(const char *name, void *data) const override
Access the type and value of the member with the provided name.
void destroy_data(void *) const override
Delete data whose type is described by the Datatype.
const std::vector< Member > & members() const
Accesses the members in increasing displacement order.
size_t buffersize() const override
Computes the data size of a type, including potentially unused memory from a sparse type.
void * data_from_dense_copy(void *to, const void *) const override
Creates a sparse deep copy of dense data.
Definition: array_datatype.h:38
std::unordered_map< std::string, Expression > Attributes_map
Definition: datatype_template.h:40
std::shared_ptr< const Datatype > Datatype_sptr
Definition: pdi_fwd.h:79