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>igetreclen</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Name:       igetreclen

Purpose:    get length of current record by index

Prototype:  int igetreclen(Db_Obj     *db,
                           Index_Obj  *index,
                           Rec_Len    *rec_length);

Header:     isam.h

Inputs:     db          - database handle
            index       - index handle
            rec_length    - (to be) length of record

Description:
        igetreclen determines the length of the current record of the
        index in the database db, and updates the rec_length
        argument with this value.  If there is any error, the rec_length
        argument is set to zero.

        Note that the length may be one or two bytes longer than the sum
        of the space used by the fields of the record, because orphan
        bytes are occasionally tacked on to the end of a record to prevent
        tiny holes in the database as a result of deletes or modifies in
        place.

Returns:
        Returns OK (and updates rec_length), or BOI, EOI, or ERROR

WARNING:
        Note that rec_length is the ADDRESS of the record length (i.e.,
        don't forget the '&').

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