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