KvpValue Struct Reference

Implements KvpValue using boost::variant. More...

#include <kvp-value.hpp>

Public Types
enum	Type {   INVALID = -1, INT64 = 1, DOUBLE, NUMERIC,   STRING, GUID, TIME64, PLACEHOLDER_DONT_USE,   GLIST, FRAME, GDATE }

Public Member Functions
	KvpValueImpl (KvpValueImpl const &) noexcept
	Performs a deep copy.
KvpValueImpl &	operator= (const KvpValueImpl &) noexcept
	KvpValueImpl (KvpValueImpl &&b) noexcept
	Move. More...
KvpValueImpl &	operator= (KvpValueImpl &&b) noexcept
template<typename T >
	KvpValueImpl (T) noexcept
	Create a KvpValue containing the passed in item. More...
	~KvpValueImpl () noexcept
	Performs a deep delete. More...
KvpValueImpl *	add (KvpValueImpl *) noexcept
	Adds another value to this KvpValueImpl. More...
KvpValueImpl::Type	get_type () const noexcept
std::string	to_string () const noexcept
std::string	to_string (std::string const &prefix) const noexcept
template<typename T >
T	get () const noexcept
template<typename T >
const T *	get_ptr () const noexcept
template<typename T >
void	set (T) noexcept

Friends
int	compare (const KvpValueImpl &, const KvpValueImpl &) noexcept

Detailed Description

Implements KvpValue using boost::variant.

Capable of holding the following types:

• int64_t
• double
• gnc_numeric
• const char*
• GncGUID*
• Timepsec
• GList*
• KvpFrame*
• GDate

Definition at line 52 of file kvp-value.hpp.

Member Enumeration Documentation

Type

enum KvpValueImpl::Type

Enumerator
INT64	QOF_TYPE_INT64 gint64.
DOUBLE	QOF_TYPE_DOUBLE gdouble.
NUMERIC	QOF_TYPE_NUMERIC.
STRING	QOF_TYPE_STRING gchar*.
GUID	QOF_TYPE_GUID.
TIME64	QOF_TYPE_DATE.
GLIST	no QOF equivalent.
FRAME	no QOF equivalent.
GDATE	no QOF equivalent.

Definition at line 55 of file kvp-value.hpp.

    {
        INVALID = -1,
        INT64 = 1, 
        DOUBLE,     
        NUMERIC,    
        STRING,     
        GUID,       
        TIME64,   
        PLACEHOLDER_DONT_USE, /* Replaces KVP_TYPE_BINARY */
        GLIST,      
        FRAME,      
        GDATE,      
    };

Constructor & Destructor Documentation

KvpValueImpl() [1/2]

KvpValue::KvpValueImpl ( KvpValueImpl &&  b )

noexcept

Move.

The old object's datastore is set to int64_t 0.

Definition at line 46 of file kvp-value.cpp.

{
    datastore = b.datastore;
    b.datastore = INT64_C(0);
}

KvpValueImpl() [2/2]

template<typename T >

KvpValue::KvpValueImpl ( T  newvalue )

noexcept

Create a KvpValue containing the passed in item.

Note that for pointer types const char*, KvpFrame*, GncGUID*, and GList* the KvpValue takes ownership of the object and will delete/free it when the KvpValue is destroyed. That means these objects must be allocated in the free store or heap as follows:

• const char*: GLib string allocation, e.g. g_strdup()/
• KvpFrame*: operator new
• GncGUID*: guid_new() or guid_copy()
• GList*: Uses g_list_free(), so it's up to classes using this to empty the list before destroying the KvpValue.

Definition at line 150 of file kvp-value.hpp.

                                             :
    datastore(newvalue)
{
}

~KvpValueImpl()

KvpValue::~KvpValueImpl ( )

noexcept

Performs a deep delete.

The contents of this KvpValueImpl are also deleted.

Definition at line 366 of file kvp-value.cpp.

{
    delete_visitor d;
    boost::apply_visitor(d, datastore);
}

Member Function Documentation

add()

KvpValueImpl * KvpValue::add ( KvpValueImpl *  val )

noexcept

Adds another value to this KvpValueImpl.

If this KvpValueImpl represents a collection (GList), the new value is added to the collection and this is returned.

Otherwise, a new KvpValueImpl representing a collection is created, this and the new value are added to it, and it is returned.

Definition at line 60 of file kvp-value.cpp.

{
    /* If already a glist here, just append */
    if (this->datastore.type() == type_id<GList*>())
    {
        GList * list = boost::get<GList*>(datastore);
        datastore = g_list_append (list, val);
        return this;
    }
    /* If some other value, convert it to a glist */
    GList *list = nullptr;

    list = g_list_append (list, this);
    list = g_list_append (list, val);
    return new KvpValueImpl(list);
}

---

The documentation for this struct was generated from the following files:

• kvp-value.hpp
• kvp-value.cpp