NAME

       libfirestring - library for safe, fast string handling

SYNOPSIS

       #include <firestring.h>
       -lfirestring

DESCRIPTION

       libfirestring  is  a  string  handling  library  that provides maximum length aware string
       handling functions to programs.  Several  functions  provide  saner  interfaces  than  the
       standard  libc  functions.   libfirestring also provides functions that are in most libc's
       but not provided for by ANSI C, enabling programmers to write ANSI C-compliant code  while
       using such safe functions (strcasecmp, strncasecmp, snprintf).

       libfirestring provides a set of functions for dealing with EStrings.  EStrings are binary-
       safe objects that, when used with the firestring functions,  are  overflow  safe,  because
       they include allocated memory size information with them.

       libfirestring  also  includes functions for dealing with reading configuration files in an
       easy to program fashion.

       Miscellaneous functions:
              firestring_malloc(3)
              firestring_realloc(3)

       Starting-letter keys (for String and EString functions):
              n Length-safe (takes a size argument)
              e EString (length-safe and binary-safe, takes a struct firestring_estr_t argument)
              i Case-insensitive
              a Automatically expands EString to correct size (possible memory DoS attack in some
              cases)
              s Writes into a provided instead of to a stream
              f Writes into a specified stream instead of to standard output

       Base library functions:
              firestring_set_error_handler(3)

       String functions:
              firestring_strdup(3)
              firestring_strncpy(3)
              firestring_strncat(3)
              firestring_snprintf(3)
              firestring_strncasecmp(3)
              firestring_strcasecmp(3)
              firestring_concat(3)
              firestring_chomp(3)
              firestring_chug(3)
              firestring_trim(3)
              firestring_hextoi(3)

       EString functions:
              firestring_estr_alloc(3)
              firestring_estr_expand(3)
              firestring_estr_free(3)
              firestring_estr_read(3)
              firestring_estr_sprintf(3)
              firestring_estr_sprintfe(3)
              firestring_estr_vsprintf(3)
              firestring_estr_vsprintfe(3)
              firestring_estr_printf(3)
              firestring_estr_printfe(3)
              firestring_estr_fprintf(3)
              firestring_estr_fprintfe(3)
              firestring_estr_vfprintf(3)
              firestring_estr_vfprintfe(3)
              firestring_estr_strchr(3)
              firestring_estr_strstr(3)
              firestring_estr_stristr(3)
              firestring_estr_starts(3)
              firestring_estr_estarts(3)
              firestring_estr_ends(3)
              firestring_estr_eends(3)
              firestring_estr_strcasecmp(3)
              firestring_estr_strcmp(3)
              firestring_estr_strcpy(3)
              firestring_estr_astrcpy(3)
              firestring_estr_strcat(3)
              firestring_estr_astrcat(3)
              firestring_estr_estrcasecmp(3)
              firestring_estr_estrncasecmp(3)
              firestring_estr_estrcpy(3)
              firestring_estr_aestrcpy(3)
              firestring_estr_estrcat(3)
              firestring_estr_aestrcat(3)
              firestring_estr_estrstr(3)
              firestring_estr_estristr(3)
              firestring_estr_replace(3)
              firestring_estr_areplace(3)
              firestring_estr_toupper(3)
              firestring_estr_tolower(3)
              firestring_estr_munch(3)
              firestring_estr_chomp(3)
              firestring_estr_chug(3)
              firestring_estr_trim(3)
              firestring_estr_0(3)
              firestring_estr_base64_encode(3)
              firestring_estr_base64_decode(3)
              firestring_estr_xml_encode(3)
              firestring_estr_xml_decode(3)

       Configuration file functions:
              firestring_conf_parse(3)
              firestring_conf_add(3)
              firestring_conf_find(3)
              firestring_conf_find_next(3)
              firestring_conf_free(3)

FILES

       /usr/local/include/firestring.h
       /usr/local/lib/libfirestring.so
       /usr/local/lib/libfirestring.a

AUTHOR

       Ian Gulliver <ian@penguinhosting.net>

                                            2002-03-31                           libfirestring(3)