Mercurial > molko
annotate src/clock.h @ 32:91bc2329ab0c
core: implement data directory access, closes #2454 @1h
author | David Demelier <markand@malikania.fr> |
---|---|
date | Mon, 13 Jan 2020 13:28:53 +0100 |
parents | 5519ad48822e |
children | b815621df3e3 |
rev | line source |
---|---|
6
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
1 /* |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
2 * clock.h -- track elapsed time |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
3 * |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
4 * Copyright (c) 2020 David Demelier <markand@malikania.fr> |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
5 * |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
6 * Permission to use, copy, modify, and/or distribute this software for any |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
7 * purpose with or without fee is hereby granted, provided that the above |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
8 * copyright notice and this permission notice appear in all copies. |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
9 * |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
17 */ |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
18 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
19 #ifndef MOLKO_CLOCK_H |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
20 #define MOLKO_CLOCK_H |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
21 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
22 /** |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
23 * \file clock.h |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
24 * \brief Track elapsed time. |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
25 */ |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
26 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
27 #include <stdint.h> |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
28 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
29 /** |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
30 * \brief Clock structure. |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
31 */ |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
32 struct clock { |
22
5519ad48822e
doc: add Doxygen documentation, closes #2450
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
33 uint64_t ticks; /*!< time point on initialization */ |
6
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
34 }; |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
35 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
36 /** |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
37 * Start the clock and track elapsed time. |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
38 * |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
39 * \pre clock != NULL |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
40 * \param clock the clock |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
41 */ |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
42 void |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
43 clock_start(struct clock *clock); |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
44 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
45 /** |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
46 * Tell the measured time. |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
47 * |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
48 * \pre clock != NULL |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
49 * \param clock the clock |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
50 * \return the elapsed time in milliseconds |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
51 */ |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
52 uint64_t |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
53 clock_elapsed(const struct clock *clock); |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
54 |
3054723e53d7
core: implement clock, closes #2443
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
55 #endif /* !MOLKO_CLOCK_H */ |