============================================================
|   FILE CHECKER C++ HEADER AND SOURCE FILES VERSION 1.0   |
============================================================

Author: Jason Roman
Email: jasonroman@email.com
URL: http://www.cpgg.net/warthog
Status: Public Domain

If you have any questions or problems or general feedback, please
e-mail me and let me know.

----------------------------
|   DISTRIBUTION STATUS:   |
----------------------------

This file may be freely distributed and used, but is requested that the
file be downloaded from the internet, not from another user.  There is
no copyright to the files.  I have created them for the benefit of
programmers.  However, if you use the files I ask that you give credit
where it is due, as I am sure you would want if you were distributing
your own code freely.

--------------------
|   DESCRIPTION:   |
--------------------

File Checker 1.0 is a library tool for program developers in C++
to use in their applications that deal with file input/output.
Basically a name for the file to be written to is entered, and the
file checker will determine if the filename is valid to use.  These
files work best in a DOS-based application but there should be no
problems running it in Windows.

----------------------
|   THE FUNCTIONS:   |
----------------------

char initFile()
	-This function asks whether or not you would like to create a
	 new file or append an existing one.  'N' is returned for a
	 new file, and 'A' is returned for a 'A' file.

void newFile(char*)
	-This function will ask for a filename and create a new
	 file if the name is valid and there is no other file of that
	 name in the directory you are working.

void appendFile(char*)
	-This function will ask for a filename that already exists and
	 you want to make changes to, and makes sure that the file
	 exists and is available for appending.

void readFile(char*)
	-This function asks for a filename that you wish to read from,
	 but not make changes to.

So what are the char* pointers for?  Well, since you are working with
file I/O oustide of the main program, the functions only place back a
valid name for a file into the variable you put in the function.  This
means that you have to run the function and then the next line you have
to create the fstream, ofstream, or ifstream you wish to use.

--------------------
|   EXAMPLE USE:   |
--------------------

Using the readFile function:

#include "filechk.h"
void main()
{
	FileCheck fc;
	char iofname[100]="";
	fc.readFile(iofname);
	fstream infile(iofname, ios::binary | ios::in | ios::out);

	// do work with file below
}


Using the initFile, newFile, and appendFile functions:

#include "filechk.h"
void main()
{
	FileCheck fc;
	char choice;
	char iofname[100]="";

	choice=fc.initFile();
	if(choice=='N')
		fc.newFile(iofname);
	if(choice=='A')
		fc.appendFile(iofname);

	ofstream ofile(iofname, ios::binary | ios::app);

	// do work with file below
}
	
---------------------
|   FORMAL STUFF:   |
---------------------

This is by no means a professional program, but it has been tested and
will not overwrite files or change existing ones. The purpose of these
files is to prevent this from happening.  Any such occurrences that
harm files are the fault of the programmer and not the author of this
program, as none of the functions included are threatening to any existing files
the user owns.  By using the included files you assume all
responsibility to your files.

Any comments, questions, concerns, advice, etc. are welcome.
					Jason "Warthog" Roman
					jasonroman@email.com