stack.c File Reference

#include <inttypes.h>
#include <string.h>
#include <parserutils/utils/stack.h>
#include <stdio.h>

Include dependency graph for stack.c:

Classes
struct	parserutils_stack

Functions
parserutils_error	parserutils_stack_create (size_t item_size, size_t chunk_size, parserutils_stack **stack)
parserutils_error	parserutils_stack_destroy (parserutils_stack *stack)
parserutils_error	parserutils_stack_push (parserutils_stack *stack, const void *item)
parserutils_error	parserutils_stack_pop (parserutils_stack *stack, void *item)
void *	parserutils_stack_get_current (parserutils_stack *stack)
void	parserutils_stack_dump (parserutils_stack *stack, const char *prefix, void(*printer)(void *item))

Function Documentation

parserutils_stack_create()

parserutils_error parserutils_stack_create	(	size_t	item_size,
		size_t	chunk_size,
		parserutils_stack **	stack
	)

Create a stack

Parameters

item_size	Length, in bytes, of an item in the stack
chunk_size	Number of stack slots in a chunk
stack	Pointer to location to receive stack instance

Returns

PARSERUTILS_OK on success, PARSERUTILS_BADPARM on bad parameters PARSERUTILS_NOMEM on memory exhaustion

parserutils_stack_destroy()

parserutils_error parserutils_stack_destroy

(

parserutils_stack *

stack

)

Destroy a stack instance

Parameters

stack

The stack to destroy

Returns

PARSERUTILS_OK on success, appropriate error otherwise.

parserutils_stack_dump()

void parserutils_stack_dump ( parserutils_stack *  stack, const char *  prefix, void(*)(void *item)  printer  )

extern

parserutils_stack_get_current()

void * parserutils_stack_get_current

(

parserutils_stack *

stack

)

Retrieve a pointer to the current item on the stack

Parameters

stack

The stack to inspect

Returns

Pointer to item on stack, or NULL if none

parserutils_stack_pop()

parserutils_error parserutils_stack_pop	(	parserutils_stack *	stack,
		void *	item
	)

Pop an item off a stack

Parameters

stack	The stack to pop from
item	Pointer to location to receive popped item, or NULL

Returns

PARSERUTILS_OK on success, appropriate error otherwise.

parserutils_stack_push()

parserutils_error parserutils_stack_push	(	parserutils_stack *	stack,
		const void *	item
	)

Push an item onto the stack

Parameters

stack	The stack to push onto
item	The item to push

Returns

PARSERUTILS_OK on success, appropriate error otherwise