Libparserutils
buffer.h File Reference

Go to the source code of this file.

Data Structures

struct  parserutils_buffer
 

Typedefs

typedef struct parserutils_buffer parserutils_buffer
 

Functions

parserutils_error parserutils_buffer_create (parserutils_buffer **buffer)
 Create a memory buffer.
 
parserutils_error parserutils_buffer_destroy (parserutils_buffer *buffer)
 Destroy a memory buffer.
 
parserutils_error parserutils_buffer_append (parserutils_buffer *buffer, const uint8_t *data, size_t len)
 Append data to a memory buffer.
 
parserutils_error parserutils_buffer_appendv (parserutils_buffer *buffer, size_t count,...)
 Append multiple data blocks to a memory buffer.
 
parserutils_error parserutils_buffer_insert (parserutils_buffer *buffer, size_t offset, const uint8_t *data, size_t len)
 Insert data into a memory buffer.
 
parserutils_error parserutils_buffer_discard (parserutils_buffer *buffer, size_t offset, size_t len)
 Discard a section of a memory buffer.
 
parserutils_error parserutils_buffer_grow (parserutils_buffer *buffer)
 Extend the amount of space allocated for a memory buffer.
 
parserutils_error parserutils_buffer_randomise (parserutils_buffer *buffer)
 

Typedef Documentation

◆ parserutils_buffer

typedef struct parserutils_buffer parserutils_buffer

Definition at line 26 of file buffer.h.

Function Documentation

◆ parserutils_buffer_append()

parserutils_error parserutils_buffer_append ( parserutils_buffer * buffer,
const uint8_t * data,
size_t len )

Append data to a memory buffer.

Parameters
bufferThe buffer to append to
dataThe data to append
lenThe length, in bytes, of the data to append
Returns
PARSERUTILS_OK on success, appropriate error otherwise.

Definition at line 120 of file buffer.c.

References parserutils_buffer::data, ensure_space(), len, parserutils_buffer::length, and PARSERUTILS_OK.

Referenced by parserutils_buffer_appendv(), parserutils_buffer_insert(), and parserutils_inputstream_append().

◆ parserutils_buffer_appendv()

parserutils_error parserutils_buffer_appendv ( parserutils_buffer * buffer,
size_t count,
... )

Append multiple data blocks to a memory buffer.

Each data block must be passed as a pair of const uint8_t* and size_t

Parameters
bufferThe buffer to append to
countThe number of data blocks to append
...The pairs of pointer and size
Returns
PARSERUTILS_OK on success, appropriate error otherwise.

Definition at line 144 of file buffer.c.

References len, parserutils_buffer_append(), and PARSERUTILS_OK.

◆ parserutils_buffer_create()

parserutils_error parserutils_buffer_create ( parserutils_buffer ** buffer)

Create a memory buffer.

Parameters
bufferPointer to location to receive memory buffer
Returns
PARSERUTILS_OK on success, PARSERUTILS_BADPARM on bad parameters, PARSERUTILS_NOMEM on memory exhausion

Definition at line 23 of file buffer.c.

References parserutils_buffer::alloc, parserutils_buffer::allocated, parserutils_buffer::data, DEFAULT_SIZE, parserutils_buffer::length, PARSERUTILS_BADPARM, PARSERUTILS_NOMEM, and PARSERUTILS_OK.

Referenced by parserutils_inputstream_create().

◆ parserutils_buffer_destroy()

parserutils_error parserutils_buffer_destroy ( parserutils_buffer * buffer)

Destroy a memory buffer.

Parameters
bufferThe buffer to destroy
Returns
PARSERUTILS_OK on success, appropriate error otherwise

Definition at line 55 of file buffer.c.

References parserutils_buffer::alloc, PARSERUTILS_BADPARM, and PARSERUTILS_OK.

Referenced by parserutils_inputstream_create(), and parserutils_inputstream_destroy().

◆ parserutils_buffer_discard()

parserutils_error parserutils_buffer_discard ( parserutils_buffer * buffer,
size_t offset,
size_t len )

Discard a section of a memory buffer.

Parameters
bufferThe buffer to discard data from
offsetThe offset into the buffer of the start of the section
lenThe number of bytes to discard
Returns
PARSERUTILS_OK on success, appropriate error otherwise.

Definition at line 208 of file buffer.c.

References parserutils_buffer::data, len, parserutils_buffer::length, PARSERUTILS_BADPARM, PARSERUTILS_OK, and try_rebase().

Referenced by parserutils_inputstream_refill_buffer(), and parserutils_inputstream_strip_bom().

◆ parserutils_buffer_grow()

parserutils_error parserutils_buffer_grow ( parserutils_buffer * buffer)

Extend the amount of space allocated for a memory buffer.

Parameters
bufferThe buffer to extend
Returns
PARSERUTILS_OK on success, appropriate error otherwise.

Definition at line 235 of file buffer.c.

References parserutils_buffer::alloc, parserutils_buffer::allocated, parserutils_buffer::data, get_offset(), PARSERUTILS_NOMEM, and PARSERUTILS_OK.

Referenced by ensure_space(), and parserutils_inputstream_refill_buffer().

◆ parserutils_buffer_insert()

parserutils_error parserutils_buffer_insert ( parserutils_buffer * buffer,
size_t offset,
const uint8_t * data,
size_t len )

Insert data into a memory buffer.

Parameters
bufferThe buffer to insert into
offsetThe offset into the buffer to insert at
dataThe data to insert
lenThe length, in bytes, of the data to insert
Returns
PARSERUTILS_OK on success, appropriate error otherwise

Definition at line 175 of file buffer.c.

References parserutils_buffer::data, ensure_space(), len, parserutils_buffer::length, PARSERUTILS_BADPARM, parserutils_buffer_append(), and PARSERUTILS_OK.

Referenced by parserutils_inputstream_insert().

◆ parserutils_buffer_randomise()