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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
/*
* strbuf.c: A simple string buffer
*
* Copyright (c) 2006-2009 Dennis Stosberg <dennis@stosberg.net>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License,
* version 2 as published by the Free Software Foundation
*/
#ifndef STRBUF_H
#define STRBUF_H
#include "mem.h"
#include "zlib.h"
typedef struct strbuf {
char *data;
size_t len;
size_t buf_sz;
int opt;
} STRBUF;
enum strbuf_opt {
STRBUF_NULLOK = 1
};
/*
* Initialize a new empty string buffer.
*/
STRBUF *strbuf_new(void);
/*
* Free a string buffer.
*/
void strbuf_free(STRBUF *buf);
/*
* Appends the n first characters from str to the string buffer.
*
* Returns the new length of the string buffer.
*/
size_t strbuf_append_n(STRBUF *buf, const char *str, size_t n);
/*
* Appends str to the string buffer.
*
* Returns the new length of the string buffer.
*/
size_t strbuf_append(STRBUF *buf, const char *str);
/*
* Reads a zlib-compressed data stream from in and appends
* it to the buffer out. Returns the number of appended characters.
*/
size_t strbuf_append_inflate(STRBUF *buf, FILE *in);
/*
* Returns a pointer to the contained string.
*/
const char *strbuf_get(STRBUF *buf);
/*
* Returns the length of the contained string.
*/
size_t strbuf_len(STRBUF *buf);
/*
* Reallocs the data structure in the string buffer to use not more
* memory than necessary.
*/
void strbuf_shrink(STRBUF *buf);
/*
* Creates a string buffer from a *char without copying.
*/
STRBUF *strbuf_slurp(char *str);
STRBUF *strbuf_slurp_n(char *str, size_t len);
/*
* Returns the contained string and destroys the string buffer.
*/
char *strbuf_spit(STRBUF *buf);
/*
* Substitute characters in the string buffer buf from start
* (inclusive) to end (exclusive) and replace them with *subst. The
* first character in the string has the index 0.
*
* Returns the change of the length of the string contained at *buf.
* The return value is negative, if the string is shortened, zero if
* the length is unchanged and positive if the length increases.
*
* If start is bigger than stop, their values are automatically
* swapped.
*/
int strbuf_subst(STRBUF *buf, size_t start, size_t stop,
const char *subst);
/*
* Set options for the string buffer
*/
void strbuf_setopt(STRBUF *buf, enum strbuf_opt opt);
/*
* Unset an option for the string buffer
*/
void strbuf_unsetopt(STRBUF *buf, enum strbuf_opt opt);
/*
* Return the crc32 checksum of the buffer content.
*/
unsigned int strbuf_crc32(STRBUF *buf);
#endif /* STRBUF_H */
|
