Dbakey()

From Recital Documentation Wiki
Revision as of 11:17, 2 April 2009 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

PURPOSE

add key


SYNOPSIS

#include<dbl.h>
 
	int	dbakey(ndx, key, recno)
 
	<input parameters>
	char	*ndx;		/* .NDX file descriptor 			*/
	char	key;		/* Address of a buffer containing the key	*/
	long	recno;		/* Record number				*/
 
	<output parameters>
	none


RETURN VALUE

The dbakey() function returns 0 for success, or<0 if an error occurs. See the section on return code values for a detailed list of return codes.


DESCRIPTION

This function adds a key with its associated record number to the specified .NDX file which contains keys in a B-tree structure.


EXAMPLE

The following example adds a character key "John Smith 5" and its associated record number 5 to the index file whose descriptor is in "char *ndx".

#include "dbl.h"
 
	char	*ndx;		/* .NDX file descriptor	*/
	int	rc; 		/* Return code			*/
 
	rc=dbakey(ndx,"John Smith 5". (long)5);
	if (rc = = SUCCESS) printf("key added n");
	else {
		printf("error number %d n", rc);
		exit (1);
	}


SEE ALSO

dbatokey(), dbicreat(), dbiflsh(), dbrmvkey(), dbtkey(), dbupdr()