wreport::Vartable Class Reference

Holds a variable information table. More...

#include <vartable.h>

Public Member Functions
virtual std::string	pathname () const =0
	Return the pathname of the file from which this table has been loaded.
virtual Varinfo	query (Varcode code) const =0
	Query the Vartable. More...
virtual bool	contains (Varcode code) const =0
	Check if the code can be resolved to a varinfo.
virtual Varinfo	query_altered (Varcode code, int new_scale, unsigned new_bit_len, int new_bit_ref) const =0
	Query an altered version of the vartable. More...
virtual bool	iterate (std::function< bool(Varinfo)> dest) const =0
	Iterate the whole contents of the table. More...

Static Public Member Functions
static const Vartable *	load_bufr (const std::string &pathname)
	Return a BUFR vartable, by file name. More...
static const Vartable *	load_crex (const std::string &pathname)
	Return a CREX vartable, by file name. More...
static const Vartable *	get_bufr (const BufrTableID &id)
	Find a BUFR table.
static const Vartable *	get_crex (const CrexTableID &id)
	Find a CREX table.
static const Vartable *	get_bufr (const std::string &basename)
	Find a BUFR table, by file name (without extension)
static const Vartable *	get_crex (const std::string &basename)
	Find a CREX table, by file name (without extension)

Detailed Description

Holds a variable information table.

It never needs to be deallocated, as all the Vartable returned by wreport are pointers to memory-cached versions that are guaranteed to exist for all the lifetime of the program.

There are many B tables with slight differences used by different meteorological centre or equipment. This module allows to access different vartables using Vartable::get().

Vartable and Varinfo have special memory management: they are never deallocated. This is an explicit design choice to speed up passing and copying Varinfo values, that are used very intensely as they accompany all the physical values processed by wreport. This behaviour should not be a cause of memory leaks, since a software would only need to access a limited amount of distinct variable informations during its lifetime.

Member Function Documentation

iterate()

virtual bool wreport::Vartable::iterate ( std::function< bool(Varinfo)>  dest ) const

pure virtual

Iterate the whole contents of the table.

Return false from dest to stop iteration.

Returns

true if iteration ended normally, false if dest returned false.

load_bufr()

static const Vartable* wreport::Vartable::load_bufr ( const std::string &  pathname )

static

Return a BUFR vartable, by file name.

Once loaded, the table will be cached in memory for reuse, and further calls to load_bufr() will return the cached version.

load_crex()

static const Vartable* wreport::Vartable::load_crex ( const std::string &  pathname )

static

Return a CREX vartable, by file name.

Once loaded, the table will be cached in memory for reuse, and further calls to load_crex() will return the cached version.

query()

virtual Varinfo wreport::Vartable::query ( Varcode  code ) const

pure virtual

Query the Vartable.

Throws an exception if not found.

Parameters

code	wreport::Varcode to query

Returns

the wreport::varinfo with the results of the query.

query_altered()

virtual Varinfo wreport::Vartable::query_altered ( Varcode  code, int  new_scale, unsigned  new_bit_len, int  new_bit_ref  ) const

pure virtual

Query an altered version of the vartable.

Parameters

code	wreport::Varcode to query
new_scale	Scale to use instead of the default
new_bit_len	Bit length to use instead of the default
new_bit_ref	bit_ref to use instead of the default

Returns

the wreport::Varinfo with the results of the query. The resulting Varinfo is stored inside the Vartable, can be freely copied around and does not need to be deallocated.

---

The documentation for this class was generated from the following file:

• vartable.h