

   xstring - an useful c++ string class

Overview
========

xstring is aimed to a be free, portable, secure, flexible and fast c++ string class 
It features string searching and replacing, automatic memory allocation, 
format string, compatible with std::string and char*, operators, numeric conversion 
and other utility functions. 
It has also a hash class (xstringhash).
See the xstring.h and xstringhash.h for details on the API

WARNING!! this is alpha software and is under HEAVY development!! Don't use this on production code!!

Installation
============

  Unix - autoconf
  -----

First of all extract the sources with 
         tar xzvf xstring-<version>.tar.gz

You may want to modify the variables in the Makefile

to configure the package you should do
 ``./configure''

do ``make'' to compile the whole thing.

to execute the test suite do ``make check''

to install perform ``make install''

that's all. It will install the library in /usr/local/include and /usr/local/lib


Using xstring
=============
  
  Unix
  ----

to compile a program that uses xstring you'll have add the library to the 
linker flags. e.g.  ``c++ test1.cpp -o test1 -lxstring''

you have also to include the header ``xstring.h'' like this:
 
   #include <xstring.h>

