Dblockr()

PURPOSE

lock a record in a database file

SYNOPSIS

#include "dbl.h"
 
	int	dblockr(dbf, recno)
 
	<input parameter>
	char	*dbf;		/* File descriptor of a .DBF file to be locked	*/
	int	recno;		/* Record number to lock			*/
 
	<output parameter>
	none

RETURN VALUE

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

DESCRIPTION

The dblockr() function locks a record in the database file from the given file descriptor "char *dbf". The record locked is the number in "int recno".

EXAMPLE

The following example locks record number 5 in the .DBF file whose file descriptor is in "char *dbf".

#include "dbl.h"
	char	*dbf;		/* Database file descriptor	*/
	int	rc;		/* Return code			*/
 
	rc = dblockr(dbf, 5);
	if (rc = SUCCESS) printf("record 5 is locked n");
	else {
		printf("record 5 could not be locked n");
		return (ERROR);
	}

SEE ALSO

dbfilemode(), dblockf(), dblocki(), dbtlockf(), dbtlockr(), dbunlockf(), dbunlocki(), dbunlockr()