/* -*-c-*-
*
- * $Id: dstr.h,v 1.5 1999/05/13 22:47:57 mdw Exp $
+ * $Id: dstr.h,v 1.6 1999/05/21 08:38:14 mdw Exp $
*
* Handle dynamically growing strings
*
/*----- Revision history --------------------------------------------------*
*
* $Log: dstr.h,v $
+ * Revision 1.6 1999/05/21 08:38:14 mdw
+ * Add some more macros, particularly for creation and destruction.
+ *
* Revision 1.5 1999/05/13 22:47:57 mdw
* Misc documentation fixes. Change `-ise' to `-ize' throughout.
*
#include <stdarg.h>
#include <stdio.h>
+#include <stdlib.h>
/*----- Data structures ---------------------------------------------------*/
size_t len; /* Length of the string */
} dstr;
+#define DSTR_INIT = { 0, 0, 0 }; /* How to initialize one */
+
/*----- Functions provided ------------------------------------------------*/
/* --- @dstr_create@ --- *
extern void dstr_create(dstr */*d*/);
+#define DCREATE(d) do { \
+ (d)->buf = 0; \
+ (d)->sz = 0; \
+ (d)->len = 0; \
+} while (0)
+
/* --- @dstr_destroy@ --- *
*
* Arguments: @dstr *d@ = pointer to a dynamic string block
extern void dstr_destroy(dstr */*d*/);
+#define DDESTROY(d) do { \
+ if ((d)->buf) free((d)->buf); \
+ DCREATE(d); \
+} while (0)
+
/* --- @dstr_reset@ --- *
*
* Arguments: @dstr *d@ = pointer to a dynaimc string block
extern void dstr_reset(dstr */*d*/);
+#define DRESET(d) do (d)->len = 0; while (0)
+
/* --- @dstr_ensure@ --- *
*
* Arguments: @dstr *d@ = pointer to a dynamic string block
extern size_t dstr_write(const dstr */*d*/, FILE */*fp*/);
+#define DWRITE(d, fp) fwrite((d)->buf, 1, (d)->len, (fp))
+
/*----- That's all, folks -------------------------------------------------*/
#ifdef __cplusplus