include/iso2709.h

   1 /*
   2  * Copyright (c) 1995, the EUROPAGATE consortium (see below).
   3  *
   4  * The EUROPAGATE consortium members are:
   5  *
   6  *    University College Dublin
   7  *    Danmarks Teknologiske Videnscenter
   8  *    An Chomhairle Leabharlanna
   9  *    Consejo Superior de Investigaciones Cientificas
  10  *
  11  * Permission to use, copy, modify, distribute, and sell this software and
  12  * its documentation, in whole or in part, for any purpose, is hereby granted,
  13  * provided that:
  14  *
  15  * 1. This copyright and permission notice appear in all copies of the
  16  * software and its documentation. Notices of copyright or attribution
  17  * which appear at the beginning of any file must remain unchanged.
  18  *
  19  * 2. The names of EUROPAGATE or the project partners may not be used to
  20  * endorse or promote products derived from this software without specific
  21  * prior written permission.
  22  *
  23  * 3. Users of this software (implementors and gateway operators) agree to
  24  * inform the EUROPAGATE consortium of their use of the software. This
  25  * information will be used to evaluate the EUROPAGATE project and the
  26  * software, and to plan further developments. The consortium may use
  27  * the information in later publications.
  28  *
  29  * 4. Users of this software agree to make their best efforts, when
  30  * documenting their use of the software, to acknowledge the EUROPAGATE
  31  * consortium, and the role played by the software in their work.
  32  *
  33  * THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND,
  34  * EXPRESS, IMPLIED, OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
  35  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  36  * IN NO EVENT SHALL THE EUROPAGATE CONSORTIUM OR ITS MEMBERS BE LIABLE
  37  * FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF
  38  * ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA
  39  * OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND
  40  * ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE
  41  * USE OR PERFORMANCE OF THIS SOFTWARE.
  42  *
  43  */
  44
  45 /*
  46  * Record management - public header file
  47  *
  48  * $Log: iso2709.h,v $
  49  * Revision 1.11  1995/05/16 09:39:39  adam
  50  * LICENSE.
  51  *
  52  * Revision 1.10  1995/03/30  07:32:46  adam
  53  * New log-level: GW_LOG_NOTICE. New 2709 function: iso2709_mk.
  54  *
  55  * Revision 1.9  1995/03/29  11:44:25  adam
  56  * New functions: iso2709_a_.. for record manipulation.
  57  *
  58  * Revision 1.8  1995/03/28  16:06:42  adam
  59  * New function: iso2709_out.
  60  *
  61  * Revision 1.7  1995/03/27  12:50:40  adam
  62  * New level: GW_LOG_ERRNO.
  63  *
  64  * Revision 1.6  1995/03/08  12:36:35  adam
  65  * New function: dbc2709_cvt.
  66  *
  67  * Revision 1.5  1995/02/23  08:32:12  adam
  68  * Changed header.
  69  *
  70  * Revision 1.3  1995/02/10  17:05:14  adam
  71  * New function iso2709_display to display MARC records in a
  72  * line-by-line format. The iso2709_cvt function no longer
  73  * prints the record to stderr.
  74  *
  75  * Revision 1.2  1995/02/10  16:50:25  adam
  76  * Indicator field moved to 'struct iso2709_dir' from 'struct
  77  * iso2709_field'.
  78  * Function iso2709_rm implemented - to delete a MARC record.
  79  *
  80  * Revision 1.1.1.1  1995/02/09  17:27:12  adam
  81  * Initial version of email gateway under CVS control.
  82  *
  83  */
  84
  85 #ifndef ISO2709_H
  86 #define ISO2709_H
  87
  88 typedef struct iso2709_rec *Iso2709Rec;
  89 typedef struct iso2709_anchor *Iso2709Anchor;
  90
  91 char *iso2709_read (FILE *inf);
  92 Iso2709Rec iso2709_cvt (const char *buf);
  93 Iso2709Rec iso2709_mk (void);
  94 void iso2709_rm (Iso2709Rec rec);
  95 void iso2709_display (Iso2709Rec rec, FILE *out);
  96 int iso2709_out (Iso2709Rec p, char **buf, int size);
  97
  98 Iso2709Anchor iso2709_a_mk (Iso2709Rec rec);
  99 void iso2709_a_rm (Iso2709Anchor anchor);
 100 int iso2709_a_first (Iso2709Anchor anchor);
 101 int iso2709_a_next_line (Iso2709Anchor anchor);
 102 int iso2709_a_next_field (Iso2709Anchor anchor);
 103 int iso2709_a_next (Iso2709Anchor anchor);
 104 int iso2709_a_info_field (Iso2709Anchor anchor,
 105                     char **tag, char **indicator,
 106                     char **identifier, char **data);
 107 int iso2709_a_info_line (Iso2709Anchor anchor,
 108                     char **tag, char **indicator);
 109 int iso2709_a_delete_field (Iso2709Anchor anchor);
 110 int iso2709_a_delete_line (Iso2709Anchor anchor);
 111 int iso2709_a_insert (Iso2709Anchor anchor,
 112                       const char *tag, const char *indicator,
 113                       const char *identifier, const char *data);
 114 int iso2709_a_search (Iso2709Anchor anchor,
 115                       const char *tag_p, const char *indicator_p,
 116                       const char *identifier_p);
 117 #endif
 118