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

Name:       ifindmark

Purpose:    make the marked record the current record

Prototype:  int ifindmark(Db_Obj *db, Index_Obj *index);

Header:     isam.h

Inputs:     db      - database handle
            index   - index handle

Description:
        ifindmark makes the previously marked record of the index in
        the database db become the current record.  See the imarkrec
        function to mark a record.  It is an error if no record was previously
        marked.  Finding the mark does not affect the mark, so you can
        ifindmark again to get back to the same record without having to
        mark it again.

        If you mark a record, delete that record, and then call ifindmark,
        you will move to the record following the deleted record.  This is
        because when idelrec happens to delete a marked record, it moves
        the mark to the next record.

        If you mark a record, modify that record, and the call ifindmark,
        you will move to the record following the original marked record.
        This is because when imodrec performs the delete operation to
        remove the original version of the record, it moves the mark to the
        next record.

        If the mark was set as beginning of index or end of indexx, ifindmark
        moves to that place and returns BOI or EOI.

        Marks are not implemented for the Physical Index.  It is an error to
        call ifindmark on the Physical Index.

Returns:
        OK, ERROR, BOI, or EOI.