err_queue Struct Reference

## Public Member Functions

struct err_queue * | err_queue_new (void)
| Initialize new error_queue. More...
bool | err_queue_push (struct err_queue *q, struct oscap_err_t *error)
| Push the new error at the end of the error queue. More...
struct oscap_err_t * | err_queue_pop_first (struct err_queue *q)
| Pop the first object from the FIFO queue. More...
struct oscap_err_t * | err_queue_get_last (struct err_queue *q)
| Return the last object from the FIFO queuqe. More...
void | err_queue_free (struct err_queue *q, oscap_destruct_func destructor)
| Dispose given err_queue. More...
int | err_queue_to_string (struct err_queue *q, char **result)
| Get all the errors in the queue as a single string. More...

## Data Fields

struct oscap_err_t * | first
struct oscap_err_t * | last

## Member Function Documentation

void err_queue_free | ( | struct err_queue * | q,
|  | oscap_destruct_func | destructor
| ) |  |

Dispose given err_queue.

Dispose also stored messages if destructor is supplied.

Parameters

  q | Internal Error Queue
  destructor | a function to dipose messages in the queue

struct oscap_err_t * err_queue_get_last | ( | struct err_queue * | q | ) |

read

Return the last object from the FIFO queuqe.

This object continues to be a property of err_queue and shall not be modified nor disposed.

Parameters

  q | Internal Error Queue

Returns
  the last item in the queue or NULL

struct err_queue * err_queue_new | ( | void |  | ) |

read

Initialize new error_queue.

Returns
  newly initialized error queue

struct oscap_err_t * err_queue_pop_first | ( | struct err_queue * | q | ) |

read

Pop the first object from the FIFO queue.

This new object is no longer tracked by err_queue and shall be disposed by caller.

Parameters

  q | Internal Error Queue

Returns
  The first item in the queue or NULL.

bool err_queue_push | ( | struct err_queue * | q,
|  | struct oscap_err_t * | error
| ) |  |

Push the new error at the end of the error queue.

Parameters

  q | Internal Error Queue
  error | new error to save in the queuei

Returns
  true on success

int err_queue_to_string | ( | struct err_queue * | q,
|  | char ** | result
| ) |  |

Get all the errors in the queue as a single string.

Parameters

  q | Internal Error Queue
  result | pointer, where to store the resulting string. Newly allocated mmory will be assigned with this. And shall be disposed by caller.

Returns
  zero on success

The documentation for this struct was generated from the following files:

- err_queue.c
- err_queue.h