Gecko [ goons4good.org ]

Name	Size	Permission	Date
backend.h	15.2 KB	-rw-r--r--	2015-10-07 17:15
backtrace.h	2.08 KB	-rw-r--r--	2015-10-07 17:15
base64.h	2.39 KB	-rw-r--r--	2015-10-07 17:15
ccl.h	11.26 KB	-rw-r--r--	2015-10-07 17:15
ccl_xml.h	2.73 KB	-rw-r--r--	2015-10-07 17:15
charneg.h	3.73 KB	-rw-r--r--	2015-10-07 17:15
comstack.h	7.06 KB	-rw-r--r--	2015-10-07 17:15
cookie.h	2.27 KB	-rw-r--r--	2015-10-07 17:15
copy_types.h	3.01 KB	-rw-r--r--	2015-10-07 17:15
cql.h	14.82 KB	-rw-r--r--	2015-10-07 17:15
daemon.h	3.53 KB	-rw-r--r--	2015-10-07 17:15
diagbib1.h	10.14 KB	-rw-r--r--	2015-10-07 17:15
diagsru_update.h	3.66 KB	-rw-r--r--	2015-10-07 17:15
diagsrw.h	4.87 KB	-rw-r--r--	2015-10-07 17:15
dirent.h	2.18 KB	-rw-r--r--	2015-10-07 17:15
errno.h	2.24 KB	-rw-r--r--	2015-10-07 17:15
facet.h	3.63 KB	-rw-r--r--	2015-10-07 17:15
file_glob.h	3.16 KB	-rw-r--r--	2015-10-07 17:15
gettimeofday.h	2.08 KB	-rw-r--r--	2015-10-07 17:15
icu.h	7.56 KB	-rw-r--r--	2015-10-07 17:15
ill-core.h	46.03 KB	-rw-r--r--	2015-10-07 17:15
ill.h	2.43 KB	-rw-r--r--	2015-10-07 17:15
item-req.h	1.87 KB	-rw-r--r--	2015-10-07 17:15
json.h	6.66 KB	-rw-r--r--	2015-10-07 17:15
log.h	8.4 KB	-rw-r--r--	2015-10-07 17:15
logrpn.h	2.44 KB	-rw-r--r--	2015-10-07 17:15
marcdisp.h	16.52 KB	-rw-r--r--	2015-10-07 17:15
match_glob.h	2.2 KB	-rw-r--r--	2015-10-07 17:15
matchstr.h	3.59 KB	-rw-r--r--	2015-10-07 17:15
mutex.h	4.36 KB	-rw-r--r--	2015-10-07 17:15
nmem.h	7.42 KB	-rw-r--r--	2015-10-07 17:15
nmem_xml.h	2.08 KB	-rw-r--r--	2015-10-07 17:15
oclc-ill-req-ext.h	1.63 KB	-rw-r--r--	2015-10-07 17:15
odr.h	11.81 KB	-rw-r--r--	2015-10-07 17:15
oid_db.h	6.25 KB	-rw-r--r--	2015-10-07 17:15
oid_std.h	8.62 KB	-rw-r--r--	2015-10-07 17:15
oid_util.h	3.23 KB	-rw-r--r--	2015-10-07 17:15
options.h	3.11 KB	-rw-r--r--	2015-10-07 17:15
otherinfo.h	2.42 KB	-rw-r--r--	2015-10-07 17:15
poll.h	3.01 KB	-rw-r--r--	2015-10-07 17:15
pquery.h	3.5 KB	-rw-r--r--	2015-10-07 17:15
proto.h	8.28 KB	-rw-r--r--	2015-10-07 17:15
prt-ext.h	6.22 KB	-rw-r--r--	2015-10-07 17:15
query-charset.h	2.38 KB	-rw-r--r--	2015-10-07 17:15
querytowrbuf.h	2.43 KB	-rw-r--r--	2015-10-07 17:15
readconf.h	2.21 KB	-rw-r--r--	2015-10-07 17:15
record_conv.h	5.41 KB	-rw-r--r--	2015-10-07 17:15
record_render.h	2.55 KB	-rw-r--r--	2015-10-07 17:15
retrieval.h	5.24 KB	-rw-r--r--	2015-10-07 17:15
rpn2cql.h	3.82 KB	-rw-r--r--	2015-10-07 17:15
rpn2solr.h	3.85 KB	-rw-r--r--	2015-10-07 17:15
sc.h	3.35 KB	-rw-r--r--	2015-10-07 17:15
shptr.h	3.09 KB	-rw-r--r--	2015-10-07 17:15
snprintf.h	2.13 KB	-rw-r--r--	2015-10-07 17:15
soap.h	3.36 KB	-rw-r--r--	2015-10-07 17:15
solr.h	3.76 KB	-rw-r--r--	2015-10-07 17:15
sortspec.h	4.37 KB	-rw-r--r--	2015-10-07 17:15
spipe.h	2.64 KB	-rw-r--r--	2015-10-07 17:15
srw.h	12.04 KB	-rw-r--r--	2015-10-07 17:15
statserv.h	1.89 KB	-rw-r--r--	2015-10-07 17:15
stemmer.h	2.36 KB	-rw-r--r--	2015-10-07 17:15
tcpip.h	2.84 KB	-rw-r--r--	2015-10-07 17:15
test.h	4.32 KB	-rw-r--r--	2015-10-07 17:15
thread_create.h	2.65 KB	-rw-r--r--	2015-10-07 17:15
thread_id.h	2.13 KB	-rw-r--r--	2015-10-07 17:15
timing.h	3.21 KB	-rw-r--r--	2015-10-07 17:15
tokenizer.h	2.71 KB	-rw-r--r--	2015-10-07 17:15
tpath.h	4.05 KB	-rw-r--r--	2015-10-07 17:15
unix.h	2.04 KB	-rw-r--r--	2015-10-07 17:15
url.h	3.6 KB	-rw-r--r--	2015-10-07 17:15
wrbuf.h	9.26 KB	-rw-r--r--	2015-10-07 17:15
xmalloc.h	5.3 KB	-rw-r--r--	2015-10-07 17:15
xml_get.h	2.02 KB	-rw-r--r--	2015-10-07 17:15
xml_include.h	3.06 KB	-rw-r--r--	2015-10-07 17:15
xmlquery.h	2.24 KB	-rw-r--r--	2015-10-07 17:15
xmltypes.h	1.9 KB	-rw-r--r--	2015-10-07 17:15
yaz-ccl.h	2.11 KB	-rw-r--r--	2015-10-07 17:15
yaz-iconv.h	4.27 KB	-rw-r--r--	2015-10-07 17:15
yaz-util.h	4.51 KB	-rw-r--r--	2015-10-07 17:15
yaz-version.h	2.83 KB	-rw-r--r--	2015-10-07 17:15
yconfig.h	2.28 KB	-rw-r--r--	2015-10-07 17:15
z-accdes1.h	857 B	-rw-r--r--	2015-10-07 17:15
z-accform1.h	3.51 KB	-rw-r--r--	2015-10-07 17:15
z-acckrb1.h	1.1 KB	-rw-r--r--	2015-10-07 17:15
z-charneg.h	5 KB	-rw-r--r--	2015-10-07 17:15
z-core.h	39.23 KB	-rw-r--r--	2015-10-07 17:15
z-date.h	2.77 KB	-rw-r--r--	2015-10-07 17:15
z-diag1.h	8.69 KB	-rw-r--r--	2015-10-07 17:15
z-espec1.h	3.77 KB	-rw-r--r--	2015-10-07 17:15
z-estask.h	1.05 KB	-rw-r--r--	2015-10-07 17:15
z-exp.h	29.88 KB	-rw-r--r--	2015-10-07 17:15
z-facet-1.h	941 B	-rw-r--r--	2015-10-07 17:15
z-grs.h	4.37 KB	-rw-r--r--	2015-10-07 17:15
z-mterm2.h	877 B	-rw-r--r--	2015-10-07 17:15
z-oclcui.h	792 B	-rw-r--r--	2015-10-07 17:15
z-opac.h	2.85 KB	-rw-r--r--	2015-10-07 17:15
z-rrf1.h	1.65 KB	-rw-r--r--	2015-10-07 17:15
z-rrf2.h	820 B	-rw-r--r--	2015-10-07 17:15
z-sum.h	1.32 KB	-rw-r--r--	2015-10-07 17:15
z-sutrs.h	643 B	-rw-r--r--	2015-10-07 17:15
z-uifr1.h	2.42 KB	-rw-r--r--	2015-10-07 17:15
z-univ.h	1.19 KB	-rw-r--r--	2015-10-07 17:15
zes-admin.h	2.95 KB	-rw-r--r--	2015-10-07 17:15
zes-expi.h	3.02 KB	-rw-r--r--	2015-10-07 17:15
zes-exps.h	2.72 KB	-rw-r--r--	2015-10-07 17:15
zes-order.h	3.61 KB	-rw-r--r--	2015-10-07 17:15
zes-pquery.h	2.26 KB	-rw-r--r--	2015-10-07 17:15
zes-psched.h	3.46 KB	-rw-r--r--	2015-10-07 17:15
zes-pset.h	2.01 KB	-rw-r--r--	2015-10-07 17:15
zes-update.h	4.93 KB	-rw-r--r--	2015-10-07 17:15
zes-update0.h	4.45 KB	-rw-r--r--	2015-10-07 17:15
zgdu.h	4.84 KB	-rw-r--r--	2015-10-07 17:15
zoom.h	17.9 KB	-rw-r--r--	2015-10-07 17:15

