@@@ tvec setvar

[mLib] / struct / buf.c

diff --git a/struct/buf.c b/struct/buf.c
index 11b1425b0d1623d4f4edab7b6a574da5f3836f7f..9efc4fcecbd59b37d1a13e7168f2e51ce13489e1 100644 (file)
--- a/struct/buf.c
+++ b/struct/buf.c
@@ -37,7 +37,7 @@
 
 /* --- @buf_init@ --- *
  *
 
 /* --- @buf_init@ --- *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @void *p@ = pointer to a buffer
  *             @size_t sz@ = size of the buffer
  *
  *             @void *p@ = pointer to a buffer
  *             @size_t sz@ = size of the buffer
  *


@@ -53,9 +53,51 @@ void buf_init(buf *b, void *p, size_t sz)
   b->f = 0;
 }
 
   b->f = 0;
 }
 

-/* --- @buf_break@ --- *
+/* --- @dbuf_create@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @dbuf *db@ = pointer to a dynamic buffer block
+ *
+ * Returns:    ---
+ *
+ * Use:                Initializes a dynamic buffer.  The buffer is initially empty,
+ *             and ready for writing.
+ */
+
+void dbuf_create(dbuf *db)
+{
+  db->_b.base = db->_b.p = db->_b.limit = 0; db->_b.f = BF_ALLOC | BF_WRITE;
+  db->a = &arena_stdlib; db->sz = 0;
+}
+
+/* --- @dbuf_reset@ --- *
+ *
+ * Arguments:  @dbuf *db@ = pointer to a buffer block
+ *
+ * Returns:    ---
+ *
+ * Use:                Resets a buffer so that it can be written again.
+ */
+
+void dbuf_reset(dbuf *db) { DBRESET(db); }
+
+/* --- @dbuf_destroy@ --- *
+ *
+ * Arguments:  @dbuf *db@ = pointer to a buffer block
+ *
+ * Returns:    ---
+ *
+ * Use:                Release all of the resources held by a dynamic buffer.
+ */
+
+void dbuf_destroy(dbuf *db)
+{
+  if (db->_b.base) x_free(db->a, db->_b.base);
+  dbuf_create(db);
+}
+
+/* --- @{,d}buf_break@ --- *
+ *
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *
  * Returns:    Some negative value.
  *
  *
  * Returns:    Some negative value.
  *


@@ -63,10 +105,11 @@ void buf_init(buf *b, void *p, size_t sz)
  */
 
 int buf_break(buf *b) { b->f |= BF_BROKEN; return (-1); }
  */
 
 int buf_break(buf *b) { b->f |= BF_BROKEN; return (-1); }

+int (dbuf_break)(dbuf *db) { return (dbuf_break(db)); }

 
 

-/* --- @buf_flip@ --- *
+/* --- @{,d}buf_flip@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *
  * Returns:    ---
  *
  *
  * Returns:    ---
  *


@@ -74,15 +117,12 @@ int buf_break(buf *b) { b->f |= BF_BROKEN; return (-1); }
  *             you can now read from the bit you've written.
  */
 
  *             you can now read from the bit you've written.
  */
 

-void buf_flip(buf *b)
-{
-  b->limit = b->p;
-  b->p = b->base;
-}
+void buf_flip(buf *b) { BFLIP(b); }
+void (dbuf_flip)(dbuf *db) { dbuf_flip(db); }

 
 

-/* --- @buf_ensure@ --- *
+/* --- @{,d}buf_ensure@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @size_t sz@ = size of data wanted
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.
  *             @size_t sz@ = size of data wanted
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.


@@ -91,10 +131,46 @@ void buf_flip(buf *b)
  */
 
 int buf_ensure(buf *b, size_t sz) { return (BENSURE(b, sz)); }
  */
 
 int buf_ensure(buf *b, size_t sz) { return (BENSURE(b, sz)); }

