cc65/src/common/strbuf.h

102 lines
4.1 KiB
C
Raw Normal View History

/*****************************************************************************/
/* */
/* strbuf.h */
/* */
/* Variable sized string buffers */
/* */
/* */
/* */
/* (C) 2001 Ullrich von Bassewitz */
/* Wacholderweg 14 */
/* D-70597 Stuttgart */
/* EMail: uz@musoftware.de */
/* */
/* */
/* This software is provided 'as-is', without any expressed or implied */
/* warranty. In no event will the authors be held liable for any damages */
/* arising from the use of this software. */
/* */
/* Permission is granted to anyone to use this software for any purpose, */
/* including commercial applications, and to alter it and redistribute it */
/* freely, subject to the following restrictions: */
/* */
/* 1. The origin of this software must not be misrepresented; you must not */
/* claim that you wrote the original software. If you use this software */
/* in a product, an acknowledgment in the product documentation would be */
/* appreciated but is not required. */
/* 2. Altered source versions must be plainly marked as such, and must not */
/* be misrepresented as being the original software. */
/* 3. This notice may not be removed or altered from any source */
/* distribution. */
/* */
/*****************************************************************************/
#ifndef STRBUF_H
#define STRBUF_H
/*****************************************************************************/
/* Data */
/*****************************************************************************/
typedef struct StrBuf StrBuf;
struct StrBuf {
unsigned Allocated;
unsigned Len;
char* Buf;
};
/*****************************************************************************/
/* Code */
/*****************************************************************************/
StrBuf* InitStrBuf (StrBuf* B);
/* Initialize a string buffer */
void DoneStrBuf (StrBuf* B);
/* Free the data of a string buffer (but not the struct itself) */
StrBuf* NewStrBuf (void);
/* Allocate, initialize and return a new StrBuf */
void FreeStrBuf (StrBuf* B);
/* Free a string buffer */
void SB_Terminate (StrBuf* B);
/* Zero terminate the given string buffer. NOTE: The terminating zero is not
* accounted for in B->Len, if you want that, you have to use AppendChar!
*/
void SB_AppendChar (StrBuf* B, char C);
/* Append a character to a string buffer */
void SB_AppendStr (StrBuf* B, const char* S);
/* Append a string to the end of the string buffer */
void SB_AppendBuf (StrBuf* B, const char* S, unsigned Size);
/* Append a character buffer to the end of the string buffer */
void SB_Copy (StrBuf* Target, const StrBuf* Source);
/* Copy Source to Target, discarding the old contents of Target */
void SB_Append (StrBuf* Target, const StrBuf* Source);
/* Append the contents of Source to Target */
/* End of strbuf.h */
#endif