ccl/cclqual.c

   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 /* CCL qualifiers
  45  * Europagate, 1995
  46  *
  47  * $Log: cclqual.c,v $
  48  * Revision 1.12  1999-11-30 13:47:11  adam
  49  * Improved installation. Moved header files to include/yaz.
  50  *
  51  * Revision 1.11  1999/03/31 11:15:37  adam
  52  * Fixed memory leaks in ccl_find_str and ccl_qual_rm.
  53  *
  54  * Revision 1.10  1998/07/07 15:49:40  adam
  55  * Added braces to avoid warning.
  56  *
  57  * Revision 1.9  1998/02/11 11:53:33  adam
  58  * Changed code so that it compiles as C++.
  59  *
  60  * Revision 1.8  1997/09/29 08:56:38  adam
  61  * Changed CCL parser to be thread safe. New type, CCL_parser, declared
  62  * and a create/destructers ccl_parser_create/ccl_parser/destory has
  63  * been added.
  64  *
  65  * Revision 1.7  1997/09/01 08:48:12  adam
  66  * New windows NT/95 port using MSV5.0. Only a few changes made
  67  * to avoid warnings.
  68  *
  69  * Revision 1.6  1997/04/30 08:52:07  quinn
  70  * Null
  71  *
  72  * Revision 1.5  1996/10/11  15:00:25  adam
  73  * CCL parser from Europagate Email gateway 1.0.
  74  *
  75  * Revision 1.9  1995/05/16  09:39:27  adam
  76  * LICENSE.
  77  *
  78  * Revision 1.8  1995/05/11  14:03:57  adam
  79  * Changes in the reading of qualifier(s). New function: ccl_qual_fitem.
  80  * New variable ccl_case_sensitive, which controls whether reserved
  81  * words and field names are case sensitive or not.
  82  *
  83  * Revision 1.7  1995/04/17  09:31:46  adam
  84  * Improved handling of qualifiers. Aliases or reserved words.
  85  *
  86  * Revision 1.6  1995/02/23  08:32:00  adam
  87  * Changed header.
  88  *
  89  * Revision 1.4  1995/02/14  19:55:12  adam
  90  * Header files ccl.h/cclp.h are gone! They have been merged an
  91  * moved to ../include/ccl.h.
  92  * Node kind(s) in ccl_rpn_node have changed names.
  93  *
  94  * Revision 1.3  1995/02/14  16:20:56  adam
  95  * Qualifiers are read from a file now.
  96  *
  97  * Revision 1.2  1995/02/14  10:25:56  adam
  98  * The constructions 'qualifier rel term ...' implemented.
  99  *
 100  * Revision 1.1  1995/02/13  15:15:07  adam
 101  * Added handling of qualifiers. Not finished yet.
 102  *
 103  */
 104
 105 #include <stdio.h>
 106 #include <stdlib.h>
 107 #include <assert.h>
 108 #include <string.h>
 109
 110 #include <yaz/ccl.h>
 111
 112 /* Definition of CCL_bibset pointer */
 113 struct ccl_qualifiers {
 114     struct ccl_qualifier *list;
 115 };
 116
 117 /*
 118  * ccl_qual_add: Add qualifier to Bibset. If qualifier already
 119  *               exists, then attributes are appendend to old
 120  *               definition.
 121  * name:    name of qualifier
 122  * no:      No of attribute type/value pairs.
 123  * pairs:   Attributes. pairs[0] first type, pair[1] first value,
 124  *          ... pair[2*no-2] last type, pair[2*no-1] last value.
 125  */
 126 void ccl_qual_add (CCL_bibset b, const char *name, int no, int *pairs)
 127 {
 128     struct ccl_qualifier *q;
 129     struct ccl_rpn_attr **attrp;
 130
 131     assert (b);
 132     for (q = b->list; q; q = q->next)
 133         if (!strcmp (name, q->name))
 134             break;
 135     if (!q)
 136     {
 137         struct ccl_qualifier *new_qual = (struct ccl_qualifier *)malloc (sizeof(*new_qual));
 138         assert (new_qual);
 139
 140         new_qual->next = b->list;
 141         b->list = new_qual;
 142
 143         new_qual->name = (char *)malloc (strlen(name)+1);
 144         assert (new_qual->name);
 145         strcpy (new_qual->name, name);
 146         attrp = &new_qual->attr_list;
 147     }
 148     else
 149     {
 150         attrp = &q->attr_list;
 151         while (*attrp)
 152             attrp = &(*attrp)->next;
 153     }
 154     while (--no >= 0)
 155     {
 156         struct ccl_rpn_attr *attr;
 157
 158         attr = (struct ccl_rpn_attr *)malloc (sizeof(*attr));
 159         assert (attr);
 160         attr->type = *pairs++;
 161         attr->value = *pairs++;
 162         *attrp = attr;
 163         attrp = &attr->next;
 164     }
 165     *attrp = NULL;
 166 }
 167
 168 /*
 169  * ccl_qual_mk: Make new (empty) bibset.
 170  * return:   empty bibset.
 171  */
 172 CCL_bibset ccl_qual_mk (void)
 173 {
 174     CCL_bibset b = (CCL_bibset)malloc (sizeof(*b));
 175     assert (b);
 176     b->list = NULL;
 177     return b;
 178 }
 179
 180 /*
 181  * ccl_qual_rm: Delete bibset.
 182  * b:        pointer to bibset
 183  */
 184 void ccl_qual_rm (CCL_bibset *b)
 185 {
 186     struct ccl_qualifier *q, *q1;
 187
 188     if (!*b)
 189         return;
 190     for (q = (*b)->list; q; q = q1)
 191     {
 192         struct ccl_rpn_attr *attr, *attr1;
 193
 194         for (attr = q->attr_list; attr; attr = attr1)
 195         {
 196             attr1 = attr->next;
 197             free (attr);
 198         }
 199         q1 = q->next;
 200         free (q->name);
 201         free (q);
 202     }
 203     free (*b);
 204     *b = NULL;
 205 }
 206
 207 /*
 208  * ccl_qual_search: Search for qualifier in bibset.
 209  * b:      Bibset
 210  * name:   Name of qualifier to search for (need no null-termination)
 211  * len:    Length of name.
 212  * return: Attribute info. NULL if not found.
 213  */
 214 struct ccl_rpn_attr *ccl_qual_search (CCL_parser cclp,
 215                                       const char *name, size_t len)
 216 {
 217     struct ccl_qualifier *q;
 218
 219     assert (cclp);
 220     if (!cclp->bibset)
 221         return NULL;
 222     for (q = cclp->bibset->list; q; q = q->next)
 223         if (strlen(q->name) == len)
 224         {
 225             if (cclp->ccl_case_sensitive)
 226             {
 227                 if (!memcmp (name, q->name, len))
 228                     return q->attr_list;
 229             }
 230             else
 231             {
 232                 if (!ccl_memicmp (name, q->name, len))
 233                     return q->attr_list;
 234             }
 235         }
 236     return NULL;
 237 }
 238