annotate libcore/core/rbuf.c @ 165:eb3148c1e54d

core: add state functions
author David Demelier <markand@malikania.fr>
date Mon, 19 Oct 2020 08:10:21 +0200
parents 789b23e01f52
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
120
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * rbuf.c -- basic utility for reading input buffers
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 *
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 * Copyright (c) 2020 David Demelier <markand@malikania.fr>
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 *
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * Permission to use, copy, modify, and/or distribute this software for any
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 * purpose with or without fee is hereby granted, provided that the above
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 * copyright notice and this permission notice appear in all copies.
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 *
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 */
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 #include <assert.h>
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
20
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 #include "rbuf.h"
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
22
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 void
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 rbuf_open(struct rbuf *rb, const void *data, size_t datasz)
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 {
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 assert(rb);
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 assert(data);
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
28
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 rb->s = data;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 rb->e = rb->s + datasz;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 }
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
32
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 bool
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 rbuf_readline(struct rbuf *rb, char *output, size_t outputsz)
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 {
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 assert(rb);
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 assert(output);
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 assert(outputsz > 0);
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
39
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 if (rb->s == rb->e)
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 return false;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
42
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 for (--outputsz; rb->s != rb->e && *rb->s != '\n' && outputsz; outputsz--)
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 *output++ = *rb->s++;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
45
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 /* Not enough space? */
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 if (!outputsz && rb->s != rb->e && *rb->s != '\n')
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 return false;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
49
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 /* Remove this '\n' if still present. */
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 if (rb->s != rb->e && *rb->s == '\n')
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 rb->s++;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
53
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 *output = '\0';
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
55
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 return true;
b3429b26d60d core: add rbuf utility, closes #2488 @2h
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 }