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>