libfirestring(3)					     Library Functions Manual						  libfirestring(3)

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)