1 /* Header file for UTF-8 functions
2 Copyright (C) 2001, 2002 Peter Verthez
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
24 int type; /* For internal use */
30 struct conv_buffer* inbuf;
32 struct conv_buffer* outbuf;
36 typedef struct convert *convert_t;
38 /* Returns -1 if the string is not a valid UTF-8 string, returns its
39 string length otherwise */
40 int utf8_strlen(const char* input);
42 /* Returns 1 if string is valid UTF-8 string, 0 otherwise */
43 int is_utf8_string(const char* input);
45 /* Functions for creating and freeing conversion buffers yourself */
46 struct conv_buffer* create_conv_buffer(int size);
47 void free_conv_buffer(struct conv_buffer* buf);
49 /* General conversion interface (is bidirectional) */
50 /* Pass 0 for external_outbuf unless you want to control the
51 output buffer yourself */
52 convert_t initialize_utf8_conversion(const char* charset, int external_outbuf);
53 int conversion_set_unknown(convert_t conv, const char* unknown);
54 int conversion_set_output_buffer(convert_t conv, struct conv_buffer* buf);
55 void cleanup_utf8_conversion(convert_t conv);
56 char* convert_from_utf8(convert_t conv, const char* input, int* conv_fails);
57 char* convert_to_utf8(convert_t conv, const char* input);
58 char* convert_to_utf8_incremental(convert_t conv,
59 const char* input, size_t input_len);
61 /* Specific locale conversion interface (initializes a convert_t structure
63 void convert_set_unknown(const char* unknown);
64 char* convert_utf8_to_locale(const char* input, int *conv_fails);
65 char* convert_locale_to_utf8(const char* input);