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