// This file is under GNU General Public License 3.0

 // see LICENSE.txt

 #pragma once

 #include <string.h>

 #include "dynamic_api.h"

 #ifdef __cplusplus

 extern "C" {

 #endif

 // new_string() - allocate a new string

 //

 //  parameters:

 //      src (in)        string to copy or NULL

 //      len (in)        length of newly created string or 0 for default

 //

 //  return value:

 //      pointer to string object or NULL if out of memory

 //

 //  calling with str and len is equivalent to strndup()

 //  calling with str but len=0 is equivalent to strdup()

 //  calling with str=NULL is equivalent to calloc()

 DYNAMIC_API char * new_string(const char *src, size_t len);

 // free_string() - free memory occupied by string

 //

 //  parameters:

 //      s (in)          pointer to string to free

 DYNAMIC_API void free_string(char *s);

 // string_dup() - duplicate a string

 //

 //  parameters:

 //      src (in)        string to duplicate

 //      len (in)        length of newly created string or 0 for default

 //

 //  return value:

 //      pointer to copy or NULL if out of memory

 DYNAMIC_API char * string_dup(const char *src, size_t len);

 #ifdef __cplusplus

 }

 #endif