FM / yaz

/usr/include/yaz

Name	Size	Mode	Actions
backend.h	15565	0644	edit dl rm
backtrace.h	2130	0644	edit dl rm
base64.h	2451	0644	edit dl rm
ccl.h	11534	0644	edit dl rm
ccl_xml.h	2794	0644	edit dl rm
charneg.h	3815	0644	edit dl rm
comstack.h	7232	0644	edit dl rm
cookie.h	2326	0644	edit dl rm
copy_types.h	3085	0644	edit dl rm
cql.h	15172	0644	edit dl rm
daemon.h	3615	0644	edit dl rm
diagbib1.h	10385	0644	edit dl rm
diagsru_update.h	3752	0644	edit dl rm
diagsrw.h	4990	0644	edit dl rm
dirent.h	2234	0644	edit dl rm
errno.h	2292	0644	edit dl rm
facet.h	3716	0644	edit dl rm
file_glob.h	3233	0644	edit dl rm
gettimeofday.h	2126	0644	edit dl rm
icu.h	7743	0644	edit dl rm
ill-core.h	47134	0644	edit dl rm
ill.h	2484	0644	edit dl rm
item-req.h	1915	0644	edit dl rm
json.h	6815	0644	edit dl rm
log.h	8598	0644	edit dl rm
logrpn.h	2494	0644	edit dl rm
marcdisp.h	16912	0644	edit dl rm
matchstr.h	3676	0644	edit dl rm
match_glob.h	2248	0644	edit dl rm
mutex.h	4463	0644	edit dl rm
nmem.h	7594	0644	edit dl rm
nmem_xml.h	2129	0644	edit dl rm
oclc-ill-req-ext.h	1673	0644	edit dl rm
odr.h	12095	0644	edit dl rm
oid_db.h	6399	0644	edit dl rm
oid_std.h	8826	0644	edit dl rm
oid_util.h	3309	0644	edit dl rm
options.h	3184	0644	edit dl rm
otherinfo.h	2477	0644	edit dl rm
poll.h	3086	0644	edit dl rm
pquery.h	3587	0644	edit dl rm
proto.h	8482	0644	edit dl rm
prt-ext.h	6369	0644	edit dl rm
query-charset.h	2436	0644	edit dl rm
querytowrbuf.h	2493	0644	edit dl rm
readconf.h	2261	0644	edit dl rm
record_conv.h	5541	0644	edit dl rm
record_render.h	2608	0644	edit dl rm
retrieval.h	5363	0644	edit dl rm
rpn2cql.h	3910	0644	edit dl rm
rpn2solr.h	3940	0644	edit dl rm
sc.h	3426	0644	edit dl rm
shptr.h	3161	0644	edit dl rm
snprintf.h	2177	0644	edit dl rm
soap.h	3443	0644	edit dl rm
solr.h	3851	0644	edit dl rm
sortspec.h	4470	0644	edit dl rm
spipe.h	2704	0644	edit dl rm
srw.h	12324	0644	edit dl rm
statserv.h	1940	0644	edit dl rm
stemmer.h	2420	0644	edit dl rm
tcpip.h	2907	0644	edit dl rm
test.h	4426	0644	edit dl rm
thread_create.h	2716	0644	edit dl rm
thread_id.h	2180	0644	edit dl rm
timing.h	3292	0644	edit dl rm
tokenizer.h	2777	0644	edit dl rm
tpath.h	4149	0644	edit dl rm
unix.h	2087	0644	edit dl rm
url.h	3689	0644	edit dl rm
wrbuf.h	9484	0644	edit dl rm
xmalloc.h	5423	0644	edit dl rm
xmlquery.h	2294	0644	edit dl rm
xmltypes.h	1949	0644	edit dl rm
xml_get.h	2071	0644	edit dl rm
xml_include.h	3133	0644	edit dl rm
yaz-ccl.h	2164	0644	edit dl rm
yaz-iconv.h	4377	0644	edit dl rm
yaz-util.h	4619	0644	edit dl rm
yaz-version.h	2895	0644	edit dl rm
yconfig.h	2332	0644	edit dl rm
z-accdes1.h	857	0644	edit dl rm
z-accform1.h	3591	0644	edit dl rm
z-acckrb1.h	1130	0644	edit dl rm
z-charneg.h	5125	0644	edit dl rm
z-core.h	40175	0644	edit dl rm
z-date.h	2840	0644	edit dl rm
z-diag1.h	8898	0644	edit dl rm
z-espec1.h	3865	0644	edit dl rm
z-estask.h	1077	0644	edit dl rm
z-exp.h	30596	0644	edit dl rm
z-facet-1.h	941	0644	edit dl rm
z-grs.h	4479	0644	edit dl rm
z-mterm2.h	877	0644	edit dl rm
z-oclcui.h	792	0644	edit dl rm
z-opac.h	2917	0644	edit dl rm
z-rrf1.h	1687	0644	edit dl rm
z-rrf2.h	820	0644	edit dl rm
z-sum.h	1352	0644	edit dl rm
z-sutrs.h	643	0644	edit dl rm
z-uifr1.h	2480	0644	edit dl rm
z-univ.h	1217	0644	edit dl rm
zes-admin.h	3021	0644	edit dl rm
zes-expi.h	3096	0644	edit dl rm
zes-exps.h	2787	0644	edit dl rm
zes-order.h	3701	0644	edit dl rm
zes-pquery.h	2310	0644	edit dl rm
zes-psched.h	3544	0644	edit dl rm
zes-pset.h	2056	0644	edit dl rm
zes-update.h	5053	0644	edit dl rm
zes-update0.h	4552	0644	edit dl rm
zgdu.h	4958	0644	edit dl rm
zoom.h	18334	0644	edit dl rm

