Table of Contents
Advertisement
See Also
close_DBF, create_DBF, create_index
rebuild_index
Purpose
To rebuild an IDX file for a DBF file.
Syntax
int rebuild_IDX (int DBF_fd, int key_number, int base_index, int key_offset,
int key_len);
int DBF_fd;
int key_number;
int key_base_index;
int key_offset;
int key_len;
Example
rebuild_index (DBF_fd, 1, 0, 0, 10);
This routine rebuilds or creates an IDX file (key_number) which is associated
Description
with a DBF file (DBF_fd). The key field of the IDX file is specified by the
arguments key_offset and key_len.
Return
If successful, it returns 0.
On error, it returns -1.
An error code is set to the global variable fErrorCode to indicate the error
condition encountered. Below are possible error codes and their interpretation.
Error Code
2
4
Chapter 3 Terminal Specific Function Library
/* offset in bytes where the key value in a member begins */
This routine can be used whenever an IDX file has same key values in a
key field. base_index specifies the IDX file from which this routine takes
as the input sequence for building the new IDX file. For example, if a
report is to be generated by the sequence of date, department, and ID
number, and the date and department data may be repeated. This can be
done by rebuilding the ID number index first. Then rebuild the department
index with the ID number index as the base index. And finally, rebuild the
date index with the department index as the base index. The resulting
member sequence in the date index will be in date, department, and ID
number.
If no base index is preferred, the base_index should be 0. Then the
resulting sequence will be the original member sequence in the DBF file.
If the IDX file (key_number) already exists, it will be overwrittten;
otherwise, this routine will create a new IDX file.
The key field should be within member_len as defined in the create_DBF
function. That is, key_offset plus key_len should not be greater than
member_len.
Interpretation
File specified by DBF_fd does not exist.
File specified by DBF_fd is not a DBF file.
/* file handle of the associated DBF file */
/* key number of the IDX file to be created */
/* key number of the preferred IDX file */
/* length of key value of the IDX file */
207
Advertisement
Table of Contents
