[u/mdw/putty] / charset / charset.h

/*
 * charset.h - header file for general character set conversion
 * routines.
 */

#ifndef charset_charset_h
#define charset_charset_h

#include <stddef.h>

/*
 * Enumeration that lists all the multibyte or single-byte
 * character sets known to this library.
 */
typedef enum {
    CS_NONE,			       /* used for reporting errors, etc */
    CS_ISO8859_1,
    CS_ISO8859_1_X11,		       /* X font encoding with VT100 glyphs */
    CS_ISO8859_2,
    CS_ISO8859_3,
    CS_ISO8859_4,
    CS_ISO8859_5,
    CS_ISO8859_6,
    CS_ISO8859_7,
    CS_ISO8859_8,
    CS_ISO8859_9,
    CS_ISO8859_10,
    CS_ISO8859_11,
    CS_ISO8859_13,
    CS_ISO8859_14,
    CS_ISO8859_15,
    CS_ISO8859_16,
    CS_CP437,
    CS_CP850,
    CS_CP852,
    CS_CP866,
    CS_CP1250,
    CS_CP1251,
    CS_CP1252,
    CS_CP1253,
    CS_CP1254,
    CS_CP1255,
    CS_CP1256,
    CS_CP1257,
    CS_CP1258,
    CS_KOI8_R,
    CS_KOI8_U,
    CS_MAC_ROMAN,
    CS_MAC_TURKISH,
    CS_MAC_CROATIAN,
    CS_MAC_ICELAND,
    CS_MAC_ROMANIAN,
    CS_MAC_GREEK,
    CS_MAC_CYRILLIC,
    CS_MAC_THAI,
    CS_MAC_CENTEURO,
    CS_MAC_SYMBOL,
    CS_MAC_DINGBATS,
    CS_MAC_ROMAN_OLD,
    CS_MAC_CROATIAN_OLD,
    CS_MAC_ICELAND_OLD,
    CS_MAC_ROMANIAN_OLD,
    CS_MAC_GREEK_OLD,
    CS_MAC_CYRILLIC_OLD,
    CS_MAC_UKRAINE,
    CS_MAC_VT100,
    CS_MAC_VT100_OLD,
    CS_VISCII,
    CS_HP_ROMAN8,
    CS_DEC_MCS,
    CS_UTF8
} charset_t;

typedef struct {
    unsigned long s0;
} charset_state;

/*
 * Routine to convert a MB/SB character set to Unicode.
 * 
 * This routine accepts some number of bytes, updates a state
 * variable, and outputs some number of Unicode characters. There
 * are no guarantees. You can't even guarantee that at most one
 * Unicode character will be output per byte you feed in; for
 * example, suppose you're reading UTF-8, you've seen E1 80, and
 * then you suddenly see FE. Now you need to output _two_ error
 * characters - one for the incomplete sequence E1 80, and one for
 * the completely invalid UTF-8 byte FE.
 * 
 * Returns the number of wide characters output; will never output
 * more than the size of the buffer (as specified on input).
 * Advances the `input' pointer and decrements `inlen', to indicate
 * how far along the input string it got.
 * 
 * The sequence of `errlen' wide characters pointed to by `errstr'
 * will be used to indicate a conversion error. If `errstr' is
 * NULL, `errlen' will be ignored, and the library will choose
 * something sensible to do on its own. For Unicode, this will be
 * U+FFFD (REPLACEMENT CHARACTER).
 */

int charset_to_unicode(const char **input, int *inlen,
                       wchar_t *output, int outlen,
		       int charset, charset_state *state,
		       const wchar_t *errstr, int errlen);

/*
 * Routine to convert Unicode to an MB/SB character set.
 * 
 * This routine accepts some number of Unicode characters, updates
 * a state variable, and outputs some number of bytes.
 * 
 * Returns the number of bytes characters output; will never output
 * more than the size of the buffer (as specified on input), and
 * will never output a partial MB character. Advances the `input'
 * pointer and decrements `inlen', to indicate how far along the
 * input string it got.
 * 
 * The sequence of `errlen' characters pointed to by `errstr' will
 * be used to indicate a conversion error. If `errstr' is NULL,
 * `errlen' will be ignored, and the library will choose something
 * sensible to do on its own (which will vary depending on the
 * output charset).
 */

int charset_from_unicode(const wchar_t **input, int *inlen,
                         char *output, int outlen,
			 int charset, charset_state *state,
			 const char *errstr, int errlen);

/*
 * Convert X11 encoding names to and from our charset identifiers.
 */
const char *charset_to_xenc(int charset);
int charset_from_xenc(const char *name);

/*
 * Convert MIME encoding names to and from our charset identifiers.
 */
const char *charset_to_mimeenc(int charset);
int charset_from_mimeenc(const char *name);

/*
 * Convert our own encoding names to and from our charset
 * identifiers.
 */
const char *charset_to_localenc(int charset);
int charset_from_localenc(const char *name);
int charset_localenc_nth(int n);

/*
 * Convert Mac OS script/region/font to our charset identifiers.
 */
int charset_from_macenc(int script, int region, int sysvers,
			const char *fontname);

