documentation: user-manual: update "using-bisect" section
[git/git-p4.git] / strbuf.c
blob720737d856b694bc5239f0c18af372959c99e744
1 #include "cache.h"
3 int prefixcmp(const char *str, const char *prefix)
5 for (; ; str++, prefix++)
6 if (!*prefix)
7 return 0;
8 else if (*str != *prefix)
9 return (unsigned char)*prefix - (unsigned char)*str;
13 * Used as the default ->buf value, so that people can always assume
14 * buf is non NULL and ->buf is NUL terminated even for a freshly
15 * initialized strbuf.
17 char strbuf_slopbuf[1];
19 void strbuf_init(struct strbuf *sb, size_t hint)
21 sb->alloc = sb->len = 0;
22 sb->buf = strbuf_slopbuf;
23 if (hint)
24 strbuf_grow(sb, hint);
27 void strbuf_release(struct strbuf *sb)
29 if (sb->alloc) {
30 free(sb->buf);
31 strbuf_init(sb, 0);
35 char *strbuf_detach(struct strbuf *sb, size_t *sz)
37 char *res = sb->alloc ? sb->buf : NULL;
38 if (sz)
39 *sz = sb->len;
40 strbuf_init(sb, 0);
41 return res;
44 void strbuf_attach(struct strbuf *sb, void *buf, size_t len, size_t alloc)
46 strbuf_release(sb);
47 sb->buf = buf;
48 sb->len = len;
49 sb->alloc = alloc;
50 strbuf_grow(sb, 0);
51 sb->buf[sb->len] = '\0';
54 void strbuf_grow(struct strbuf *sb, size_t extra)
56 if (sb->len + extra + 1 <= sb->len)
57 die("you want to use way too much memory");
58 if (!sb->alloc)
59 sb->buf = NULL;
60 ALLOC_GROW(sb->buf, sb->len + extra + 1, sb->alloc);
63 void strbuf_trim(struct strbuf *sb)
65 char *b = sb->buf;
66 while (sb->len > 0 && isspace((unsigned char)sb->buf[sb->len - 1]))
67 sb->len--;
68 while (sb->len > 0 && isspace(*b)) {
69 b++;
70 sb->len--;
72 memmove(sb->buf, b, sb->len);
73 sb->buf[sb->len] = '\0';
75 void strbuf_rtrim(struct strbuf *sb)
77 while (sb->len > 0 && isspace((unsigned char)sb->buf[sb->len - 1]))
78 sb->len--;
79 sb->buf[sb->len] = '\0';
82 void strbuf_ltrim(struct strbuf *sb)
84 char *b = sb->buf;
85 while (sb->len > 0 && isspace(*b)) {
86 b++;
87 sb->len--;
89 memmove(sb->buf, b, sb->len);
90 sb->buf[sb->len] = '\0';
93 void strbuf_tolower(struct strbuf *sb)
95 int i;
96 for (i = 0; i < sb->len; i++)
97 sb->buf[i] = tolower(sb->buf[i]);
100 struct strbuf **strbuf_split(const struct strbuf *sb, int delim)
102 int alloc = 2, pos = 0;
103 char *n, *p;
104 struct strbuf **ret;
105 struct strbuf *t;
107 ret = xcalloc(alloc, sizeof(struct strbuf *));
108 p = n = sb->buf;
109 while (n < sb->buf + sb->len) {
110 int len;
111 n = memchr(n, delim, sb->len - (n - sb->buf));
112 if (pos + 1 >= alloc) {
113 alloc = alloc * 2;
114 ret = xrealloc(ret, sizeof(struct strbuf *) * alloc);
116 if (!n)
117 n = sb->buf + sb->len - 1;
118 len = n - p + 1;
119 t = xmalloc(sizeof(struct strbuf));
120 strbuf_init(t, len);
121 strbuf_add(t, p, len);
122 ret[pos] = t;
123 ret[++pos] = NULL;
124 p = ++n;
126 return ret;
129 void strbuf_list_free(struct strbuf **sbs)
131 struct strbuf **s = sbs;
133 while (*s) {
134 strbuf_release(*s);
135 free(*s++);
137 free(sbs);
140 int strbuf_cmp(const struct strbuf *a, const struct strbuf *b)
142 int cmp;
143 if (a->len < b->len) {
144 cmp = memcmp(a->buf, b->buf, a->len);
145 return cmp ? cmp : -1;
146 } else {
147 cmp = memcmp(a->buf, b->buf, b->len);
148 return cmp ? cmp : a->len != b->len;
152 void strbuf_splice(struct strbuf *sb, size_t pos, size_t len,
153 const void *data, size_t dlen)
155 if (pos + len < pos)
156 die("you want to use way too much memory");
157 if (pos > sb->len)
158 die("`pos' is too far after the end of the buffer");
159 if (pos + len > sb->len)
160 die("`pos + len' is too far after the end of the buffer");
162 if (dlen >= len)
163 strbuf_grow(sb, dlen - len);
164 memmove(sb->buf + pos + dlen,
165 sb->buf + pos + len,
166 sb->len - pos - len);
167 memcpy(sb->buf + pos, data, dlen);
168 strbuf_setlen(sb, sb->len + dlen - len);
171 void strbuf_insert(struct strbuf *sb, size_t pos, const void *data, size_t len)
173 strbuf_splice(sb, pos, 0, data, len);
176 void strbuf_remove(struct strbuf *sb, size_t pos, size_t len)
178 strbuf_splice(sb, pos, len, NULL, 0);
181 void strbuf_add(struct strbuf *sb, const void *data, size_t len)
183 strbuf_grow(sb, len);
184 memcpy(sb->buf + sb->len, data, len);
185 strbuf_setlen(sb, sb->len + len);
188 void strbuf_adddup(struct strbuf *sb, size_t pos, size_t len)
190 strbuf_grow(sb, len);
191 memcpy(sb->buf + sb->len, sb->buf + pos, len);
192 strbuf_setlen(sb, sb->len + len);
195 void strbuf_addf(struct strbuf *sb, const char *fmt, ...)
197 int len;
198 va_list ap;
200 if (!strbuf_avail(sb))
201 strbuf_grow(sb, 64);
202 va_start(ap, fmt);
203 len = vsnprintf(sb->buf + sb->len, sb->alloc - sb->len, fmt, ap);
204 va_end(ap);
205 if (len < 0)
206 die("your vsnprintf is broken");
207 if (len > strbuf_avail(sb)) {
208 strbuf_grow(sb, len);
209 va_start(ap, fmt);
210 len = vsnprintf(sb->buf + sb->len, sb->alloc - sb->len, fmt, ap);
211 va_end(ap);
212 if (len > strbuf_avail(sb)) {
213 die("this should not happen, your snprintf is broken");
216 strbuf_setlen(sb, sb->len + len);
219 void strbuf_expand(struct strbuf *sb, const char *format, expand_fn_t fn,
220 void *context)
222 for (;;) {
223 const char *percent;
224 size_t consumed;
226 percent = strchrnul(format, '%');
227 strbuf_add(sb, format, percent - format);
228 if (!*percent)
229 break;
230 format = percent + 1;
232 consumed = fn(sb, format, context);
233 if (consumed)
234 format += consumed;
235 else
236 strbuf_addch(sb, '%');
240 size_t strbuf_fread(struct strbuf *sb, size_t size, FILE *f)
242 size_t res;
244 strbuf_grow(sb, size);
245 res = fread(sb->buf + sb->len, 1, size, f);
246 if (res > 0) {
247 strbuf_setlen(sb, sb->len + res);
249 return res;
252 ssize_t strbuf_read(struct strbuf *sb, int fd, size_t hint)
254 size_t oldlen = sb->len;
256 strbuf_grow(sb, hint ? hint : 8192);
257 for (;;) {
258 ssize_t cnt;
260 cnt = xread(fd, sb->buf + sb->len, sb->alloc - sb->len - 1);
261 if (cnt < 0) {
262 strbuf_setlen(sb, oldlen);
263 return -1;
265 if (!cnt)
266 break;
267 sb->len += cnt;
268 strbuf_grow(sb, 8192);
271 sb->buf[sb->len] = '\0';
272 return sb->len - oldlen;
275 int strbuf_getline(struct strbuf *sb, FILE *fp, int term)
277 int ch;
279 strbuf_grow(sb, 0);
280 if (feof(fp))
281 return EOF;
283 strbuf_reset(sb);
284 while ((ch = fgetc(fp)) != EOF) {
285 if (ch == term)
286 break;
287 strbuf_grow(sb, 1);
288 sb->buf[sb->len++] = ch;
290 if (ch == EOF && sb->len == 0)
291 return EOF;
293 sb->buf[sb->len] = '\0';
294 return 0;
297 int strbuf_read_file(struct strbuf *sb, const char *path, size_t hint)
299 int fd, len;
301 fd = open(path, O_RDONLY);
302 if (fd < 0)
303 return -1;
304 len = strbuf_read(sb, fd, hint);
305 close(fd);
306 if (len < 0)
307 return -1;
309 return len;