1/* fetch.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, 1993  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 2, 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
27*************************************************************************/
28
29
30/* include system configuration before all else. */
31#include "autoconf.h"
32
33#include "gdbmdefs.h"
34#include "extern.h"
35
36
37/* Look up a given KEY and return the information associated with that KEY.
38   The pointer in the structure that is  returned is a pointer to dynamically
39   allocated memory block.  This DBM interface uses the NDBM interface. */
40
41datum
42fetch (key)
43     datum key;
44{
45  datum  ret_val;		/* The return value. */
46
47  /* Free previous dynamic memory, do actual call, and save pointer to new
48     memory. */
49  ret_val = gdbm_fetch (_gdbm_file, key);
50  if (_gdbm_fetch_val != NULL) free (_gdbm_fetch_val);
51  _gdbm_fetch_val = ret_val.dptr;
52
53  /* Return the new value. */
54  return ret_val;
55
56}
57