Hide the implementation of some types.

[gedcom-parse.git] / utf8 / utf8.h

diff --git a/utf8/utf8.h b/utf8/utf8.h
index 79836dd6d4aa265307fbcd143de342e46ca6c8e4..131dfbc3d245b6706ec23d207ec752a2fdc6b675 100644 (file)
--- a/utf8/utf8.h
+++ b/utf8/utf8.h
@@ -16,13 +16,38 @@
 extern "C" {
 #endif
 
+#include <sys/types.h>
+
+struct conv_buffer;
+struct convert;
+typedef struct conv_buffer *conv_buffer_t;
+typedef struct convert *convert_t;
+
   /* Returns -1 if the string is not a valid UTF-8 string, returns its
      string length otherwise */
 int   utf8_strlen(const char* input);
 
   /* Returns 1 if string is valid UTF-8 string, 0 otherwise */
 int   is_utf8_string(const char* input);
+
+  /* Functions for creating and freeing conversion buffers yourself */
+conv_buffer_t create_conv_buffer(int size);
+void free_conv_buffer(conv_buffer_t buf);
   
+  /* General conversion interface (is bidirectional) */
+  /* Pass 0 for external_outbuf unless you want to control the
+     output buffer yourself */
+convert_t initialize_utf8_conversion(const char* charset, int external_outbuf);
+int   conversion_set_unknown(convert_t conv, const char* unknown);
+int   conversion_set_output_buffer(convert_t conv, conv_buffer_t buf);
+void  cleanup_utf8_conversion(convert_t conv);
+char* convert_from_utf8(convert_t conv, const char* input, int* conv_fails);
+char* convert_to_utf8(convert_t conv, const char* input);
+char* convert_to_utf8_incremental(convert_t conv,
+                                 const char* input, size_t input_len);
+
+  /* Specific locale conversion interface (initializes a convert_t structure
+     implicitly */
 void  convert_set_unknown(const char* unknown);
 char* convert_utf8_to_locale(const char* input, int *conv_fails);
 char* convert_locale_to_utf8(const char* input);