Rename

/* 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 wrbuf.h
 * \brief Header for WRBUF (growing buffer)
 */

#ifndef WRBUF_H
#define WRBUF_H

#include <yaz/xmalloc.h>
#include <yaz/yaz-iconv.h>

YAZ_BEGIN_CDECL

/** \brief string buffer */
typedef struct wrbuf
{
    char *buf;
    size_t pos;
    size_t size;
} wrbuf, *WRBUF;

/** \brief construct WRBUF
    \returns WRBUF
 */
YAZ_EXPORT WRBUF wrbuf_alloc(void);

/** \brief destroy WRBUF and its buffer
    \param b WRBUF

For YAZ 4.0.2 WRBUF b may be NULL.
 */
YAZ_EXPORT void wrbuf_destroy(WRBUF b);

/** \brief empty WRBUF content (length of buffer set to 0)
    \param b WRBUF
 */
YAZ_EXPORT void wrbuf_rewind(WRBUF b);

/** \brief append constant size buffer to WRBUF
    \param b WRBUF
    \param buf buffer
    \param size size of buffer
 */
YAZ_EXPORT void wrbuf_write(WRBUF b, const char *buf, size_t size);

/** \brief inserts buffer into WRBUF at some position
    \param b WRBUF
    \param pos position (0=beginning)
    \param buf buffer
    \param size size of buffer
 */
