1/* Copyright (C) 1999-2001 Bruno Haible. 2 This file is not part of the GNU LIBICONV Library. 3 This file is put into the public domain. */ 4 5/* 6 * This C function converts an entire string from one encoding to another, 7 * using iconv. Easier to use than iconv() itself, and supports autodetect 8 * encodings on input. 9 * 10 * int iconv_string (const char* tocode, const char* fromcode, 11 * const char* start, const char* end, 12 * char** resultp, size_t* lengthp) 13 * 14 * Converts a memory region given in encoding FROMCODE to a new memory 15 * region in encoding TOCODE. FROMCODE and TOCODE are as for iconv_open(3), 16 * except that FROMCODE may be one of the values 17 * "autodetect_utf8" supports ISO-8859-1 and UTF-8 18 * "autodetect_jp" supports EUC-JP, ISO-2022-JP-2 and SHIFT_JIS 19 * "autodetect_kr" supports EUC-KR and ISO-2022-KR 20 * The input is in the memory region between start (inclusive) and end 21 * (exclusive). If resultp is not NULL, the output string is stored in 22 * *resultp; malloc/realloc is used to allocate the result. 23 * 24 * This function does not treat zero characters specially. 25 * 26 * Return value: 0 if successful, otherwise -1 and errno set. Particular 27 * errno values: EILSEQ and ENOMEM. 28 * 29 * Example: 30 * const char* s = ...; 31 * char* result = NULL; 32 * if (iconv_string("UCS-4-INTERNAL", "autodetect_utf8", 33 * s, s+strlen(s)+1, &result, NULL) < 0) 34 * perror("iconv_string"); 35 * 36 */ 37#include <stddef.h> 38 39#ifdef __cplusplus 40extern "C" { 41#endif 42 43extern int iconv_string (const char* tocode, const char* fromcode, const char* start, const char* end, char** resultp, size_t* lengthp); 44 45#ifdef __cplusplus 46} 47#endif 48