X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=include%2Fyaz%2Fwrbuf.h;h=4db046c94905bf3c98368e11cf7d7b0d5b558725;hp=3864c3e275b4d6a4a4409bfb309fb7f6ece60686;hb=2cb501be3b31d5ddc14de30498fadb4b31d56fb5;hpb=574ae68dc570706b4468b29e82681efe15bc7180 diff --git a/include/yaz/wrbuf.h b/include/yaz/wrbuf.h index 3864c3e..4db046c 100644 --- a/include/yaz/wrbuf.h +++ b/include/yaz/wrbuf.h @@ -1,5 +1,5 @@ /* This file is part of the YAZ toolkit. - * Copyright (C) 1995-2013 Index Data. + * 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: @@ -139,7 +139,22 @@ YAZ_EXPORT void wrbuf_printf(WRBUF b, const char *fmt, ...) #endif ; -/** \brief general writer of string using iconv and cdata +/** \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 @@ -149,9 +164,13 @@ YAZ_EXPORT void wrbuf_printf(WRBUF b, const char *fmt, ...) \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); + size_t size, int cdata) +#ifdef __GNUC__ + __attribute__ ((deprecated)) +#endif + ; -/** \brief iconv converts buffer and appends to WRBUF +/** \brief Converts buffer using iconv and appends to WRBUF \param b WRBUF \param cd iconv handle \param buf buffer @@ -160,7 +179,7 @@ int wrbuf_iconv_write_x(WRBUF b, yaz_iconv_t cd, const char *buf, YAZ_EXPORT void wrbuf_iconv_write(WRBUF b, yaz_iconv_t cd, const char *buf, size_t size); -/** \brief iconv converts buffer and appends to WRBUF as XML CDATA +/** \brief Converts buffer using iconv and appends to WRBUF as XML CDATA \param b WRBUF \param cd iconv handle \param buf buffer