Edit: /usr/include/yaz/cql.h (15172B)

/* 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 cql.h
    \brief Header with public definitions about CQL.
*/

#ifndef CQL_H_INCLUDED
#define CQL_H_INCLUDED
#include <stdio.h>
#include <yaz/nmem.h>
#include <yaz/wrbuf.h>

YAZ_BEGIN_CDECL

/** \brief CQL parser handle (opaque pointer) */
typedef struct cql_parser *CQL_parser;

/** \brief creates a CQL parser.
    \returns CCL parser

Returns CQL parser or NULL if parser could not be created.
 */
YAZ_EXPORT
CQL_parser cql_parser_create(void);

/** \brief destroys a CQL parser.
    \param cp CQL parser

This function does nothing if NULL if received.
 */
YAZ_EXPORT
void cql_parser_destroy(CQL_parser cp);

/** \brief parses a CQL query (string)
    \param cp CQL parser
    \param str CQL string
    \retval 0 success
    \retval !=0 failure
 */
YAZ_EXPORT
int cql_parser_string(CQL_parser cp, const char *str);

/** \brief parses CQL query (query stream)
    \param cp CQL parser
    \param getbyte function which reads one character from stream
    \param ungetbyte function which unreads one character from stream
    \param client_data data to be passed to stream functions
    \retval 0 success
    \retval !=0 failure

This function is similar to cql_parser_string but takes a
    functions to read each query character from a stream.

The functions pointers getbytes, ungetbyte are similar to
    that known from stdios getc, ungetc.
*/
YAZ_EXPORT
int cql_parser_stream(CQL_parser cp,
                      int (*getbyte)(void *client_data),
                      void (*ungetbyte)(int b, void *client_data),
                      void *client_data);

/** \brief parses CQL query (from FILE)
    \param cp CQL parser
    \param f file where query is read from
    \retval 0 success
    \retval !=0 failure

This function is similar to cql_parser_string but reads from
    stdio FILE handle instead.
*/
YAZ_EXPORT
int cql_parser_stdio(CQL_parser cp, FILE *f);