#endif /* charset_charset_h */
Commit	Line	Data
2dc6356a	1	/*
	2	* charset.h - header file for general character set conversion
	3	* routines.
	4	*/
	5
	6	#ifndef charset_charset_h
	7	#define charset_charset_h
	8
	9	#include <stddef.h>
	10
	11	/*
	12	* Enumeration that lists all the multibyte or single-byte
	13	* character sets known to this library.
	14	*/
	15	typedef enum {
	16	CS_NONE, /* used for reporting errors, etc */
	17	CS_ISO8859_1,
	18	CS_ISO8859_1_X11, /* X font encoding with VT100 glyphs */
	19	CS_ISO8859_2,
	20	CS_ISO8859_3,
	21	CS_ISO8859_4,
	22	CS_ISO8859_5,
	23	CS_ISO8859_6,
	24	CS_ISO8859_7,
	25	CS_ISO8859_8,
	26	CS_ISO8859_9,
	27	CS_ISO8859_10,
	28	CS_ISO8859_11,
	29	CS_ISO8859_13,
	30	CS_ISO8859_14,
	31	CS_ISO8859_15,
	32	CS_ISO8859_16,
	33	CS_CP437,
	34	CS_CP850,
cd1a94ae	35	CS_CP852,
6d177721	36	CS_CP866,
2dc6356a	37	CS_CP1250,
	38	CS_CP1251,
	39	CS_CP1252,
	40	CS_CP1253,
	41	CS_CP1254,
	42	CS_CP1255,
	43	CS_CP1256,
	44	CS_CP1257,
	45	CS_CP1258,
	46	CS_KOI8_R,
	47	CS_KOI8_U,
	48	CS_MAC_ROMAN,
9a4486bd	49	CS_MAC_TURKISH,
	50	CS_MAC_CROATIAN,
	51	CS_MAC_ICELAND,
	52	CS_MAC_ROMANIAN,
	53	CS_MAC_GREEK,
	54	CS_MAC_CYRILLIC,
	55	CS_MAC_THAI,
	56	CS_MAC_CENTEURO,
	57	CS_MAC_SYMBOL,
	58	CS_MAC_DINGBATS,
	59	CS_MAC_ROMAN_OLD,
	60	CS_MAC_CROATIAN_OLD,
	61	CS_MAC_ICELAND_OLD,
	62	CS_MAC_ROMANIAN_OLD,
	63	CS_MAC_GREEK_OLD,
	64	CS_MAC_CYRILLIC_OLD,
	65	CS_MAC_UKRAINE,
	66	CS_MAC_VT100,
	67	CS_MAC_VT100_OLD,
2dc6356a	68	CS_VISCII,
	69	CS_HP_ROMAN8,
	70	CS_DEC_MCS,
	71	CS_UTF8
	72	} charset_t;
	73
	74	typedef struct {
	75	unsigned long s0;
	76	} charset_state;
	77
	78	/*
	79	* Routine to convert a MB/SB character set to Unicode.
	80	*
	81	* This routine accepts some number of bytes, updates a state
	82	* variable, and outputs some number of Unicode characters. There
	83	* are no guarantees. You can't even guarantee that at most one
	84	* Unicode character will be output per byte you feed in; for
	85	* example, suppose you're reading UTF-8, you've seen E1 80, and
	86	* then you suddenly see FE. Now you need to output _two_ error
	87	* characters - one for the incomplete sequence E1 80, and one for
	88	* the completely invalid UTF-8 byte FE.
	89	*
	90	* Returns the number of wide characters output; will never output
	91	* more than the size of the buffer (as specified on input).
	92	* Advances the `input' pointer and decrements `inlen', to indicate
	93	* how far along the input string it got.
	94	*
	95	* The sequence of `errlen' wide characters pointed to by `errstr'
	96	* will be used to indicate a conversion error. If `errstr' is
	97	* NULL, `errlen' will be ignored, and the library will choose
	98	* something sensible to do on its own. For Unicode, this will be
	99	* U+FFFD (REPLACEMENT CHARACTER).
	100	*/
	101
57191fa4	102	int charset_to_unicode(const char *input, int inlen,
57191fa4	103	wchar_t *output, int outlen,
2dc6356a	104	int charset, charset_state *state,
	105	const wchar_t *errstr, int errlen);
	106
	107	/*
	108	* Routine to convert Unicode to an MB/SB character set.
	109	*
	110	* This routine accepts some number of Unicode characters, updates
	111	* a state variable, and outputs some number of bytes.
	112	*
	113	* Returns the number of bytes characters output; will never output
	114	* more than the size of the buffer (as specified on input), and
	115	* will never output a partial MB character. Advances the `input'
	116	* pointer and decrements `inlen', to indicate how far along the
	117	* input string it got.
	118	*
	119	* The sequence of `errlen' characters pointed to by `errstr' will
	120	* be used to indicate a conversion error. If `errstr' is NULL,
	121	* `errlen' will be ignored, and the library will choose something
	122	* sensible to do on its own (which will vary depending on the
	123	* output charset).
	124	*/
	125
57191fa4	126	int charset_from_unicode(const wchar_t *input, int inlen,
57191fa4	127	char *output, int outlen,
2dc6356a	128	int charset, charset_state *state,
	129	const char *errstr, int errlen);
	130
	131	/*
	132	* Convert X11 encoding names to and from our charset identifiers.
	133	*/
	134	const char *charset_to_xenc(int charset);
	135	int charset_from_xenc(const char *name);
	136
	137	/*
	138	* Convert MIME encoding names to and from our charset identifiers.
	139	*/
	140	const char *charset_to_mimeenc(int charset);
	141	int charset_from_mimeenc(const char *name);
	142
8ef2b196	143	/*
d4413bd2	144	* Convert our own encoding names to and from our charset
	145	* identifiers.
	146	*/
	147	const char *charset_to_localenc(int charset);
	148	int charset_from_localenc(const char *name);
	149	int charset_localenc_nth(int n);
	150
	151	/*
8ef2b196	152	* Convert Mac OS script/region/font to our charset identifiers.
	153	*/
	154	int charset_from_macenc(int script, int region, int sysvers,
	155	const char *fontname);
	156
2dc6356a	157	#endif /* charset_charset_h */