Notes

…

• Condition (variable), but not that monitor-based kind implemented in the STL.
• actually the same behavior as a manual-reset event

…

Include

Types

ao_cond_t

typedef struct ao_cond_t ao_cond_t;

Represents a condition.

ao_cond_wait_t

typedef struct ao_cond_wait_t ao_cond_wait_t;

Represents the waiting for a condition.

Structs

ao_cond_t

struct ao_cond_t
{
    bool      state;
    ao_list_t wait;
};

ao_cond_wait_t

struct ao_cond_wait_t
{
    ao_async_t     async;
    ao_cond_t *    cond;
    ao_list_node_t cond_wait_node;
    bool volatile  result;
};

Functions

ao_cond_false

void ao_cond_false(ao_cond_t * c);

Sets a condition to false.

ao_cond_true

void ao_cond_true(ao_cond_t * c);

Sets a condition to true.

ao_cond_wait

ao_cond_wait_from

bool ao_cond_wait     (ao_cond_t * c, ao_time_t timeout);
bool ao_cond_wait_from(ao_cond_t * c, ao_time_t timeout, ao_time_t beginning);

Waits for a condition in a blocking fashion with a timeout and an optional beginning.

ao_cond_wait_forever

bool ao_cond_wait_forever(ao_cond_t * c);

Waits for a condition indefinitely in a blocking fashion.

ao_cond_wait_try

bool ao_cond_wait_try(ao_cond_t * c);

Waits for a condition in a non-blocking fashion.

ao_cond_wait_begin

ao_cond_wait_end

void ao_cond_wait_begin(ao_cond_wait_t * w);
void ao_cond_wait_end  (ao_cond_wait_t * w);

Begins or ends, respectively, a waiting for a condition.