NAME¶

q_search - search for an entry in a smolq queue

LIBRARY¶

Librecast library (liblibrecast, -llibrecast)

SYNOPSIS¶

#include <librecast/q.h>

int  q_search(q_t *q, void *(*f)(void *), void *restrict arg);

Compile and link with -llibrecast.

DESCRIPTION¶

q_search() searches the queue q to find an entry that matches both f and arg.

No locks, so readers may read while we're searching, and writers may write. If something is read while we search, we will still return a positive match for that item, even though it is no longer in the queue. If a writer writes we will not notice that write. If this is a problem, for a particular use-case, an external lock will be required.

RETURN VALUE¶

The q_push() function returns 1 if found, zero if not found. On error, -1 is returned and errno is set to indicate the error.

ERRORS¶

The function can fail with any of the errors for sem_getvalue(3).

SEE ALSO¶

q_job_seek(3), q_pool_create(3), q_pool_destroy(3), q_init(3), q_free(3), q_push(3), q_wait(3), sem_getvalue(3).