README for the rancid-lib utility classes
by David Koenig
dave@rancidmeat.com


These are a handfull of C++ classes I created to make things easier
for myself. hopefully someone can get some use out of them as well.
Currently there are 3 classes contained within. StringTokenizer,
DynArray, and Stack. 

StringTokenizer is a char * tokenizer in the style of SUN's Java API. 
I use Java a great deal and like this functionality.

DynArray is a dynamic array. The contents can be modified by using the
[] operator to access them.

Stack is a LIFO - Last in First Out linked list. It is similar to the
STL Stack class. It stores by values versus by reference/pointer.

SimpleStack is another stack class that allows you to set a max size for
the stack at runtime. This should execute faster than the stack class.

StringBuffer is a dynamic string class that grows as you append more char
arrays.

main.cpp shows an example use of each of the classes.


Compiling:
I use gcc on Linux. Simply typing "Make" should get the job done. On
Windows, you have a few options. Option 1, you can goto www.cygwin.com 
and download the cygwin suite. Then you can use "Make" just like on
Linux. Option 2, you can make an empty project in MSVC and add these
files, compile and you're good to go. If you just want to use these in
you app with out compiling the test app, all you have to do is include
the header file for the class you want to use into your project.


Afterword:
If anyone does get any use from these classes, I would love to hear from
you. If you have any ideas on how they might be improved, please let me
know as well

Well, that's about it.
-dave
dave@rancidmeat.com

Licensing Agreement:
All code here is released under the GPL license.

Copyright (C) 2002 David Koenig

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation;

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.