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  * $Id: cclqual.c,v 1.17 2002-06-06 12:54:24 adam Exp $
  48  *
  49  * Old Europagate Log:
  50  *
  51  * Revision 1.9  1995/05/16  09:39:27  adam
  52  * LICENSE.
  53  *
  54  * Revision 1.8  1995/05/11  14:03:57  adam
  55  * Changes in the reading of qualifier(s). New function: ccl_qual_fitem.
  56  * New variable ccl_case_sensitive, which controls whether reserved
  57  * words and field names are case sensitive or not.
  58  *
  59  * Revision 1.7  1995/04/17  09:31:46  adam
  60  * Improved handling of qualifiers. Aliases or reserved words.
  61  *
  62  * Revision 1.6  1995/02/23  08:32:00  adam
  63  * Changed header.
  64  *
  65  * Revision 1.4  1995/02/14  19:55:12  adam
  66  * Header files ccl.h/cclp.h are gone! They have been merged an
  67  * moved to ../include/ccl.h.
  68  * Node kind(s) in ccl_rpn_node have changed names.
  69  *
  70  * Revision 1.3  1995/02/14  16:20:56  adam
  71  * Qualifiers are read from a file now.
  72  *
  73  * Revision 1.2  1995/02/14  10:25:56  adam
  74  * The constructions 'qualifier rel term ...' implemented.
  75  *
  76  * Revision 1.1  1995/02/13  15:15:07  adam
  77  * Added handling of qualifiers. Not finished yet.
  78  *
  79  */
  80
  81 #include <stdio.h>
  82 #include <stdlib.h>
  83 #include <string.h>
  84
  85 #include <yaz/ccl.h>
  86
  87 /* Definition of CCL_bibset pointer */
  88 struct ccl_qualifiers {
  89     struct ccl_qualifier *list;
  90     struct ccl_qualifier_special *special;
  91 };
  92
  93
  94 /* CCL Qualifier special */
  95 struct ccl_qualifier_special {
  96     char *name;
  97     char *value;
  98     struct ccl_qualifier_special *next;
  99 };
 100
 101
 102 static struct ccl_qualifier *ccl_qual_lookup (CCL_bibset b,
 103                                               const char *n, size_t len)
 104 {
 105     struct ccl_qualifier *q;
 106     for (q = b->list; q; q = q->next)
 107         if (len == strlen(q->name) && !memcmp (q->name, n, len))
 108             break;
 109     return q;
 110 }
 111
 112
 113 void ccl_qual_add_special (CCL_bibset bibset, const char *n, const char *v)
 114 {
 115     struct ccl_qualifier_special *p;
 116     const char *pe;
 117
 118     for (p = bibset->special; p && strcmp(p->name, n); p = p->next)
 119         ;
 120     if (p)
 121         xfree (p->value);
 122     else
 123     {
 124         p = (struct ccl_qualifier_special *) xmalloc (sizeof(*p));
 125         p->name = ccl_strdup (n);
 126         p->value = 0;
 127         p->next = bibset->special;
 128         bibset->special = p;
 129     }
 130     while (strchr(" \t", *v))
 131         ++v;
 132     for (pe = v + strlen(v); pe != v; --pe)
 133         if (!strchr(" \n\r\t", pe[-1]))
 134             break;
 135     p->value = (char*) xmalloc (pe - v + 1);
 136     if (pe - v)
 137         memcpy (p->value, v, pe - v);
 138     p->value[pe - v] = '\0';
 139 }
 140
 141 static int next_token(const char **cpp, const char **dst)
 142 {
 143     int len = 0;
 144     const char *cp = *cpp;
 145     while (*cp && strchr(" \r\n\t\f", *cp))
 146         cp++;
 147     if (dst)
 148         *dst = cp;
 149     len = 0;
 150     while (*cp && !strchr(" \r\n\t\f", *cp))
 151     {
 152         cp++;
 153         len++;
 154     }
 155     *cpp = cp;
 156     return len;
 157 }
 158
 159 void ccl_qual_add_combi (CCL_bibset b, const char *n, const char *names)
 160 {
 161     const char *cp, *cp1;
 162     int i, len;
 163     struct ccl_qualifier *q;
 164     for (q = b->list; q && strcmp(q->name, n); q = q->next)
 165         ;
 166     if (q)
 167         return ;
 168     q = (struct ccl_qualifier *) xmalloc (sizeof(*q));
 169     q->name = ccl_strdup (n);
 170     q->attr_list = 0;
 171     q->next = b->list;
 172     b->list = q;
 173
 174     cp = names;
 175     for (i = 0; next_token(&cp, 0); i++)
 176         ;
 177     q->no_sub = i;
 178     q->sub = (struct ccl_qualifier **) xmalloc (sizeof(*q->sub) *
 179                                                (1+q->no_sub));
 180     cp = names;
 181     for (i = 0; (len = next_token(&cp, &cp1)); i++)
 182     {
 183         q->sub[i] = ccl_qual_lookup (b, cp1, len);
 184     }
 185 }
 186
 187 /*
 188  * ccl_qual_add: Add qualifier to Bibset. If qualifier already
 189  *               exists, then attributes are appendend to old
 190  *               definition.
 191  * name:    name of qualifier
 192  * no:      No of attribute type/value pairs.
 193  * pairs:   Attributes. pairs[0] first type, pair[1] first value,
 194  *          ... pair[2*no-2] last type, pair[2*no-1] last value.
 195  */
 196 void ccl_qual_add_set (CCL_bibset b, const char *name, int no, int *pairs,
 197                        char **attsets)
 198 {
 199     struct ccl_qualifier *q;
 200     struct ccl_rpn_attr **attrp;
 201
 202     ccl_assert (b);
 203     for (q = b->list; q; q = q->next)
 204         if (!strcmp (name, q->name))
 205             break;
 206     if (!q)
 207     {
 208         struct ccl_qualifier *new_qual =
 209             (struct ccl_qualifier *)xmalloc (sizeof(*new_qual));
 210         ccl_assert (new_qual);
 211
 212         new_qual->next = b->list;
 213         b->list = new_qual;
 214
 215         new_qual->name = ccl_strdup (name);
 216         attrp = &new_qual->attr_list;
 217
 218         new_qual->no_sub = 0;
 219         new_qual->sub = 0;
 220     }
 221     else
 222     {
 223         if (q->sub)
 224             xfree (q->sub);
 225         attrp = &q->attr_list;
 226         while (*attrp)
 227             attrp = &(*attrp)->next;
 228     }
 229     while (--no >= 0)
 230     {
 231         struct ccl_rpn_attr *attr;
 232
 233         attr = (struct ccl_rpn_attr *)xmalloc (sizeof(*attr));
 234         ccl_assert (attr);
 235         attr->set = *attsets++;
 236         attr->type = *pairs++;
 237         attr->value = *pairs++;
 238         *attrp = attr;
 239         attrp = &attr->next;
 240     }
 241     *attrp = NULL;
 242 }
 243
 244 /*
 245  * ccl_qual_mk: Make new (empty) bibset.
 246  * return:   empty bibset.
 247  */
 248 CCL_bibset ccl_qual_mk (void)
 249 {
 250     CCL_bibset b = (CCL_bibset)xmalloc (sizeof(*b));
 251     ccl_assert (b);
 252     b->list = NULL;
 253     b->special = NULL;
 254     return b;
 255 }
 256
 257 /*
 258  * ccl_qual_rm: Delete bibset.
 259  * b:        pointer to bibset
 260  */
 261 void ccl_qual_rm (CCL_bibset *b)
 262 {
 263     struct ccl_qualifier *q, *q1;
 264     struct ccl_qualifier_special *sp, *sp1;
 265
 266     if (!*b)
 267         return;
 268     for (q = (*b)->list; q; q = q1)
 269     {
 270         struct ccl_rpn_attr *attr, *attr1;
 271
 272         for (attr = q->attr_list; attr; attr = attr1)
 273         {
 274             attr1 = attr->next;
 275             if (attr->set)
 276                 xfree (attr->set);
 277             xfree (attr);
 278         }
 279         q1 = q->next;
 280         xfree (q->name);
 281         if (q->sub)
 282             xfree (q->sub);
 283         xfree (q);
 284     }
 285     for (sp = (*b)->special; sp; sp = sp1)
 286     {
 287         sp1 = sp->next;
 288         xfree (sp->name);
 289         xfree (sp->value);
 290         xfree (sp);
 291     }
 292     xfree (*b);
 293     *b = NULL;
 294 }
 295
 296 /*
 297  * ccl_qual_search: Search for qualifier in bibset.
 298  * b:      Bibset
 299  * name:   Name of qualifier to search for (need no null-termination)
 300  * len:    Length of name.
 301  * return: Attribute info. NULL if not found.
 302  */
 303 struct ccl_rpn_attr *ccl_qual_search (CCL_parser cclp,
 304                                       const char *name, size_t len,
 305                                       int seq)
 306 {
 307     struct ccl_qualifier *q;
 308
 309     ccl_assert (cclp);
 310     if (!cclp->bibset)
 311         return NULL;
 312     for (q = cclp->bibset->list; q; q = q->next)
 313         if (strlen(q->name) == len)
 314         {
 315             if (cclp->ccl_case_sensitive)
 316             {
 317                 if (!memcmp (name, q->name, len))
 318                     break;
 319             }
 320             else
 321             {
 322                 if (!ccl_memicmp (name, q->name, len))
 323                     break;
 324             }
 325         }
 326     if (q)
 327     {
 328         if (q->attr_list && seq == 0)
 329             return q->attr_list;
 330         if (seq < q->no_sub && q->sub[seq])
 331         {
 332             return q->sub[seq]->attr_list;
 333         }
 334     }
 335     return 0;
 336 }
 337
 338 const char *ccl_qual_search_special (CCL_bibset b,
 339                                      const char *name)
 340 {
 341     struct ccl_qualifier_special *q;
 342     if (!b)
 343         return 0;
 344     for (q = b->special; q && strcmp(q->name, name); q = q->next)
 345         ;
 346     if (q)
 347         return q->value;
 348     return 0;
 349 }