/** \brief configures strict mode
    \param cp CQL parser
    \param mode 1=enable strict mode, 0=disable strict mode

This function is similar to cql_parser_string but reads from
    stdio FILE handle instead.
*/
YAZ_EXPORT
void cql_parser_strict(CQL_parser cp, int mode);

/** \brief Node type: search term */
#define CQL_NODE_ST 1
/** \brief Node type: boolean */
#define CQL_NODE_BOOL 2
/** \brief Node type: sortby single spec */
#define CQL_NODE_SORT 3

/** \brief CQL parse tree (node)
 */
struct cql_node {
    /** node type */
    int which;
    union {
        /** which == CQL_NODE_ST */
        struct {
            /** CQL index */
            char *index;
            /** CQL index URI or NULL if no URI */
            char *index_uri;
            /** Search term */
            char *term;
            /** relation */
            char *relation;
            /** relation URL or NULL if no relation URI) */
            char *relation_uri;
            /** relation modifiers */
            struct cql_node *modifiers;
            /** term list */
            struct cql_node *extra_terms;
        } st;
        /** which == CQL_NODE_BOOL */
        struct {
            /** operator name "and", "or", ... */
            char *value;
            /** left operand */
            struct cql_node *left;
            /** right operand */
            struct cql_node *right;
            /** modifiers (NULL for no list) */
            struct cql_node *modifiers;
        } boolean;
        /** which == CQL_NODE_SORT */
        struct {
            char *index;
            /** next spec */
            struct cql_node *next;
            /** modifiers (NULL for no list) */
            struct cql_node *modifiers;
            /** search node */
            struct cql_node *search;
        } sort;
    } u;
};

/** \brief Private structure that describes the CQL properties (profile)
 */
struct cql_properties;

/** \brief Structure used by cql_buf_write_handler
 */
struct cql_buf_write_info {
    int max;
    int off;
    char *buf;
};

/** \brief Handler for cql_buf_write_info
 */
YAZ_EXPORT
void cql_buf_write_handler(const char *b, void *client_data);

/** \brief Prints a CQL node and all sub nodes.
    Hence this function prints the parse tree which is as returned by
    cql_parser_result.
*/
YAZ_EXPORT
void cql_node_print(struct cql_node *cn);

/** \brief creates a search clause node (st). */
YAZ_EXPORT
struct cql_node *cql_node_mk_sc(NMEM nmem, const char *index,
                                const char *relation, const char *term);

/** \brief applies a prefix+uri to "unresolved" index and relation URIs.
    "unresolved" URIs are those nodes where member index_uri / relation_uri
    is NULL.
*/
YAZ_EXPORT
struct cql_node *cql_apply_prefix(NMEM nmem, struct cql_node *cn,
                                  const char *prefix, const char *uri);

/** \brief creates a boolean node. */
YAZ_EXPORT
struct cql_node *cql_node_mk_boolean(NMEM nmem, const char *op);

/** \brief creates a sort single spec node. */
YAZ_EXPORT
struct cql_node *cql_node_mk_sort(NMEM nmem, const char *index,
    struct cql_node *modifiers);

/** \brief destroys a node and its children. */
YAZ_EXPORT
void cql_node_destroy(struct cql_node *cn);

/** duplicates a node (returns a copy of supplied node) . */
YAZ_EXPORT
struct cql_node *cql_node_dup (NMEM nmem, struct cql_node *cp);

/** \brief returns the parse tree of the most recently parsed CQL query.
    \param cp CQL parser
    \returns CQL node or NULL for failure
*/
YAZ_EXPORT
struct cql_node *cql_parser_result(CQL_parser cp);

/** \brief returns the sortby tree of the most recently parsed CQL query.
    \param cp CQL parser
    \returns CQL node or NULL for failure
*/
YAZ_EXPORT
struct cql_node *cql_parser_sort_result(CQL_parser cp);

/** \brief converts CQL tree to XCQL and writes to user-defined stream
    \param cn CQL node (tree)
    \param pr print function
    \param client_data data to be passed to pr function
 */
