https://github.com/jwerle/eloop.c
Simple single threaded event loop API
https://github.com/jwerle/eloop.c
Last synced: about 1 year ago
JSON representation
Simple single threaded event loop API
- Host: GitHub
- URL: https://github.com/jwerle/eloop.c
- Owner: jwerle
- License: mit
- Created: 2014-09-25T18:06:06.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2014-09-25T18:17:43.000Z (over 11 years ago)
- Last Synced: 2025-03-29T19:11:08.695Z (about 1 year ago)
- Language: C
- Size: 137 KB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
eloop.c
=======
Simple single threaded event loop API
## why ?
To learn and experiment
## install
```sh
$ clib install jwerle/eloop.c
```
## usage
```c
#include
#include
static int
work (void *data) {
printf("%s\n", (char *) data);
return EL_WORK_COMPLETE;
}
int
main (int argc, char **argv) {
el_t *loop = el_alloc();
el_enqueue(loop, "hello", work);
return el_run(loop);
}
```
## api
*Worker status codes:*
```c
EL_WORK_ERROR = -1
EL_WORK_PENDING = 0
EL_WORK_COMPLETE = 1
```
*Event loop API:*
```c
/**
* Worker function with data passed to it
*/
typedef el_work_status_t (*el_work_handle_t) (void *);
/**
* Work structure with function handle and data
*/
typedef struct el_work {
el_work_handle_t handle;
void *data;
} el_work_t;
/**
* Event loop arbiter
*/
typedef struct eloop {
el_work_t *work[EL_MAX_WORK];
size_t length;
} el_t;
/**
* Allocates a new `el_t' type
*/
el_t *
el_alloc (void);
/**
* Frees an event loop
*/
void
el_free (el_t *);
/**
* Initializes work with argument and function handle
*/
el_work_t *
el_work_init (void *, el_work_handle_t);
/**
* Destroys work. Does not destroy argument pointer
*/
void
el_work_destroy (el_work_t *);
/**
* Enqueues work with argument and handle
*/
size_t
el_enqueue (el_t *, void *, el_work_handle_t);
/**
* Dequeues all queued work
*/
size_t
el_dequeue (el_t *);
/**
* Runs the event loop
*/
int
el_run (el_t *);
```
## license
MIT