home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / rcs / sources / dbmfetch.c < prev    next >
C/C++ Source or Header  |  1991-05-23  |  2KB  |  57 lines
  1. /* dbmfetch.c - Find a key and return the associated data.  */
  2.  
  3. /*  This file is part of GDBM, the GNU data base manager, by Philip A. Nelson.
  4.     Copyright (C) 1990, 1991  Free Software Foundation, Inc.
  5.  
  6.     GDBM is free software; you can redistribute it and/or modify
  7.     it under the terms of the GNU General Public License as published by
  8.     the Free Software Foundation; either version 1, or (at your option)
  9.     any later version.
  10.  
  11.     GDBM is distributed in the hope that it will be useful,
  12.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.     GNU General Public License for more details.
  15.  
  16.     You should have received a copy of the GNU General Public License
  17.     along with GDBM; see the file COPYING.  If not, write to
  18.     the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
  19.  
  20.     You may contact the author by:
  21.        e-mail:  phil@cs.wwu.edu
  22.       us-mail:  Philip A. Nelson
  23.                 Computer Science Department
  24.                 Western Washington University
  25.                 Bellingham, WA 98226
  26.         phone:  (206) 676-3035
  27.  
  28. *************************************************************************/
  29.  
  30.  
  31. #include "gdbmdefs.h"
  32. #include "extern.h"
  33.  
  34.  
  35. /* NDBM Look up a given KEY and return the information associated with that
  36.    KEY. The pointer in the structure that is  returned is a pointer to
  37.    dynamically allocated memory block.  */
  38.  
  39. datum
  40. dbm_fetch (dbf, key)
  41.      gdbm_file_info *dbf;
  42.      datum key;
  43. {
  44.   datum  ret_val;        /* The return value. */
  45.  
  46.   /* Free previous dynamic memory, do actual call, and save pointer to new
  47.      memory. */
  48.   ret_val = gdbm_fetch (dbf, key);
  49.   if (_gdbm_fetch_val != NULL) free (_gdbm_fetch_val);
  50.   _gdbm_fetch_val = ret_val.dptr;
  51.  
  52.   /* Return the new value. */
  53.   return ret_val;
  54.  
  55. }
  56.  
  57.