View source for Dbicache()

==PURPOSE==
specify size of the index cache


==SYNOPSIS==

<code lang="c">
#include "dbl.h"

	int	dbicache(size)

	<input parameter>
	int	size;		/* Index cache size in blocks */

	<output parameters>
	none

</code>


==RETURN VALUE==

The dbicache() function returns 0 for success, or < 0 if an error occurs.  See the section on [[Library Return Code Values|return code values]] for a detailed list of return codes.


==DESCRIPTION==

The dbicache() function is used to specify the size of the index cache in 512 byte disk blocks.  Index caching improves performance of index operations.


==EXAMPLE==

The following example sets the icache (index cache)  to 100 then creates an .NDX file "person.ndx" whose key expression, length and type are "SSN", 10 and 'C' respectively.  "SSN" is a field name of the associated .DBF file.


<code lang="c">
#include "dbl.h"
	int	rc;	/* Return code */

	rc = dbicache(100);
	if (rc = = SUCCESS){
		rc = dbicreat("person.ndx", "SSN", 10, 'C');
		if (rc == SUCCESS){
			printf("index person created \n");
		} else {
			printf("error number %d \n", rc);
			exit (1);
		}
	} else {
		printf("error number %d \n", rc);
		exit (1);
	}

</code>


==SEE ALSO==

[[dbdcache()]], [[dbiclose()]], [[dbicreat()]], [[dbiopen()]]

[[Category:Documentation]]
[[Category:Library]]