YAZ_EXPORT
void cql_to_xml(struct cql_node *cn,
                void (*pr)(const char *buf, void *client_data),
                void *client_data);
/** \brief converts CQL tree to XCQL and writes to file
    \param cn CQL node (tree)
    \param f file handle
 */
YAZ_EXPORT
void cql_to_xml_stdio(struct cql_node *cn, FILE *f);

/** \brief converts CQL tree to XCQL and writes result to buffer
    \param cn CQL node (tree)
    \param out buffer
    \param max size of buffer (max chars to write)
    \returns length of resulting buffer
 */
YAZ_EXPORT
int cql_to_xml_buf(struct cql_node *cn, char *out, int max);

/** \brief converts CQL tree to CCL and writes to user-defined stream
    \param cn CQL node (tree)
    \param pr print function
    \param client_data data to be passed to pr function
 */
YAZ_EXPORT
int cql_to_ccl(struct cql_node *cn,
               void (*pr)(const char *buf, void *client_data),
               void *client_data);

/** \brief converts CQL tree to CCL and writes to file
    \param cn CQL node (tree)
    \param f file handle
 */
YAZ_EXPORT
void cql_to_ccl_stdio(struct cql_node *cn, FILE *f);

/** \brief converts CQL tree to CCL and writes result to buffer
    \param cn CQL node (tree)
    \param out buffer
    \param max size of buffer (max chars to write)
    \retval 0 OK
    \retval -1 conversion error
    \retval -2 buffer too small (truncated)
 */
YAZ_EXPORT
int cql_to_ccl_buf(struct cql_node *cn, char *out, int max);

/** \brief stream handle for file (used by cql_to_xml_stdio) */
YAZ_EXPORT
void cql_fputs(const char *buf, void *client_data);

/** \brief CQL transform handle.
    The transform describes how to convert from CQL to PQF (Type-1 AKA RPN).
*/
typedef struct cql_transform_t_ *cql_transform_t;

/** \brief creates a CQL transform handle
    \returns transform handle or NULL for failure
*/
YAZ_EXPORT
cql_transform_t cql_transform_create(void);

/** \brief creates a CQL transform handle from am opened file handle
    \param f file where transformation spec is read
    \returns transform handle or NULL for failure

The transformation spec is read from a FILE handle which is assumed
    opened for reading.
*/
YAZ_EXPORT
cql_transform_t cql_transform_open_FILE (FILE *f);

/** \brief creates a CQL transform handle from a file
    \param fname name of where transformation spec is read
    \returns transform handle or NULL for failure
*/
YAZ_EXPORT
cql_transform_t cql_transform_open_fname(const char *fname);

/** \brief defines CQL transform pattern
    \param ct CQL transform handle
    \param pattern pattern string
    \param value pattern value
    \returns 0 for succes; -1 for failure
*/
YAZ_EXPORT
int cql_transform_define_pattern(cql_transform_t ct, const char *pattern,
                                 const char *value);

/** \brief destroys a CQL transform handle
    \param ct CQL transform handle
 */
YAZ_EXPORT
void cql_transform_close(cql_transform_t ct);

/** \brief tranforms PQF given a CQL tree (NOT re-entrant)
    \param ct CQL transform handle
    \param cn CQL node tree
    \param pr print function
    \param client_data data to be passed to pr
    \retval 0 success
    \retval != 0 error

The result is written to a user-defined stream.
*/
YAZ_EXPORT
int cql_transform(cql_transform_t ct,
                  struct cql_node *cn,
                  void (*pr)(const char *buf, void *client_data),
                  void *client_data);

/** \brief tranforms PQF given a CQL tree (re-entrant)
    \param ct CQL transform handle
    \param cn CQL node tree
    \param addinfo additional information (if error)
    \param pr print function
    \param client_data data to be passed to pr
    \retval 0 success
    \retval != 0 error code

The result is written to a user-defined stream.
*/
YAZ_EXPORT
int cql_transform_r(cql_transform_t ct, struct cql_node *cn,
                    WRBUF addinfo,
                    void (*pr)(const char *buf, void *client_data),
                    void *client_data);

