#include <gre/gre.h> int gr_application_set_data_variable( gr_application_t *app, const char *fqn, const char *variable, const char *fmt, void *data );
The gr_application_set_data_variable
function provides an interface
to set a Storyboard data variable. Combines the fqn and variable to create a key in
the form of "fqn.variable". Copies the data into the corresponding data manager
key, creating the key if needed.
Parameters:
app A pointer to an application handle created using gr_application_create_args
.
fqn The fully qualified name name of the object, should be NULL for app level variables
variable The name of the variable to set
fmt The format describing the data argument: 1s0 (string) | 4u1 (uint32_t) | 4s1 (int32_t) ...
data A pointer to the data to set, this is not a transfer of memory ownership.
Returns:
Zero on success, -1 on failure.
The gr_application_set_data
is a method of setting, creating, and
changing data variables which are useable by the Storyboard engine.