Top | ![]() |
![]() |
![]() |
![]() |
BtPersistence is implemented by BtMachine, BtPattern, BtProcessorMachine, BtSequence, BtSetup, BtSinkMachine, BtSong, BtSongInfo, BtSourceMachine, BtWave, BtWavelevel, BtWavetable and BtWire.
Classes can implement this interface to store their data as xml and restore them from xml. They should call the interface methods on their children objects (which also implement the interface) to serialize/ deserialize a whole object hierarchy.
void bt_persistence_collect_hashtable_entries (gpointer const key
,gpointer const value
,gpointer const user_data
);
Gather GHashTable entries in a list. Should be used with g_hash_table_foreach()
.
BtPersistence * bt_persistence_load (const GType type
,const BtPersistence * const self
,xmlNodePtr node
,GError **err
,...
);
Deserializes the given object from the node
. If self
is NULL
and a type
is given it constructs a new object.
type |
a GObject type |
|
self |
a deserialiable object |
|
node |
the xml node |
|
err |
a GError for deserialisation errors |
|
... |
extra parameters NULL terminated name/value pairs. |
gboolean bt_persistence_load_hashtable (GHashTable *hashtable
,xmlNodePtr node
);
Iterates over the xml-node and deserializes elements into the hashtable.
xmlNodePtr bt_persistence_save (const BtPersistence * const self
,xmlNodePtr const parent_node
);
Serializes the given object into node
.
gboolean bt_persistence_save_hashtable (GHashTable *hashtable
,xmlNodePtr const node
);
Iterates over a hashtable with strings and serializes them.
gboolean bt_persistence_save_list (const GList *list
,xmlNodePtr const node
);
Iterates over a list of objects, which must implement the BtPersistence
interface and calls bt_persistence_save()
on each item.
list |
a GList
|
[element-type BuzztraxCore.Persistence] |
node |
the list xml node |
struct BtPersistenceInterface { /* virtual methods */ xmlNodePtr (*save)(const BtPersistence * const self, xmlNodePtr const node); BtPersistence* (*load)(const GType type, const BtPersistence * const self, xmlNodePtr node, GError **err, va_list var_args); };
BtPersistence interface