Return to iconv_string.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / extras

Annotation of embedaddon/libiconv/extras/iconv_string.h, revision 1.1.1.1

1.1       misho       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
                     40: extern "C" {
                     41: #endif
                     42: 
                     43: extern 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