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

Name:       ihandle

Purpose:    return handle for index of open database

Prototype:  Index_Obj *ihandle(Db_Obj *db, char *index_name);

Header:     isam.h

Inputs:     db          - database handle
            index_name  - name of index

Description:
        ihandle returns the index handle of the index named index_name
        in the database db.  The index handle is used as an argument to
        most other ISAM routines to indicate which index to use for the ISAM
        operation.

        The name of the Physical Index is "Physical Index".  You can also
        reference the name with the global variable iphysical.

        The index handle is valid as long as the database is open.  If you
        close the database by calling iclose_db (or by closing ISAM with
        isamexit), and then later re-open the database with iopen_db,
        you must call ihandle again for each index that you want to use.

        If you call iopen_db to open a database with a garbled or
        non-existent index file, ihandle reports that the index is
        corrupt.  You can still use the Physical Index, however.  You can use
        inew_index_file to make a new index file.

Returns:
        Returns the handle for the index, or NULL for error.