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)