blob: e9deb2b82a2cf29abeba03e592aa153715c862c3 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
/* $Id: buffer.h 6295 2003-04-16 05:46:38Z rra $
**
** Counted, reusable memory buffer.
**
** A buffer is an allocated bit of memory with a known size and a separate
** data length. It's intended to store strings and can be reused repeatedly
** to minimize the number of memory allocations. Buffers increase in
** increments of 1K.
**
** A buffer contains a notion of the data that's been used and the data
** that's been left, used when the buffer is an I/O buffer where lots of data
** is buffered and then slowly processed out of the buffer. The total length
** of the data is used + left. If a buffer is just used to store some data,
** used can be set to 0 and left stores the length of the data.
*/
#ifndef INN_BUFFER_H
#define INN_BUFFER_H 1
#include <inn/defines.h>
struct buffer {
size_t size; /* Total allocated length. */
size_t used; /* Data already used. */
size_t left; /* Remaining unused data. */
char *data; /* Pointer to allocated memory. */
};
BEGIN_DECLS
/* Allocate a new buffer and initialize its contents. */
struct buffer *buffer_new(void);
/* Resize a buffer to be at least as large as the provided size. */
void buffer_resize(struct buffer *, size_t);
/* Set the buffer contents, ignoring anything currently there. */
void buffer_set(struct buffer *, const char *data, size_t length);
/* Append data to the buffer. */
void buffer_append(struct buffer *, const char *data, size_t length);
/* Swap the contents of two buffers. */
void buffer_swap(struct buffer *, struct buffer *);
END_DECLS
#endif /* INN_BUFFER_H */
|