YAZ_EXPORT void wrbuf_insert(WRBUF b, size_t pos, const char *buf, size_t size);

/** \brief appends C-string to WRBUF
    \param b WRBUF
    \param buf C-string (0-terminated)
 */
YAZ_EXPORT void wrbuf_puts(WRBUF b, const char *buf);

/** \brief appends C-string to WRBUF - void pointer variant
    \param buf C-string
    \param client_data assumed WRBUF
*/
YAZ_EXPORT void wrbuf_vp_puts(const char *buf, void *client_data);

/** \brief writes buffer of certain size to WRBUF and XML encode (as CDATA)
    \param b WRBUF
    \param cp CDATA
    \param size size of CDATA
 */
YAZ_EXPORT void wrbuf_xmlputs_n(WRBUF b, const char *cp, size_t size);

/** \brief writes C-String to WRBUF and XML encode (as CDATA)
    \param b WRBUF
    \param cp CDATA buffer (0-terminated)
 */
YAZ_EXPORT void wrbuf_xmlputs(WRBUF b, const char *cp);

/** \brief puts buf to WRBUF and replaces a single char
    \param b WRBUF
    \param buf buffer to append (C-string)
    \param from character "from"
    \param to charcter "to"
*/
YAZ_EXPORT void wrbuf_puts_replace_char(WRBUF b, const char *buf,
                                        const char from, const char to);

/** \brief writes C-string to WRBUF and escape non-ASCII characters
    \param b WRBUF
    \param str C-string

Non-ASCII characters will be presented as \\xDD .
 */
YAZ_EXPORT void wrbuf_puts_escaped(WRBUF b, const char *str);

/** \brief writes buffer to WRBUF and escape non-ASCII characters
    \param b WRBUF
    \param buf buffer
    \param len size of buffer

Non-ASCII characters will be presented as \\xDD .
 */
YAZ_EXPORT void wrbuf_write_escaped(WRBUF b, const char *buf, size_t len);

/** \brief writes printf result to WRBUF
    \param b WRBUF
    \param fmt printf-like format
 */
YAZ_EXPORT void wrbuf_printf(WRBUF b, const char *fmt, ...)
#ifdef __GNUC__
        __attribute__ ((format (printf, 2, 3)))
#endif
        ;

/** \brief General writer of string using iconv and cdata
    \param b WRBUF
    \param cd iconv handle (0 for no conversion)
    \param buf buffer
    \param size size of buffer
    \param wfunc write handler (that takes WRBUF only)
    \returns -1 if invalid sequence was encountered (truncation in effect)
    \returns 0 if buffer could be converted and written
*/
int wrbuf_iconv_write2(WRBUF b, yaz_iconv_t cd, const char *buf,
                       size_t size,
                       void (*wfunc)(WRBUF, const char *, size_t));

/** \brief writer of string using iconv and cdata

Obsolete: use wrbuf_iconv_write2 instead.
    \param b WRBUF
    \param cd iconv handle (0 for no conversion)
    \param buf buffer
    \param size size of buffer
    \param cdata non-zero for CDATA; 0 for cdata
    \returns -1 if invalid sequence was encountered (truncation in effect)
    \returns 0 if buffer could be converted and written
*/
int wrbuf_iconv_write_x(WRBUF b, yaz_iconv_t cd, const char *buf,
                        size_t size, int cdata)
