gbkcode.h

GBK码的分析

/*
 * gbkcode.h 
 * 俞磊([e-mail])
 * 作者对此代码不保留任何权利，也不承担任何责任。
 * 任何人均可无偿使用或复制此代码。
 */
/*! \file
 *  \brief 这是GBKCODE的头文件<br>
 *
 *  使用这些函数可以做到: <br>
 *  1) GBK代码转换为BIG5代码 <br>
 *  2) GBK代码转换为UNICODE代码 <br>
 *  3) 取得一个汉字的拼音(包括可能的多种读音) <br>
 *  4) 取得一个汉字的笔画数 <br>
 *  使用方法：<br>
 *    将gbkcode.c添加到你的C/C++程序的工程之中，在你需要用到这些函数的C/C++程序前包含gbkcode.h头文件。
*/
#ifndef GBKCODE_H
#define GBKCODE_H

#ifdef __cplusplus
extern "C" {
#endif

/*! \fn int char_gbk2big5( unsigned code, char *output)
 *  \brief GBK字符到BIG5的转换 
 *  \param code GBK代码
 *  \param output 输出的BIG5字符，应该预留好足够空间，至少3个字符的大小。
 *  \return 成功返回0, 失败返回非零
 */
int char_gbk2big5( unsigned code, char *output);

/*! \fn int char_gbk2unicode( unsigned  code, char *output)
 *  \brief GBK字符到UNICODE的转换 
 *  \param code GBK代码
 *  \param output 输出的UNICODE字符，应该预留好足够空间，至少5个字符的大小。
 *  \return 成功返回0, 失败返回非零
 */
int char_gbk2unicode( unsigned  code, char *output);

/*! \fn int gbkbihua(unsigned code)
 *  \brief 取得GBK汉字的笔画数
 *  \param code GBK代码
 *  \return 正常情况下返回笔画数，如果返回29，表示此字有29画或29画以上，如果返回30，表明不知道此字的笔画数，返回负数表示出错
 */
int gbkbihua(unsigned code);

/*! \fn int gbkpinyin( unsigned code, char*out, int index)
 *  \brief 取得GBK汉字的拼音
 *  \param code GBK代码
 *  \param out 返回的拼音字符串，应该预留好足够空间，至少10个字符的大小。
 *  \param index 多音字的情况下，设定要取得第几个拼音
 *  \return 返回此字有多少个读音，如果返回负值或零，表示出错。
 *  \note 调用此函数时，首先应该将index设为零，取得返回值以了解有多少读音。然后依次取得这些读音。
 */
int gbkpinyin( unsigned code, char*out, int index);

/*! \fn int file_gbk2big5(  char*infile,  char *outfile,  char* notfound)
 *  \brief 将GBK码的文件转换成BIG5的
 *  \param infile 输入的文件名
 *  \param outfile 输出的文件名
 *  \param outfound 对于无法转换的字，使用此字符串进行替换
 *  \return 成功时返回0。失败时返回负值。
 */
int file_gbk2big5(  char*infile,  char *outfile,  char* notfound);

/*! \fn  int file_gbk2unicode( char *infile, char *outfile)
 *  \brief 将GBK码的文件转换成UNICODE的
 *  \param infile 输入的文件名
 *  \param outfile 输出的文件名
 *  \return 成功时返回0。失败时返回负值。
 */
int file_gbk2unicode( char *infile, char *outfile);

#ifdef __cplusplus
}
#endif

#endif