/** SFSEXP: Small, Fast S-Expression Library version 1.0Written by Matthew Sottile (matt@lanl.gov)Copyright (2004). The Regents of the University of California. This materialwas produced under U.S. Government contract W-7405-ENG-36 for Los AlamosNational Laboratory, which is operated by the University of California forthe U.S. Department of Energy. The U.S. Government has rights to use,reproduce, and distribute this software. NEITHER THE GOVERNMENT NOR THEUNIVERSITY MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY LIABILITYFOR THE USE OF THIS SOFTWARE. If software is modified to produce derivativeworks, such modified software should be clearly marked, so as not to confuseit with the version available from LANL.Additionally, this program is free software; you can redistribute it and/ormodify it under the terms of the GNU General Public License as published bythe Free Software Foundation; either version 2 of the License, or (at youroption) any later version. Accordingly, this program is distributed in thehope that it will be useful, but WITHOUT ANY WARRANTY; without even theimplied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Seethe GNU General Public License for more details.LA-CC-04-094**//** * cstring.h : c string library to make Ron happy.  Wrapper around plain * C strings that handles automatically growing the string as data is * concattenated to the end.  (note: this is an improved version of cstring * from supermon.  Migrate it into that library eventually... ) * * -matt sottile */#ifndef __CSTRING_H__#define __CSTRING_H__#include <stdlib.h>/** * Structure wrapping the character pointer and size counters (allocated vs. * actual used). */typedef struct __cstring {  /**   * Base address of the string.   */  char *base;   /**   * Size of the memory allocated and pointed to by the base pointer.   */  size_t len;  /**   * Current size of the string stored in the buffer.  len >= curlen   * always, and when len < curlen would be true after a concat operation,   * we realloc bigger space to keep len >= curlen.   */  size_t curlen; } CSTRING;/** * Set the growth size */void sgrowsize(size_t s);/** * Allocate a new CSTRING of the given size. */CSTRING *snew(size_t s);/** * Concatenate the second argument to the CSTRING passed in the first. * The second argument must be a pointer to a null terminated string. */CSTRING *sadd(CSTRING *s, char *a);/** * Append a character to the end of the CSTRING */CSTRING *saddch(CSTRING *s, char a);/** * Trim the allocated memory to precisely the string length plus one char * to hold the null terminator */CSTRING *strim(CSTRING *s);/** * Return the base pointer of the CSTRING. */char *toCharPtr(CSTRING *s);/** * Set the current length to zero, effectively dumping the string without * deallocating it so we can use it later without reallocating any memory. */void sempty(CSTRING *s);/** * Destroy the CSTRING struct and the data it points at. */void sdestroy(CSTRING *s);#endif /* __CSTRING_H__ */