#ifdef __GNUC__
    __attribute__ ((deprecated))
#endif
    ;

/** \brief Converts buffer using iconv and appends to WRBUF
    \param b WRBUF
    \param cd iconv handle
    \param buf buffer
    \param size size of buffer
*/
YAZ_EXPORT void wrbuf_iconv_write(WRBUF b, yaz_iconv_t cd, const char *buf,
                                 size_t size);

/** \brief Converts buffer using iconv and appends to WRBUF as XML CDATA
    \param b WRBUF
    \param cd iconv handle
    \param buf buffer
    \param size size of buffer
*/
YAZ_EXPORT void wrbuf_iconv_write_cdata(WRBUF b, yaz_iconv_t cd,
                                       const char *buf, size_t size);

/** \brief iconv converts C-string and appends to WRBUF
    \param b WRBUF
    \param cd iconv handle
    \param str C-string
*/
YAZ_EXPORT void wrbuf_iconv_puts(WRBUF b, yaz_iconv_t cd, const char *str);

/** \brief iconv converts C-string and appends to WRBUF as XML CDATA
    \param b WRBUF
    \param cd iconv handle
    \param str C-string
*/
YAZ_EXPORT void wrbuf_iconv_puts_cdata(WRBUF b, yaz_iconv_t cd,
                                       const char *str);

/** \brief iconv converts character and appends to WRBUF
    \param b WRBUF
    \param cd iconv handle
    \param ch character
*/
YAZ_EXPORT void wrbuf_iconv_putchar(WRBUF b, yaz_iconv_t cd, int ch);

/** \brief iconv reset(flush) to WRBUF
    \param b
    \param cd iconv handle

This function calls iconv(cd, 0, 0, ..) to make it
    flush any remaining content.
*/
YAZ_EXPORT void wrbuf_iconv_reset(WRBUF b, yaz_iconv_t cd);

/** \brief chips traling blanks away from WRBUF
    \param b WRBUF
*/
YAZ_EXPORT void wrbuf_chop_right(WRBUF b);

/** \brief cut size of WRBUF
    \param b WRBUF
    \param no_to_remove number of bytes to remove
 */
YAZ_EXPORT void wrbuf_cut_right(WRBUF b, size_t no_to_remove);

/** \brief grow WRBUF larger
    \param b WRBUF
    \param minsize make WRBUF at least this size

This function is normally not used by applications
*/
YAZ_EXPORT int wrbuf_grow(WRBUF b, size_t minsize);

#define wrbuf_len(b) ((b)->pos)
#define wrbuf_buf(b) ((b)->buf)

/** \brief returns WRBUF content as C-string
    \param b WRBUF (may not be NULL)
    \returns C-string
*/
YAZ_EXPORT const char *wrbuf_cstr(WRBUF b);

/** \brief returns WRBUF content as C-string or NULL
    \param b WRBUF
    \returns C-string or NULL

This function returns NULL if either b is NULL or length of buffer is 0
*/
YAZ_EXPORT
const char *wrbuf_cstr_null(WRBUF b);

#define wrbuf_putc(b, c) \
    ((void) ((b)->pos >= (b)->size ? wrbuf_grow(b, 1) : 0),  \
    (b)->buf[(b)->pos++] = (c))

/** \brief writes JSON text to WRBUF with escaping
    \param b result
    \param str input string to be encoded
*/
YAZ_EXPORT
void wrbuf_json_puts(WRBUF b, const char *str);

/** \brief writes JSON text to WRBUF with escaping
    \param b result
    \param cp char buffer
    \param sz size of char buffer
*/
YAZ_EXPORT
void wrbuf_json_write(WRBUF b, const char *cp, size_t sz);

YAZ_EXPORT
void wrbuf_iconv_json_write(WRBUF b, yaz_iconv_t cd,
                            const char *buf, size_t size);

YAZ_EXPORT
void wrbuf_iconv_json_puts(WRBUF b, yaz_iconv_t cd, const char *strz);

/** \brief writes SHA1 text to WRBUF
    \param b result
    \param cp char buffer
    \param sz size of char buffer
    \param hexit 1=hex mode; 0=binary
    \returns 0 if successful
    \returns -1 on error
*/
YAZ_EXPORT
int wrbuf_sha1_write(WRBUF b, const char *cp, size_t sz, int hexit);

/** \brief writes SHA1 text to WRBUF
    \param b result
    \param cp C-string
    \param hexit 1=hex mode; 0=binary
    \returns 0 if successful
    \returns -1 on error
*/
YAZ_EXPORT
int wrbuf_sha1_puts(WRBUF b, const char *cp, int hexit);

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
 */