X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=include%2Fyaz%2Ffacet.h;h=6ce1744e35ac2d0d52e7ec62e160bc74c7b82834;hp=687ce548647863005abfe5c1a683d2123c368c2d;hb=2cb501be3b31d5ddc14de30498fadb4b31d56fb5;hpb=df0a3ba592afe51a91a54152c3add5d1b51604a8 diff --git a/include/yaz/facet.h b/include/yaz/facet.h index 687ce54..6ce1744 100644 --- a/include/yaz/facet.h +++ b/include/yaz/facet.h @@ -1,51 +1,112 @@ +/* This file is part of the YAZ toolkit. + * Copyright (C) Index Data. + * All rights reserved. + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * * Neither the name of Index Data nor the names of its contributors + * may be used to endorse or promote products derived from this + * software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY + * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +/** + * \file facet.h + * \brief Header for the facet utilities + */ #ifndef YAZ_FACET_H #define YAZ_FACET_H #include +#include #include +#include #include YAZ_BEGIN_CDECL - /* * Helper function for extracting facet values from the ASN structures. * */ -/* A helper structure to extract all the attribute stuff - from one Z_AttributesList. The pointers will all be to +/** A helper structure to extract all the attribute stuff + from one Z_AttributesList for facets. The pointers will all be to the Z-structures, or to constants, so there is no need to worry about freeing them */ -struct attrvalues { +struct yaz_facet_attr { int errcode; /* set in case of errors */ char *errstring; /* opt */ const char *useattr; /* @attr 1, from a string attr */ /* or number converted to a string */ /* defaults to 'any' */ char useattrbuff[30]; /* for converting numbers to strings */ - char *relation; /* @attr 2, defaults to '=' */ - int limit; /* for facet attributes */ + int sortorder; + int limit; + int start; }; +YAZ_EXPORT +void yaz_facet_attr_init(struct yaz_facet_attr *attr_values); -/* Use attribute, @attr1, can be numeric or string */ YAZ_EXPORT -void useattr ( Z_AttributeElement *ae, struct attrvalues *av ); +void yaz_facet_attr_get_z_attributes(const Z_AttributeList *attributes, + struct yaz_facet_attr *av); YAZ_EXPORT -void relationattr ( Z_AttributeElement *ae, struct attrvalues *av ); +Z_FacetTerm *facet_term_create_cstr(ODR odr, const char *cstr, Odr_int freq); YAZ_EXPORT -void limitattr ( Z_AttributeElement *ae, struct attrvalues *av ); +Z_FacetField* facet_field_create(ODR odr, Z_AttributeList *attributes, + int num_terms); YAZ_EXPORT -void limitattr ( Z_AttributeElement *ae, struct attrvalues *av ); +void facet_field_term_set(ODR odr, Z_FacetField *field, + Z_FacetTerm *facetTerm, int index); YAZ_EXPORT -void facetattrs( Z_AttributeList *attributes, struct attrvalues *av ); +Z_FacetList* facet_list_create(ODR odr, int num_facets); +YAZ_EXPORT +void facet_list_field_set(ODR odr, Z_FacetList *list, Z_FacetField *field, + int index); +YAZ_EXPORT +void yaz_oi_set_facetlist( + Z_OtherInformation **otherInformation, ODR odr, Z_FacetList *facet_list); + +YAZ_EXPORT +Z_FacetList *yaz_oi_get_facetlist(Z_OtherInformation **otherInformation); + +YAZ_EXPORT +void yaz_oi_set_facetlist(Z_OtherInformation **otherInformation, ODR odr, + Z_FacetList *facet_list); +YAZ_END_CDECL + #endif +/* + * Local variables: + * c-basic-offset: 4 + * c-file-style: "Stroustrup" + * indent-tabs-mode: nil + * End: + * vim: shiftwidth=4 tabstop=8 expandtab + */ +