Click above to get retro games delivered to your door ever month!

Name:       iprogress

Purpose:    save pointer to user's progress function

Prototype:  void iprogress(void (*user_fcn)() );

Header:     isam.h

Inputs:     user_fcn    - address of function to be called after each
                              record is processed.

Description:
        iprogress saves the progress function pointer so that it can be
        used by imkindex, irmindex, and icopy_db.  The function is
        typically used to display on the screen a record count or some other
        indication of progress through the database.

        The user_fcn is the address of a function that is called after
        each record is processed by the ISAM functions mentioned above.  If
        user_fcn is NULL_FUNCTION, no function is called during the
        processing.  (Don't use NULL here; it won't work if you are compiling
        with a large code model.)

        When called by one of the ISAM functions mentioned aboe, the user's
        progress function is passed one argument of type long.  This long
        integer contains the record count of the total number of records
        processed by the ISAM function so far.

Returns:
        Returns no value.