2 * Copyright (c) 2005 Max Okumoto
3 * Copyright (c) 1988, 1989, 1990, 1993
4 * The Regents of the University of California. All rights reserved.
5 * Copyright (c) 1988, 1989 by Adam de Boor
6 * Copyright (c) 1989 by Berkeley Softworks
9 * This code is derived from software contributed to Berkeley by
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
20 * 3. All advertising materials mentioning features or use of this software
21 * must display the following acknowledgement:
22 * This product includes software developed by the University of
23 * California, Berkeley and its contributors.
24 * 4. Neither the name of the University nor the names of its contributors
25 * may be used to endorse or promote products derived from this software
26 * without specific prior written permission.
28 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
29 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
34 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
35 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
40 * @(#)buf.c 8.1 (Berkeley) 6/6/93
41 * $FreeBSD: src/usr.bin/make/buf.c,v 1.32 2005/02/07 11:27:47 harti Exp $
42 * $DragonFly: src/usr.bin/make/buf.c,v 1.38 2005/05/05 09:06:23 okumoto Exp $
47 * Functions for automatically-expanded buffers.
57 * Returns the number of bytes in the buffer. Doesn't include the
58 * null-terminating byte.
60 * @return The number of bytes in Buffer object.
63 Buf_Size(const Buffer *buf)
66 return (buf->end - buf->buf);
70 * Returns a reference to the data contained in the buffer.
72 * @note Adding data to the Buffer object may invalidate the reference.
75 Buf_Data(const Buffer *bp)
82 * Expand the buffer to hold the number of additional bytes, plus
83 * space to store a terminating NULL byte.
86 BufExpand(Buffer *bp, size_t nb)
88 size_t len = Buf_Size(bp);
89 if (bp->size < len + nb + 1) {
90 int size = bp->size + MAX(nb + 1, BUF_ADD_INC);
92 bp->buf = erealloc(bp->buf, size);
94 bp->end = bp->buf + len;
99 * Add a single byte to the buffer.
102 Buf_AddByte(Buffer *bp, Byte byte)
113 * Add bytes to the buffer.
116 Buf_AddBytes(Buffer *bp, size_t len, const Byte *bytes)
120 memcpy(bp->end, bytes, len);
126 * Get a reference to the internal buffer.
128 * @param len Pointer to where we return the number of bytes in
129 * the internal buffer.
131 * @return A pointer to the data.
134 Buf_GetAll(Buffer *bp, size_t *len)
144 * Get the contents of a buffer and destroy the buffer. If the buffer
145 * is NULL, return NULL.
148 * the pointer to the data.
163 * Initialize a buffer. If no initial size is given, a reasonable
166 * @return A buffer object to be given to other functions in this library.
169 * Space is allocated for the Buffer object and a internal buffer.
172 Buf_Init(size_t size)
174 Buffer *bp; /* New Buffer */
179 bp = emalloc(sizeof(*bp));
181 bp->buf = emalloc(size);
189 * Destroy a buffer, and optionally free its data, too.
192 * Space for the Buffer object and possibly the internal buffer
196 Buf_Destroy(Buffer *buf, Boolean freeData)
205 * Replace the last byte in a buffer. If the buffer was empty
206 * intially, then a new byte will be added.
209 Buf_ReplaceLastByte(Buffer *bp, Byte byte)
212 if (bp->end == bp->buf) {
213 Buf_AddByte(bp, byte);
215 *(bp->end - 1) = byte;
220 * Append characters in str to Buffer object
223 Buf_Append(Buffer *bp, const char str[])
226 Buf_AddBytes(bp, strlen(str), str);
230 * Append characters in buf to Buffer object
233 Buf_AppendBuf(Buffer *bp, const Buffer *buf)
236 Buf_AddBytes(bp, Buf_Size(buf), buf->buf);
240 * Append characters between str and end to Buffer object.
243 Buf_AppendRange(Buffer *bp, const char str[], const char *end)
246 Buf_AddBytes(bp, end - str, str);
250 * Convert newlines in buffer to spaces. The trailing newline is
254 Buf_StripNewlines(Buffer *bp)
259 * If there is anything in the buffer, remove the last
262 if (ptr != bp->buf) {
263 if (*(ptr - 1) == '\n') {
271 /* Convert newline characters to a space characters. */
272 while (ptr != bp->buf) {
281 * Clear the contents of the buffer.
284 Buf_Clear(Buffer *bp)