extern "C" {
#endif
-#include "iconv.h"
-
-struct conv_buffer {
- char* buffer;
- size_t size;
-};
-
-struct convert {
- iconv_t from_utf8;
- iconv_t to_utf8;
- struct conv_buffer* outbuf;
- char* unknown;
-};
+#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
/* 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) */
-convert_t initialize_utf8_conversion(const char* charset);
+ /* 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);
-
- /* Specific locale conversion interface */
+char* convert_from_utf8(convert_t conv, const char* input, int* conv_fails,
+ size_t* output_len);
+char* convert_to_utf8(convert_t conv, const char* input, size_t input_len);
+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);