Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- C/Database Toolchest Library - name: <b>ihandle</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
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.

See Also: iclose_db isamexit iopen_db inew_index_file

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson