kc3-lang/libiconv/extras/iconv_string.h

Branch - branch -master

• Show log

  Commit

• Hash : ce4e3740
  Author :
  Date : 2001-03-20T20:30:41
  

  Add copyright notice.
  

Download

• extras/iconv_string.h

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

Download