home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frostbyte's 1980s DOS Shareware Collection
/
floppyshareware.zip
/
floppyshareware
/
DOOG
/
CBASE09.ZIP
/
BTREE.ZIP
/
BTGETCUR.C
< prev
next >
Wrap
Text File
|
1989-08-31
|
2KB
|
74 lines
/* Copyright (c) 1989 Citadel */
/* All Rights Reserved */
/* #ident "btgetcur.c 1.1 - 89/07/03" */
#include <blkio.h>
#include <errno.h>
/* #include <string.h> */
#include "btree_.h"
/*man---------------------------------------------------------------------------
NAME
btgetcur - get btree cursor
SYNOPSIS
#include <btree.h>
int btgetcur(btp, btpos_p)
btree_t *btp;
btpos_t *btpos_p;
DESCRIPTION
The btgetcur function gets the current cursor position for btree btp
and copies it to btpos_p. A btree position saved with btgetcur can
be used to reposition to a key using btsetcur. It is important to
remember that a btree position saved with btgetcur is not valid after
an insertion, deletion, or unlock.
btgetcur will fail if one or more of the following is true:
[EINVAL] btp is not a valid btree pointer.
[EINVAL] btpos_p is the NULL pointer.
[BTELOCK] btp is not locked.
[BTENOPEN] btp is not open.
SEE ALSO
btsetcur.
DIAGNOSTICS
Upon successful completion, a value of 0 is returned. Otherwise, a
value of -1 is returned, and errno set to indicate the error.
------------------------------------------------------------------------------*/
int btgetcur(btp, btpos_p)
btree_t * btp;
btpos_t * btpos_p;
{
errno = 0;
/* validate arguments */
if ((!bt_valid(btp)) || (btpos_p == NULL)) {
errno = EINVAL;
return -1;
}
/* check if not open */
if (!(btp->flags & BTOPEN)) {
errno = BTENOPEN;
return -1;
}
/* check locks */
if (!(btp->flags & BTLOCKS)) {
errno = BTELOCK;
return -1;
}
/* get current position */
memcpy((void *)btpos_p, (void *)&btp->cbtpos, sizeof(btp->cbtpos));
errno = 0;
return 0;
}