home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / progm / cbase.zip / CBASE10B.ZIP / CBASE.ZIP / CBKEYFIR.C < prev    next >
Text File  |  1989-11-08  |  3KB  |  130 lines
  1. /*    Copyright (c) 1989 Citadel    */
  2. /*       All Rights Reserved        */
  3.  
  4. /* #ident    "cbkeyfir.c    1.2 - 89/11/08" */
  5.  
  6. #include <blkio.h>
  7. #include <btree.h>
  8. #include <errno.h>
  9. #include <lseq.h>
  10. /*#include <stdlib.h>*/
  11. /*#include <string.h>*/
  12. #include "cbase_.h"
  13.  
  14. /*man---------------------------------------------------------------------------
  15. NAME
  16.      cbkeyfirst - first cbase key
  17.  
  18. SYNOPSIS
  19.      #include <cbase.h>
  20.  
  21.      int cbkeyfirst(cbp, field)
  22.      cbase_t *cbp;
  23.      int field;
  24.  
  25. DESCRIPTION
  26.      The cbkeyfirst function positions the key cursor of the specified
  27.      field in cbase cbp to the first key.  The record cursor of cbp is
  28.      positioned to the record associated with that key.  Other key
  29.      cursors are not affected.
  30.  
  31.      cbkeyfirst will fail if one or more of the following is true:
  32.  
  33.      [EINVAL]       cbp is not a valid cbase pointer.
  34.      [EINVAL]       field is not a valid field number for
  35.                     cbase cbp.
  36.      [CBELOCK]      cbp is not locked.
  37.      [CBENKEY]      field is not a key.
  38.      [CBENOPEN]     cbp is not open.
  39.      [CBENREC]      cbp is empty.
  40.  
  41. SEE ALSO
  42.      cbkeylast, cbkeynext, cbkeyprev, cbreccnt, cbrecfirst.
  43.  
  44. DIAGNOSTICS
  45.      Upon successful completion, a value of 0 is returned.  Otherwise,
  46.      a value of -1 is returned, and errno set to indicate the error.
  47.  
  48. ------------------------------------------------------------------------------*/
  49. int cbkeyfirst(cbp, field)
  50. cbase_t *cbp;
  51. int field;
  52. {
  53.     void *buf = NULL;
  54.     cbrpos_t cbrpos = 0;
  55.     lspos_t lspos = 0;
  56.  
  57.     /* validate arguments */
  58.     if (!cb_valid(cbp)) {
  59.         errno = EINVAL;
  60.         return -1;
  61.     }
  62.  
  63.     /* check if not open */
  64.     if (!(cbp->flags & CBOPEN)) {
  65.         errno = CBENOPEN;
  66.         return -1;
  67.     }
  68.  
  69.     /* validate arguments */
  70.     if ((field < 0) || (field >= cbp->fldc)) {
  71.         errno = EINVAL;
  72.         return -1;
  73.     }
  74.  
  75.     /* check if field not a key */
  76.     if (!(cbp->fldv[field].flags & CB_FKEY)) {
  77.         errno = CBENKEY;
  78.         return -1;
  79.     }
  80.  
  81.     /* check if not locked */
  82.     if (!(cbp->flags & CBLOCKS)) {
  83.         errno = CBELOCK;
  84.         return -1;
  85.     }
  86.  
  87.     /* check if cbase empty */
  88.     if (lsreccnt(cbp->lsp) == 0) {
  89.         errno = CBENREC;
  90.         return -1;
  91.     }
  92.  
  93.     /* set key cursor to first key */
  94.     if (btfirst(cbp->btpv[field]) == -1) {
  95.         CBEPRINT;
  96.         return -1;
  97.     }
  98.  
  99.     /* get record position */
  100.     if (btkeysize(cbp->btpv[field]) != (cbp->fldv[field].len + sizeof(cbrpos_t))) {
  101.         CBEPRINT;
  102.         errno = CBEPANIC;
  103.         return -1;
  104.     }
  105.     buf = calloc((size_t)1, btkeysize(cbp->btpv[field]));
  106.     if (buf == NULL) {
  107.         CBEPRINT;
  108.         errno = ENOMEM;
  109.         return -1;
  110.     }
  111.     if (btgetk(cbp->btpv[field], buf) == -1) {
  112.         CBEPRINT;
  113.         free(buf);
  114.         return -1;
  115.     }
  116.     memcpy(&cbrpos, ((char *)buf + cbp->fldv[field].len), sizeof(cbrpos));
  117.     free(buf);
  118.     buf = NULL;
  119.  
  120.     /* set record cursor */
  121.     lspos = cbrpos;
  122.     if (lssetcur(cbp->lsp, &lspos) == -1) {
  123.         CBEPRINT;
  124.         return -1;
  125.     }
  126.  
  127.     errno = 0;
  128.     return 0;
  129. }
  130.