+int (dbuf_ensure)(dbuf *db, size_t sz) { return (dbuf_ensure(db, sz)); }
+
+/* --- @{,d}buf_tryextend@ --- *
+ *
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block
+ *             @size_t sz@ = size of data wanted
+ *
+ * Returns:    Zero if it worked, nonzero if the buffer won't grow.
+ *
+ * Use:                Extend the buffer so that at least @sz@ bytes are available.
+ *             This only works if the buffer is allocated.
+ */
+
+int buf_tryextend(buf *b, size_t sz)
+{
+  dbuf *db;
+  size_t newsz, len;
+
+  if (~b->f&(BF_ALLOC | BF_WRITE))
+    { b->f |= BF_BROKEN; return (-1); }
+  db = (dbuf *)b;
+  len = BLEN(&db->_b); sz += len;
+  if (db->sz >= sz)
+    newsz = db->sz;
+  else {
+    newsz = db->sz ? 2*db->sz : 64;
+    while (newsz < sz) { assert(newsz < ((size_t)-1)/2); newsz *= 2; }
+    if (!db->_b.base) db->_b.base = x_alloc(db->a, newsz);
+    else db->_b.base = x_realloc(db->a, db->_b.base, newsz, db->sz);
+    db->_b.p = db->_b.base + len; db->sz = newsz;
+  }
+  db->_b.limit = db->_b.base + newsz;
+  return (0);
+}
+int (dbuf_tryextend)(dbuf *db, size_t sz)
+  { return (dbuf_tryextend(db, sz)); }

 
 

