4/11/97

Well, I have finally updated the library to include the ability to update
the parameters within the ini file.  I have also renamed the old functions to
"read_ini" from "parse_string".  Consequently, the new function is called
"write_ini".  The function parameter list is the same.  The parameter list
deserves further clarification:

     int read_ini( char *filename, char *field_name, char *data,
                   char *return_string ) or

     int write_ini( char *filename, char *field_name, char *data,
                    char *new_string )


     where:
                *filename      = Character pointer to filename (ini file)
                *fieldname     = the "[fieldname]" section identifier in
                                 inifile
                *data          = the name "data" in the string "data=5"
                *return_string = the "5" in the string "data=5"
                *new_string    = the new value to be written where the "5"
                                 is in the string "data=5"


The file "test_ini.ini" is a backup file of the "test.ini".  The test program
modifies "test.ini" with a new value for "a=".  The backup file is used so 
that you can review it to ensure that the file was modified.

As before, the use of the libs are Freeware and as such you can use them 
as you see fit.  There is no warranty expressed or implied with this software
and you may use it at your own risk...This last statement sounds scary, but 
I am using this libs in a commercial product, and have not had any problems...



02/03/95

This is a fix note... In the Previous version, I did not close the
file properly...This may have caused some null pointer problems...Anyway,
this is now fixed.  Further, I am including both the Small and Large Models
for MSC V7.0.  Not too many people I know use Medium memory model, so I
did not include it.  If you want it, send me a message and I will give
you one.

When I get some free time, I will enhance the functionality of the lib to
include writing to the ini files as well...Until then...

Overview

This library allows the C programmer parse "ini" files for specific data.
The ini files are expected to look like Window's ini files.  i.e.


[name]
data=1
debug=yes

[name2]
port=2


etc.

The user merely passes the filename, bracketed name, and the data name.
The function will return the data to the right of the equal sign.  The data
is returned as a character string.  However, for numeric data, the character
string can be parsed using sscanf (C function) to read in the appropriate
numeric data.

I have enclosed a Small (ini_s.lib), Medium (ini_m.lib), and Large (ini.l.lib)
Libraries along with a header file and a sample program.


These libraries are donated to the CompuServe subscribers who have assisted
me in the past...  Anyone may use these libs as they see fit.

The Libs were compiled under MSC V 7.0

The Test program was compiled using:

        cl /c /AS test.c

Linked using
        link test.c,,,ini_s,,


Enjoy the libs!

Sam Saprunoff

73730,72