Counter
[Tools]
These functions allow you to get the time spent in a part of a code. More...
Typedefs | |
typedef struct _Eina_Counter | Eina_Counter |
Counter type. | |
Functions | |
EAPI Eina_Counter * | eina_counter_new (const char *name) |
Return a counter. | |
EAPI void | eina_counter_free (Eina_Counter *counter) |
Delete a counter. | |
EAPI void | eina_counter_start (Eina_Counter *counter) |
Start the time count. | |
EAPI void | eina_counter_stop (Eina_Counter *counter, int specimen) |
Stop the time count. | |
EAPI char * | eina_counter_dump (Eina_Counter *counter) |
Dump the result of all clocks of a counter to a stream. | |
Eina_Bool | eina_counter_init (void) |
Eina_Bool | eina_counter_shutdown (void) |
Detailed Description
These functions allow you to get the time spent in a part of a code.
Before using the counter system, Eina must be initialized with eina_init() and later shut down with eina_shutdown(). The create a counter, use eina_counter_new(). To free it, use eina_counter_free().
To time a part of a code, call eina_counter_start() just before it, and eina_counter_stop() just after it. Each time you start to time a code, a clock is added to a list. You can give a number of that clock with the second argument of eina_counter_stop(). To send all the registered clocks to a stream (like stdout, ofr a file), use eina_counter_dump().
Here is a straightforward example:
#include <stdlib.h> #include <stdio.h> #include <eina_counter.h> void test_malloc(void) { int i; for (i = 0; i < 100000; ++i) { void *buf; buf = malloc(100); free(buf); } } int main(void) { Eina_Counter *counter; if (!eina_init()) { printf("Error during the initialization of eina\n"); return EXIT_FAILURE; } counter = eina_counter_new("malloc"); eina_counter_start(counter); test_malloc(); eina_counter_stop(counter, 1); eina_counter_dump(counter); eina_counter_free(counter); eina_shutdown(); return EXIT_SUCCESS; }
Compile this code with the following commant:
gcc -Wall -o test_eina_counter test_eina.c `pkg-config --cflags --libs eina`
The result should be something like that:
# specimen experiment time starting time ending time 1 9794125 783816 10577941
Note that the displayed time is in nanosecond.
Function Documentation
EAPI Eina_Counter * eina_counter_new | ( | const char * | name | ) |
Return a counter.
- Parameters:
-
name The name of the counter.
This function returns a new counter. It is characterized by name
. If name
is NULL
, the function returns NULL
immediatly. If memory allocation fails, NULL
is returned and the error is set to EINA_ERROR_OUT_OF_MEMORY.
Whe the new counter is not needed anymore, use eina_counter_free() to free the allocated memory.
EAPI void eina_counter_free | ( | Eina_Counter * | counter | ) |
Delete a counter.
- Parameters:
-
counter The counter to delete.
This function remove the clock of counter
from the used clocks (see eina_counter_start()) and frees the memory allocated for counter
. If counter
is NULL
, the function returns immediatly.
EAPI void eina_counter_start | ( | Eina_Counter * | counter | ) |
Start the time count.
- Parameters:
-
counter The counter.
This function specifies that the part of the code beginning just after its call is being to be timed, using counter
. If counter
is NULL
, this function returns immediatly.
This function adds the clock associated to counter
in a list. If the memory needed by that clock can not be allocated, the function returns and the error is set to EINA_ERROR_OUT_OF_MEMORY.
To stop the timing, eina_counter_stop() must be called with the same counter.
EAPI void eina_counter_stop | ( | Eina_Counter * | counter, | |
int | specimen | |||
) |
Stop the time count.
- Parameters:
-
counter The counter. specimen The number of the test.
This function stop the timing that has been started with eina_counter_start(). counter
must be the same than the one used with eina_counter_start(). specimen
is the number of the test. If counter
or its associated clock are NULL
, or if the time can't be retrieved the function exits.
EAPI char * eina_counter_dump | ( | Eina_Counter * | counter | ) |
Dump the result of all clocks of a counter to a stream.
- Returns:
- A string with a summary of the test.
- Parameters:
-
counter The counter.
This function dump all the valid clocks of counter
to the stream out
. If counter
or out
are NULL
, the functions exits immediatly. Otherwise, the output is formattted like that:
\# specimen experiment time starting time ending time 1 208 120000 120208
The unit of time is the nanosecond.