Mercurial > pidgin
diff src/protocols/gg/iconv_string.h @ 2541:8229710b343b
[gaim-migrate @ 2554]
fun stuff.
committer: Tailor Script <tailor@pidgin.im>
author | Eric Warmenhoven <eric@warmenhoven.org> |
---|---|
date | Thu, 18 Oct 2001 20:56:59 +0000 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/protocols/gg/iconv_string.h Thu Oct 18 20:56:59 2001 +0000 @@ -0,0 +1,47 @@ +/* Copyright (C) 1999-2001 Bruno Haible. + This file is not part of the GNU LIBICONV Library. + This file is put into the public domain. */ + +/* + * This C function converts an entire string from one encoding to another, + * using iconv. Easier to use than iconv() itself, and supports autodetect + * encodings on input. + * + * int iconv_string (const char* tocode, const char* fromcode, + * const char* start, const char* end, + * char** resultp, size_t* lengthp) + * + * Converts a memory region given in encoding FROMCODE to a new memory + * region in encoding TOCODE. FROMCODE and TOCODE are as for iconv_open(3), + * except that FROMCODE may be one of the values + * "autodetect_utf8" supports ISO-8859-1 and UTF-8 + * "autodetect_jp" supports EUC-JP, ISO-2022-JP-2 and SHIFT_JIS + * "autodetect_kr" supports EUC-KR and ISO-2022-KR + * The input is in the memory region between start (inclusive) and end + * (exclusive). If resultp is not NULL, the output string is stored in + * *resultp; malloc/realloc is used to allocate the result. + * + * This function does not treat zero characters specially. + * + * Return value: 0 if successful, otherwise -1 and errno set. Particular + * errno values: EILSEQ and ENOMEM. + * + * Example: + * const char* s = ...; + * char* result = NULL; + * if (iconv_string("UCS-4-INTERNAL", "autodetect_utf8", + * s, s+strlen(s)+1, &result, NULL) < 0) + * perror("iconv_string"); + * + */ +#include <stddef.h> + +#ifdef __cplusplus +extern "C" { +#endif + +extern int iconv_string (const char* tocode, const char* fromcode, const char* start, const char* end, char** resultp, size_t* lengthp); + +#ifdef __cplusplus +} +#endif