utf8/utf8.h

   1 /* Header file for UTF-8 functions
   2    Copyright (C) 2001, 2002 Peter Verthez
   3
   4    Permission granted to do anything with this file that you want, as long
   5    as the above copyright is retained in all copies.
   6    THERE IS NO WARRANTY - USE AT YOUR OWN RISK
   7 */
   8
   9 /* $Id$ */
  10 /* $Name$ */
  11
  12 #ifndef __UTF8_H
  13 #define __UTF8_H
  14
  15 #ifdef __cplusplus
  16 extern "C" {
  17 #endif
  18
  19 #include "iconv.h"
  20
  21 struct conv_buffer {
  22   char*   buffer;
  23   size_t  size;
  24 };
  25
  26 struct convert {
  27   iconv_t from_utf8;
  28   iconv_t to_utf8;
  29   struct conv_buffer* outbuf;
  30   char*   unknown;
  31 };
  32
  33 typedef struct convert *convert_t;
  34
  35   /* Returns -1 if the string is not a valid UTF-8 string, returns its
  36      string length otherwise */
  37 int   utf8_strlen(const char* input);
  38
  39   /* Returns 1 if string is valid UTF-8 string, 0 otherwise */
  40 int   is_utf8_string(const char* input);
  41
  42   /* General conversion interface (is bidirectional) */
  43 convert_t initialize_utf8_conversion(const char* charset);
  44 int   conversion_set_unknown(convert_t conv, const char* unknown);
  45 void  cleanup_utf8_conversion(convert_t conv);
  46 char* convert_from_utf8(convert_t conv, const char* input, int* conv_fails);
  47 char* convert_to_utf8(convert_t conv, const char* input);
  48
  49   /* Specific locale conversion interface */
  50 void  convert_set_unknown(const char* unknown);
  51 char* convert_utf8_to_locale(const char* input, int *conv_fails);
  52 char* convert_locale_to_utf8(const char* input);
  53
  54 #ifdef __cplusplus
  55 }
  56 #endif
  57
  58 #endif /* __UTF8_H */