libusermetrics
MetricManagerUpdateTodayCAPI.c

A simple example of a metric that doesn't worry about updating history, and just updates a single value in response to an action. This is for apps that cannot simply just increment the current value.

int main(int argc, char *argv[]) {
// We start with a manager object
// Create a parameters object
// Set its attributes
"<b>%1</b> photos taken today");
"No photos today");
// You can hold onto this shared object for as long as you want
metricManager, parameters);
// Remember to free the parameters object after use
// Providing a blank username string will use the current
// user according to the USER environment variable.
usermetricsinput_metric_update_today(metric, photo_library_get_size(), "");
// Now we're done with the manager
return 0;
}
USERMETRICSINPUT_EXPORT void usermetricsinput_metricparameters_set_format_string(UserMetricsInputMetricParameters metricParameter, const char *formatString)
Set the string to print in the output API, e.g. "<b>%1</b> messages received today".
USERMETRICSINPUT_EXPORT UserMetricsInputMetric usermetricsinput_metricmanager_add(UserMetricsInputMetricManager metricManager, UserMetricsInputMetricParameters metricParameters)
Register a new UserMetricsInputMetric.
USERMETRICSINPUT_EXPORT void usermetricsinput_metricparameters_delete(UserMetricsInputMetricParameters metricParameters)
Free a UserMetricsInputMetricParameters.
void * UserMetricsInputMetric
A single user metric, e.g. "number of e-mails today" or "photos taken today".
Definition usermetricsinput.h:57
void * UserMetricsInputMetricParameters
Parameters for constructing a metric.
Definition usermetricsinput.h:52
USERMETRICSINPUT_EXPORT void usermetricsinput_metricmanager_delete(UserMetricsInputMetricManager metricManager)
Free a UserMetricsInputMetricManager.
void * UserMetricsInputMetricManager
A central place for registering user metrics.
Definition usermetricsinput.h:47
USERMETRICSINPUT_EXPORT void usermetricsinput_metric_update_today(UserMetricsInputMetric metric, double value, const char *username)
Update the "today" value for a simple user metric.
USERMETRICSINPUT_EXPORT void usermetricsinput_metricparameters_set_text_domain(UserMetricsInputMetricParameters metricParameter, const char *textDomain)
Set the translation domain.
USERMETRICSINPUT_EXPORT void usermetricsinput_metricparameters_set_empty_data_string(UserMetricsInputMetricParameters metricParameter, const char *emptyDataString)
set the string to print in the case of no data, e.g. "No messages received today"
USERMETRICSINPUT_EXPORT UserMetricsInputMetricParameters usermetricsinput_metricparameters_new(const char *dataSourceId)
Construct a new UserMetricsInputMetricParameters.
USERMETRICSINPUT_EXPORT UserMetricsInputMetricManager usermetricsinput_metricmanager_new()
Construct a new UserMetricsInputMetricManager.