-/* --- @buf_get@ --- *
+/* --- @{,d}buf_get@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @size_t sz@ = size of the buffer
  *
  * Returns:    Pointer to the place in the buffer.
  *             @size_t sz@ = size of the buffer
  *
  * Returns:    Pointer to the place in the buffer.


@@ -112,10 +188,12 @@ void *buf_get(buf *b, size_t sz)
   BSTEP(b, sz);
   return (p);
 }
   BSTEP(b, sz);
   return (p);
 }

+void *(dbuf_get)(dbuf *db, size_t sz)
+  { return (dbuf_get(db, sz)); }

 
 

-/* --- @buf_put@ --- *
+/* --- @{,d}buf_put@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @const void *p@ = pointer to a buffer
  *             @size_t sz@ = size of the buffer
  *
  *             @const void *p@ = pointer to a buffer
  *             @size_t sz@ = size of the buffer
  *


@@ -132,10 +210,12 @@ int buf_put(buf *b, const void *p, size_t sz)
   BSTEP(b, sz);
   return (0);
 }
   BSTEP(b, sz);
   return (0);
 }

+int (dbuf_put)(dbuf *db, const void *p, size_t sz)
+  { return (dbuf_put(db, p, sz)); }

 
 

-/* --- @buf_getbyte@ --- *
+/* --- @{,d}buf_getbyte@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *
  * Returns:    A byte, or less than zero if there wasn't a byte there.
  *
  *
  * Returns:    A byte, or less than zero if there wasn't a byte there.
  *


@@ -148,10 +228,12 @@ int buf_getbyte(buf *b)
     return (-1);
   return (*b->p++);
 }
     return (-1);
   return (*b->p++);
 }

+int (dbuf_getbyte)(dbuf *db)
+  { return (dbuf_getbyte(db)); }

 
 

-/* --- @buf_putbyte@ --- *
+/* --- @{,d}buf_putbyte@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @int ch@ = byte to write
  *
  * Returns:    Zero if OK, nonzero if there wasn't enough space.
  *             @int ch@ = byte to write
  *
  * Returns:    Zero if OK, nonzero if there wasn't enough space.


@@ -166,10 +248,12 @@ int buf_putbyte(buf *b, int ch)
   *b->p++ = ch;
   return (0);
 }
   *b->p++ = ch;
   return (0);
 }

+int (dbuf_putbyte)(dbuf *db, int ch)
+  { return (dbuf_putbyte(db, ch)); }

 
 

-/* --- @buf_getu{8,{16,24,32,64}{,l,b}}@ --- *
+/* --- @{,d}buf_getu{8,{16,24,32,64}{,l,b}}@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @uintSZ *w@ = where to put the word
  *
  * Returns:    Zero if OK, or nonzero if there wasn't a word there.
  *             @uintSZ *w@ = where to put the word
  *
  * Returns:    Zero if OK, or nonzero if there wasn't a word there.


@@ -184,12 +268,14 @@ int buf_putbyte(buf *b, int ch)
     *ww = LOAD##W(b->p);                                               \
     BSTEP(b, SZ_##W);                                                  \
     return (0);                                                                \
     *ww = LOAD##W(b->p);                                               \
     BSTEP(b, SZ_##W);                                                  \
     return (0);                                                                \

-  }
+  }                                                                    \
+  int (dbuf_getu##w)(dbuf *db, uint##n *ww)                            \
+    { return (dbuf_getu##w(db, ww)); }

 DOUINTCONV(BUF_GETU_)
 
 DOUINTCONV(BUF_GETU_)
 

-/* --- @buf_getk64{,l,b}@ --- *
+/* --- @{,d}buf_getk64{,l,b}@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @kludge64 *w@ = where to put the word
  *
  * Returns:    Zero if OK, or nonzero if there wasn't a word there.
  *             @kludge64 *w@ = where to put the word
  *
  * Returns:    Zero if OK, or nonzero if there wasn't a word there.


@@ -215,9 +301,13 @@ int buf_getk64b(buf *b, kludge64 *w)
   LOAD64_B_(*w, b->p); BSTEP(b, 8); return (0);
 }
 
   LOAD64_B_(*w, b->p); BSTEP(b, 8); return (0);
 }
 

-/* --- @buf_putu{8,{16,24,32,64}{,l,b}}@ --- *
+int (dbuf_getk64)(dbuf *db, kludge64 *w) { return (dbuf_getk64(db, w)); }
+int (dbuf_getk64l)(dbuf *db, kludge64 *w) { return (dbuf_getk64l(db, w)); }
+int (dbuf_getk64b)(dbuf *db, kludge64 *w) { return (dbuf_getk64b(db, w)); }
+
+/* --- @{,d}buf_putu{8,{16,24,32,64}{,l,b}}@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @uintSZ w@ = word to write
  *
  * Returns:    Zero if OK, or nonzero if there wasn't enough space
  *             @uintSZ w@ = word to write
  *
  * Returns:    Zero if OK, or nonzero if there wasn't enough space


@@ -232,12 +322,14 @@ int buf_getk64b(buf *b, kludge64 *w)
     STORE##W(b->p, ww);                                                        \
     BSTEP(b, SZ_##W);                                                  \
     return (0);                                                                \
     STORE##W(b->p, ww);                                                        \
     BSTEP(b, SZ_##W);                                                  \
     return (0);                                                                \

-  }
+  }                                                                    \
+  int (dbuf_putu##w)(dbuf *db, uint##n ww)                             \
+    { return (dbuf_putu##w(db, ww)); }

 DOUINTCONV(BUF_PUTU_)
 
 DOUINTCONV(BUF_PUTU_)
 

-/* --- @buf_putk64{,l,b}@ --- *
+/* --- @{,d}buf_putk64{,l,b}@ --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @kludge64 w@ = word to write
  *
  * Returns:    Zero if OK, or nonzero if there wasn't enough space
  *             @kludge64 w@ = word to write
  *
  * Returns:    Zero if OK, or nonzero if there wasn't enough space


@@ -263,9 +355,13 @@ int buf_putk64b(buf *b, kludge64 w)
   STORE64_B_(b->p, w); BSTEP(b, 8); return (0);
 }
 
   STORE64_B_(b->p, w); BSTEP(b, 8); return (0);
 }
 

+int (dbuf_putk64)(dbuf *db, kludge64 w) { return (dbuf_putk64(db, w)); }
+int (dbuf_putk64l)(dbuf *db, kludge64 w) { return (dbuf_putk64l(db, w)); }
+int (dbuf_putk64b)(dbuf *db, kludge64 w) { return (dbuf_putk64b(db, w)); }
+

 /* --- @findz@ --- *
  *
 /* --- @findz@ --- *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @size_t *nn@ = where to put the length
  *
  * Returns:    Zero if OK, nonzero if there wasn't a null byte to be found.
  *             @size_t *nn@ = where to put the length
  *
  * Returns:    Zero if OK, nonzero if there wasn't a null byte to be found.


@@ -286,9 +382,9 @@ static int findz(buf *b, size_t *nn)
   return (0);
 }
 
   return (0);
 }
 

-/* --- @buf_getmem{8,{16,24,32,64}{,l,b},z} --- *
+/* --- @{,d}buf_getmem{8,{16,24,32,64}{,l,b},z} --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @size_t *nn@ = where to put the length
  *
  * Returns:    Pointer to the buffer data, or null.
  *             @size_t *nn@ = where to put the length
  *
  * Returns:    Pointer to the buffer data, or null.


@@ -306,7 +402,9 @@ static int findz(buf *b, size_t *nn)
     if (BENSURE(b, sz)) return (0);                                    \
     *nn = sz;                                                          \
     return (buf_get(b, sz));                                           \
     if (BENSURE(b, sz)) return (0);                                    \
     *nn = sz;                                                          \
     return (buf_get(b, sz));                                           \

-  }
+  }                                                                    \
+  void *(dbuf_getmem##w)(dbuf *db, size_t *nn)                         \
+    { return (dbuf_getmem##w(db, nn)); }

 DOUINTCONV(BUF_GETMEM_)
 
 void *buf_getmemz(buf *b, size_t *nn)
 DOUINTCONV(BUF_GETMEM_)
 
 void *buf_getmemz(buf *b, size_t *nn)


@@ -314,10 +412,57 @@ void *buf_getmemz(buf *b, size_t *nn)
   if (findz(b, nn)) return (0);
   return (buf_get(b, *nn));
 }
   if (findz(b, nn)) return (0);
   return (buf_get(b, *nn));
 }

+void *(dbuf_getmemz)(dbuf *db, size_t *nn)
+  { return (dbuf_getmemz(db, nn)); }
+
+#ifndef HAVE_UINT64
+
+static void *getmem_k64(buf *b, size_t *nn_out, kludge64 k)
+{
+  kludge64 szmax;
+  size_t n;
+
+  ASSIGN64(szmax, (size_t)-1);
+  if (CMP64(k, >, szmax)) { buf_break(b); return (-1); }
+  n = GET64(size_t, k); *nn_out = n; return (buf_get(b, n));
+}
+
+void *buf_getmem64(buf *b, size_t *nn)
+{
+  kludge64 k;
+
+  if (buf_getk64(b, &k)) return (-1);
+  return (getmem_k64(b, nn, k));
+}
+
+void *buf_getmem64l(buf *b, size_t *nn)
+{
+  kludge64 k;
+
+  if (buf_getk64l(b, &k)) return (-1);
+  return (getmem_k64(b, nn, k));
+}
+
+void *buf_getmem64b(buf *b, size_t *nn)
+{
+  kludge64 k;
+
+  if (buf_getk64b(b, &k)) return (-1);
+  return (getmem_k64(b, nn, k));
+}
+
+void *(dbuf_getmem64)(dbuf *db, size_t *nn)
+  { return (dbuf_getmem64(db, nn)); }
+void *(dbuf_getmem64l)(dbuf *db, size_t *nn)
+  { return (dbuf_getmem64l(db, nn)); }
+void *(dbuf_getmem64b)(dbuf *db, size_t *nn)
+  { return (dbuf_getmem64b(db, nn)); }
+
+#endif

 
 

-/* --- @buf_putmem{8,{16,24,32,64}{,l,b},z} --- *
+/* --- @{,d}buf_putmem{8,{16,24,32,64}{,l,b},z} --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @const void *p@ = pointer to data to write
  *             @size_t n@ = length to write
  *
  *             @const void *p@ = pointer to data to write
  *             @size_t n@ = length to write
  *


@@ -337,9 +482,46 @@ void *buf_getmemz(buf *b, size_t *nn)
     if (buf_putu##w(b, sz) || buf_put(b, p, sz))                       \
       return (-1);                                                     \
     return (0);                                                                \
     if (buf_putu##w(b, sz) || buf_put(b, p, sz))                       \
       return (-1);                                                     \
     return (0);                                                                \

-  }
+  }                                                                    \
+  int (dbuf_putmem##w)(dbuf *db, const void *p, size_t sz)             \
+    { return (dbuf_putmem##w(db, p, sz)); }

 DOUINTCONV(BUF_PUTMEM_)
 
 DOUINTCONV(BUF_PUTMEM_)
 

+#ifndef HAVE_UINT64
+
+void *buf_putmem64(buf *b, const void *p, size_t n)
+{
+  kludge64 k;
+
+  ASSIGN64(k, n); if (buf_putk64(b, k) || buf_put(b, p, n)) return (-1);
+  return (0);
+}
+
+void *buf_putmem64l(buf *b, const void *p, size_t n)
+{
+  kludge64 k;
+
+  ASSIGN64(k, n); if (buf_putk64l(b, k) || buf_put(b, p, n)) return (-1);
+  return (0);
+}
+
+void *buf_putmem64b(buf *b, const void *p, size_t n)
+{
+  kludge64 k;
+
+  ASSIGN64(k, n); if (buf_putk64b(b, k) || buf_put(b, p, n)) return (-1);
+  return (0);
+}
+
+int (dbuf_putmem64)(dbuf *db, const void *p, size_t n)
+  { return (dbuf_putmem64(db, p, n)); }
+int (dbuf_putmem64l)(dbuf *db, const void *p, size_t n)
+  { return (dbuf_putmem64l(db, p, n)); }
+int (dbuf_putmem64b)(dbuf *db, const void *p, size_t n)
+  { return (dbuf_putmem64b(db, p, n)); }
+
+#endif
+

 int buf_putmemz(buf *b, const void *p, size_t n)
 {
   octet *q;
 int buf_putmemz(buf *b, const void *p, size_t n)
 {
   octet *q;


@@ -351,10 +533,12 @@ int buf_putmemz(buf *b, const void *p, size_t n)
   q[n] = 0;
   return (0);
 }
   q[n] = 0;
   return (0);
 }

+int (dbuf_putmemz)(dbuf *db, const void *p, size_t n)
+  { return (dbuf_putmemz(db, p, n)); }

 
 

-/* --- @buf_getbuf{8,{16,24,32,64}{,l,b},z} --- *
+/* --- @{,d}buf_getbuf{8,{16,24,32,64}{,l,b},z} --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @buf *bb@ = where to put the result
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.
  *             @buf *bb@ = where to put the result
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.


@@ -373,12 +557,14 @@ int buf_putmemz(buf *b, const void *p, size_t n)
       return (-1);                                                     \
     buf_init(bb, p, sz);                                               \
     return (0);                                                                \
       return (-1);                                                     \
     buf_init(bb, p, sz);                                               \
     return (0);                                                                \

-  }
+  }                                                                    \
+  int (dbuf_getbuf##w)(dbuf *db, buf *bb)                              \
+    { return (dbuf_getbuf##w(db, bb)); }

 BUF_DOSUFFIXES(BUF_GETBUF_)
 
 BUF_DOSUFFIXES(BUF_GETBUF_)
 

-/* --- @buf_putbuf{8,{16,24,32,64}{,l,b},z} --- *
+/* --- @{,d}buf_putbuf{8,{16,24,32,64}{,l,b},z} --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @buf *bb@ = buffer to write
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.
  *             @buf *bb@ = buffer to write
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.


@@ -388,12 +574,14 @@ BUF_DOSUFFIXES(BUF_GETBUF_)
 
 #define BUF_PUTBUF_(n, W, w)                                           \
   int buf_putbuf##w(buf *b, buf *bb)                                   \
 
 #define BUF_PUTBUF_(n, W, w)                                           \
   int buf_putbuf##w(buf *b, buf *bb)                                   \

-    { return (buf_putmem##w(b, BBASE(bb), BLEN(bb))); }
+    { return (buf_putmem##w(b, BBASE(bb), BLEN(bb))); }                        \
+  int (dbuf_putbuf##w)(dbuf *db, buf *bb)                              \
+    { return (dbuf_putbuf##w(db, bb)); }

 BUF_DOSUFFIXES(BUF_PUTBUF_)
 
 BUF_DOSUFFIXES(BUF_PUTBUF_)
 

-/* --- @buf_putstr{8,{16,24,32,64}{,l,b},z} --- *
+/* --- @{,d}buf_putstr{8,{16,24,32,64}{,l,b},z} --- *

  *
  *

- * Arguments:  @buf *b@ = pointer to a buffer block
+ * Arguments:  @buf *b@ or @dbuf *db@ = pointer to a buffer block

  *             @const char *p@ = string to write
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.
  *             @const char *p@ = string to write
  *
  * Returns:    Zero if it worked, nonzero if there wasn't enough space.


@@ -403,7 +591,9 @@ BUF_DOSUFFIXES(BUF_PUTBUF_)
 
 #define BUF_PUTSTR_(n, W, w)                                           \
   int buf_putstr##w(buf *b, const char *p)                             \
 
 #define BUF_PUTSTR_(n, W, w)                                           \
   int buf_putstr##w(buf *b, const char *p)                             \

-    { return (buf_putmem##w(b, p, strlen(p))); }
+    { return (buf_putmem##w(b, p, strlen(p))); }                       \
+  int (dbuf_putstr##w)(dbuf *db, const char *p)                                \
+    { return (dbuf_putstr##w(db, p)); }

 BUF_DOSUFFIXES(BUF_PUTSTR_)
 
 /*----- That's all, folks -------------------------------------------------*/
 BUF_DOSUFFIXES(BUF_PUTSTR_)
 
 /*----- That's all, folks -------------------------------------------------*/