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