aboutsummaryrefslogtreecommitdiff
path: root/lib/experiment-reader/experiment-reader.h
blob: 7747d9509102e6285e1be4022a07301ddb0cb14a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
/**
 * @file
 * Header file to include when using the \e ExperimentReader class.
 */

#ifndef __EXPERIMENT_READER_H
#define __EXPERIMENT_READER_H

#include <glib.h>
#include <glib-object.h>

G_BEGIN_DECLS

#define EXPERIMENT_TYPE_READER \
	(experiment_reader_get_type())
/**
 * Cast instance pointer to \e ExperimentReader
 *
 * @param obj Object to cast to \e ExperimentReader
 * @return \e obj casted to \e ExperimentReader
 */
#define EXPERIMENT_READER(obj) \
	(G_TYPE_CHECK_INSTANCE_CAST((obj), EXPERIMENT_TYPE_READER, ExperimentReader))
#define EXPERIMENT_READER_CLASS(klass) \
	(G_TYPE_CHECK_CLASS_CAST((klass), EXPERIMENT_TYPE_READER, ExperimentReaderClass))
#define EXPERIMENT_IS_READER(obj) \
	(G_TYPE_CHECK_INSTANCE_TYPE((obj), EXPERIMENT_TYPE_READER))
#define EXPERIMENT_IS_READER_CLASS(klass) \
	(G_TYPE_CHECK_CLASS_TYPE((klass), EXPERIMENT_TYPE_READER))
#define EXPERIMENT_READER_GET_CLASS(obj) \
	(G_TYPE_INSTANCE_GET_CLASS((obj), EXPERIMENT_TYPE_READER, ExperimentReaderClass))

/** @private */
typedef struct _ExperimentReaderPrivate ExperimentReaderPrivate;

/**
 * \e ExperimentReader instance structure
 */
typedef struct _ExperimentReader {
	GObject parent_instance;	/**< Parent instance structure */

	ExperimentReaderPrivate *priv;	/**< @private */
} ExperimentReader;

/**
 * \e ExperimentReader class structure
 */
typedef struct _ExperimentReaderClass {
	GObjectClass parent_class;	/**< Parent class structure */
} ExperimentReaderClass;

/** @private */
GType experiment_reader_get_type(void);

/*
 * Callbacks
 */
/**
 * Type of function to use for \e topic callbacks.
 *
 * @param reader     \e ExperimentReader the information refers to
 * @param topic_id   Symbolic identifier of experiment \b topic
 * @param start_time Beginning of first \b contribution in \e topic (milliseconds)
 * @param data       Callback user data
 */
typedef void (*ExperimentReaderTopicCallback)(ExperimentReader *reader,
					      const gchar *topic_id,
					      gint64 start_time,
					      gpointer data);

/*
 * API
 */
ExperimentReader *experiment_reader_new(const gchar *filename);

void experiment_reader_foreach_greeting_topic(
	ExperimentReader		*reader,
	ExperimentReaderTopicCallback	callback,
	gpointer			data);
void experiment_reader_foreach_exp_initial_narrative_topic(
	ExperimentReader		*reader,
	ExperimentReaderTopicCallback	callback,
	gpointer			data);
void experiment_reader_foreach_exp_last_minute_phase_topic(
	ExperimentReader		*reader,
	gint				phase,
	ExperimentReaderTopicCallback	callback,
	gpointer			data);
void experiment_reader_foreach_farewell_topic(
	ExperimentReader		*reader,
	ExperimentReaderTopicCallback	callback,
	gpointer			data);

G_END_DECLS

#endif