libwreport  3.34
var.h
1 #ifndef WREPORT_VAR_H
2 #define WREPORT_VAR_H
3 
4 #include <wreport/error.h>
5 #include <wreport/fwd.h>
6 #include <wreport/varinfo.h>
7 #include <cstdio>
8 #include <string>
9 #include <memory>
10 
11 struct lua_State;
12 
13 namespace wreport {
14 
24 class Var
25 {
26 protected:
29 
31  bool m_isset;
32 
44  union {
45  int32_t i;
46  char* c;
48 
51 
53  void allocate();
54 
56  void copy_value(const Var& var);
58  void move_value(Var& var);
59  void assign_i_checked(int32_t val);
60  void assign_d_checked(double val);
61  void assign_b_checked(uint8_t* val, unsigned size);
62  void assign_c_checked(const char* val, unsigned size);
63 
64 public:
67 
74  Var(Varinfo info, int val);
75 
77  Var(Varinfo info, double val);
78 
85  Var(Varinfo info, const char* val);
86 
92  Var(Varinfo info, const std::string& val);
93 
104  Var(Varinfo info, const Var& var);
105 
107  Var(const Var& var);
108 
115  Var(Var&& var);
116 
117  ~Var();
118 
120  Var& operator=(const Var& var);
121 
128  Var& operator=(Var&& var);
129 
130  bool operator==(const Var& var) const;
131  bool operator!=(const Var& var) const { return !operator==(var); }
132 
137  bool value_equals(const Var& var) const;
138 
140  Varcode code() const throw () { return m_info->code; }
141 
143  Varinfo info() const throw () { return m_info; }
144 
146  bool isset() const throw () { return m_isset; }
147 
148 
156  int enqi() const;
157 
159  double enqd() const;
160 
168  const char* enqc() const;
169 
177  std::string enqs() const;
178 
180  template<typename T>
181  T enq() const
182  {
183  throw error_unimplemented("getting value of unsupported type");
184  }
185 
190  template<typename T>
191  T enq(T default_value) const
192  {
193  if (!isset()) return default_value;
194  return enq<T>();
195  }
196 
204  void seti(int val);
205 
207  void setd(double val);
208 
216  void setc(const char* val);
217 
225  void sets(const std::string& val);
226 
233  void setf(const char* val);
234 
241  void setc_truncate(const char* val);
242 
247  void setval(const Var& src);
248 
253  void setattrs(const Var& src);
254 
260  void set(int val) { seti(val); }
261  void set(double val) { setd(val); }
262  void set(const char* val) { setc(val); }
263  void set(const std::string& val) { setc(val.c_str()); }
264  void set(const Var& var) { setval(var); setattrs(var); }
266 
268  void unset();
269 
271  void clear_attrs();
272 
282  const Var* enqa(Varcode code) const;
283 
292  void seta(const Var& attr);
293 
302  void seta(Var&& attr);
303 
312  void seta(std::unique_ptr<Var>&& attr);
313 
316 
325  const Var* next_attr() const;
326 
336  std::string format(const char* ifundef="") const;
337 
339  void format(FILE* out, const char* ifundef="") const;
340 
347  void print(FILE* out) const;
348 
355  void print(std::ostream& out) const;
356 
363  void print_without_attrs(FILE* out, const char* end="\n") const;
364 
371  void print_without_attrs(std::ostream& out) const;
372 
384  unsigned diff(const Var& var) const;
385 
386 
390  void lua_push(struct lua_State* L);
391 
396  void lua_push(struct lua_State* L) const;
397 
403  static Var* lua_check(struct lua_State* L, int idx);
404 
410  static const Var* lua_const_check(struct lua_State* L, int idx);
411 };
412 
413 template<> inline int Var::enq() const { return enqi(); }
414 template<> inline float Var::enq() const { return (float)enqd(); }
415 template<> inline double Var::enq() const { return enqd(); }
416 template<> inline const char* Var::enq() const { return enqc(); }
417 template<> inline std::string Var::enq() const { return enqs(); }
418 
419 }
420 #endif
A physical variable.
Definition: var.h:25
unsigned diff(const Var &var) const
Compare two Var and return the number of differences.
void set(const std::string &val)
Shortcuts (use with care, as the semanthics are slightly different depending on the type)
Definition: var.h:263
void setc_truncate(const char *val)
Set the value from a string value, truncating it if it is too long.
void setd(double val)
Set the value from a double value.
double enqd() const
Get the value as a double.
void unseta(Varcode code)
Remove the attribute with the given code.
Varinfo m_info
Metadata about the variable.
Definition: var.h:28
void seta(std::unique_ptr< Var > &&attr)
Set an attribute of the variable.
void lua_push(struct lua_State *L)
Push the variable as an object in the lua stack.
void seti(int val)
Set the value from an integer value.
static Var * lua_check(struct lua_State *L, int idx)
Check that the element at idx is a Var.
T enq() const
Templated version of enq.
Definition: var.h:181
void print_without_attrs(FILE *out, const char *end="\n") const
Print the variable to an output stream, without its attributes.
bool value_equals(const Var &var) const
Test if the values are the same, regardless of variable codes or attributes.
std::string format(const char *ifundef="") const
Create a formatted string representation of the variable value.
int enqi() const
Get the value as an integer.
Var * m_attrs
Attribute list (ordered by Varcode)
Definition: var.h:50
void print(std::ostream &out) const
Print the variable to an output stream.
void sets(const std::string &val)
Set the value from a string or opaque binary value.
static const Var * lua_const_check(struct lua_State *L, int idx)
Check that the element at idx is a Var.
Varinfo info() const
Get informations about the variable.
Definition: var.h:143
bool isset() const
Definition: var.h:146
Var & operator=(const Var &var)
Assignment.
Var(const Var &var)
Copy constructor.
Var(Var &&var)
Move constructor.
void seta(const Var &attr)
Set an attribute of the variable.
void clear_attrs()
Remove all attributes.
void setc(const char *val)
Set the value from a string or opaque binary value.
void move_value(Var &var)
Move the value from var. var is assumed to have the same varinfo as us. var is left unset.
void unset()
Unset the value.
void set(const char *val)
Shortcuts (use with care, as the semanthics are slightly different depending on the type)
Definition: var.h:262
void setval(const Var &src)
Set the value from another variable, performing conversions if needed.
void setattrs(const Var &src)
Replace all attributes in this variable with all the attributes from src.
Var(Varinfo info, double val)
Create a new Var, with double value.
void allocate()
Make sure that m_value is allocated. It does nothing if it already is.
bool m_isset
True if the variable is set, false otherwise.
Definition: var.h:31
void set(int val)
Shortcuts (use with care, as the semanthics are slightly different depending on the type)
Definition: var.h:260
void print_without_attrs(std::ostream &out) const
Print the variable to an output stream, without its attributes.
Var(Varinfo info, const char *val)
Create a new Var, with character value.
Var(Varinfo info, const std::string &val)
Create a new Var, with character value.
Var(Varinfo info, const Var &var)
Create a new Var with the value from another one.
const Var * enqa(Varcode code) const
Query variable attributes.
void set(double val)
Shortcuts (use with care, as the semanthics are slightly different depending on the type)
Definition: var.h:261
void seta(Var &&attr)
Set an attribute of the variable.
T enq(T default_value) const
Return the variable value, or the given default value if the variable is not set.
Definition: var.h:191
void format(FILE *out, const char *ifundef="") const
Write the formatted value of this variable to an output stream.
void lua_push(struct lua_State *L) const
Push the variable as an object in the lua stack, with only read-only methods.
Var & operator=(Var &&var)
Move assignment.
void copy_value(const Var &var)
Copy the value from var. var is assumed to have the same varinfo as us.
const char * enqc() const
Get the value as a string.
Varcode code() const
Retrieve the Varcode for a variable.
Definition: var.h:140
Var(Varinfo info, int val)
Create a new Var, with integer value.
void setf(const char *val)
Set from a value formatted with the format() method.
const Var * next_attr() const
Get the next attribute in the attribute list.
union wreport::Var::@0 m_value
Value of the variable.
void print(FILE *out) const
Print the variable to an output stream.
void set(const Var &var)
Shortcuts (use with care, as the semanthics are slightly different depending on the type)
Definition: var.h:264
Var(Varinfo info)
Create a new Var, with undefined value.
std::string enqs() const
Get the value as a std::string.
Reports that a feature is still not implemented.
Definition: error.h:241
wreport exceptions.
String functions.
Definition: benchmark.h:13
uint16_t Varcode
Holds the WMO variable code of a variable.
Definition: fwd.h:12
Information about a variable.
Definition: varinfo.h:139
Varcode code
Variable code, as in WMO BUFR/CREX table B.
Definition: varinfo.h:141
Implement fast access to information about WMO variables.