/** \brief transforms PQF given a CQL tree from FILE (not re-entrant)
    \param ct CQL transform handle
    \param cn CQL tree
    \param f FILE where output is written
    \retval 0 success
    \retval !=0 failure (error code)

The result is written to a file specified by FILE handle (which must
    be opened for writing.
*/
YAZ_EXPORT
int cql_transform_FILE(cql_transform_t ct,
                       struct cql_node *cn, FILE *f);

/** \brief transforms PQF given a CQL tree from buffer (not re-entrant)
    \param ct CQL transform handle
    \param cn CQL tree
    \param out buffer for output
    \param max maximum bytes for output (size of buffer)
    \retval 0 success
    \retval !=0 failure (error code)
 */
YAZ_EXPORT
int cql_transform_buf(cql_transform_t ct,
                      struct cql_node *cn, char *out, int max);

/** \brief returns additional information for last transform
    \param ct CQL transform handle
    \param addinfo additional info (result)
    \returns error code
 */
YAZ_EXPORT
int cql_transform_error(cql_transform_t ct, const char **addinfo);

/** \brief sets error and addinfo for transform
    \param ct CQL transform handle
    \param error error code
    \param addinfo additional info
 */
YAZ_EXPORT
void cql_transform_set_error(cql_transform_t ct, int error, const char *addinfo);

/** \brief returns the CQL message corresponding to a given error code.
    \param code error code
    \returns text message
*/
YAZ_EXPORT
const char *cql_strerror(int code);

/** \brief returns the standard CQL context set URI.
    \returns CQL URI string
*/
YAZ_EXPORT
const char *cql_uri(void);

/** \brief compares two CQL strings (ala strcmp)
    \param s1 string 1
    \param s2 string 2
    \returns comparison value
    Compares two CQL strings (for relations, operators, etc)
    (unfortunately defined as case-insensitive unlike XML etc)
*/
YAZ_EXPORT
int cql_strcmp(const char *s1, const char *s2);

/** \brief compares two CQL strings (ala strncmp)
    \param s1 string 1
    \param s2 string 2
    \param n size
    \returns comparison value
    Compares two CQL strings at most n bytes
    (unfortunately defined as case-insensitive unlike XML etc)
 */
YAZ_EXPORT
int cql_strncmp(const char *s1, const char *s2, size_t n);

/** \brief converts CQL sortby to sortkeys (ala versions 1.1)
    \param cn CQL tree
    \param pr print function
    \param client_data data to be passed to pr function

This will take CQL_NODE_SORT entries and conver them to

path,schema,ascending,caseSensitive,missingValue
    items..

One for each sort keys. Where

path is string index for sorting

schema is schema for sort index

ascending is a boolean (0=false, 1=true). Default is true.

caseSensitive is a boolean. Default is false.

missingValue is a string and one of 'abort', 'highValue', 'lowValue',
    or 'omit'. Default is 'highValue'.

See also
    http://www.loc.gov/standards/sru/sru1-1archive/search-retrieve-operation.html#sort
*/
YAZ_EXPORT
int cql_sortby_to_sortkeys(struct cql_node *cn,
                           void (*pr)(const char *buf, void *client_data),
                           void *client_data);

/** \brief converts CQL sortby to sortkeys ..
    \param cn CQL tree
    \param out result buffer
    \param max size of buffer (allocated)
    \retval 0 OK
    \retval -1 ERROR
*/
YAZ_EXPORT
int cql_sortby_to_sortkeys_buf(struct cql_node *cn, char *out, int max);

YAZ_END_CDECL

#endif
/* CQL_H_INCLUDED */
/*
 * Local variables:
 * c-basic-offset: 4
 * c-file-style: "Stroustrup"
 * indent-tabs-mode: nil
 * End:
 * vim: shiftwidth=4 tabstop=8 expandtab
 */

cmd: