mirror of
https://gitee.com/acl-dev/acl.git
synced 2024-12-14 00:40:55 +08:00
117 lines
3.1 KiB
C++
117 lines
3.1 KiB
C++
#pragma once
|
||
#include "../acl_cpp_define.hpp"
|
||
|
||
#include "string.hpp"
|
||
#include "pipe_stream.hpp"
|
||
|
||
struct ACL_VSTRING;
|
||
|
||
namespace acl {
|
||
|
||
class ACL_CPP_API charset_conv : public pipe_stream
|
||
{
|
||
public:
|
||
charset_conv(void);
|
||
~charset_conv(void);
|
||
|
||
/**
|
||
* 设置是否允许将无效的字符集直接拷贝
|
||
* @param onoff {bool} 当为 true 时，则转码过程中如果遇到了
|
||
* 非法字符集，则直接拷贝，否则则跳过，默认情况下是直接拷贝
|
||
*/
|
||
void set_add_invalid(bool onoff);
|
||
|
||
/**
|
||
* 转换函数
|
||
* @param fromCharset {const char*} 源字符集
|
||
* @param toCharset {const char*} 目标字符集
|
||
* @param in {const char*} 输入的源数据地址(非空)
|
||
* @param n {size_t} 输入源数据的长度(>0)
|
||
* @param out {string*} 存储转换结果
|
||
* @return {bool} 转换是否成功
|
||
*/
|
||
bool convert(const char* fromCharset, const char* toCharset,
|
||
const char* in, size_t n, string* out);
|
||
|
||
/**
|
||
* 如果转换失败, 该函数返回出错原因
|
||
* @return {const char*} 出错原因
|
||
*/
|
||
const char* serror(void) const;
|
||
|
||
/**
|
||
* 重置转码状态, 该解析器便可重复使用, 但在再次使用前需要调用
|
||
* set(from, to) 设置源字符集与目标字符集
|
||
*/
|
||
void reset(void);
|
||
|
||
/* 流式分析过程：update_begin->update->update ... ->update_finish */
|
||
|
||
/**
|
||
* 初始化流式分析的相关参数
|
||
* @param fromCharset {const char*} 源字符集
|
||
* @param toCharset {const char*} 目标字符集
|
||
* @return {bool} 初始化是否成功
|
||
*/
|
||
bool update_begin(const char* fromCharset, const char* toCharset);
|
||
|
||
/**
|
||
* 以流式方式进行字符集转换
|
||
* @param in {const char*} 源字符串
|
||
* @param len {size_t} in 字符串长度
|
||
* @param out {string*} 存储转换结果
|
||
* @return {bool} 当前转换过程是否成功
|
||
*/
|
||
bool update(const char* in, size_t len, string* out);
|
||
|
||
/**
|
||
* 流式转换结束后需要调用此函数提取最后的转换结果
|
||
* @param out {string*} 存储转换结果
|
||
*/
|
||
void update_finish(string* out);
|
||
|
||
/**
|
||
* 创建字符集转换器
|
||
* @param fromCharset {const char*} 源字符集
|
||
* @param toCharset {const char*} 目标字符集
|
||
* @return {charset_conv*} 如果输入参数非法，或源字符集
|
||
* 与目标字符集相同，或不支持两个字符集间的转换则返回NULL，
|
||
* 用完后需要调用 delete 删除
|
||
*/
|
||
static charset_conv* create(const char* fromCharset,
|
||
const char* toCharset);
|
||
|
||
// pipe_stream 虚函数重载
|
||
|
||
virtual int push_pop(const char* in, size_t len,
|
||
string* out, size_t max = 0);
|
||
virtual int pop_end(string* out, size_t max = 0);
|
||
virtual void clear();
|
||
|
||
public:
|
||
|
||
private:
|
||
bool m_addInvalid; // 如果遇到无效的字符集，是否直接拷贝
|
||
string m_errmsg;
|
||
string* m_pBuf;
|
||
char m_fromCharset[32];
|
||
char m_toCharset[32];
|
||
void* m_iconv;
|
||
ACL_VSTRING* m_pInBuf;
|
||
ACL_VSTRING* m_pOutBuf;
|
||
const char* m_pUtf8Pre;
|
||
};
|
||
|
||
/**
|
||
* 该 C-like API 可以更方便快捷地方便进行字符集转换
|
||
* @param in {const char*} 输入字符串(非空字符串)
|
||
* @param len {size_t} 输入字符串长度(>0)
|
||
* @param from_charset {const char*} 源字符集编码
|
||
* @param to_charset {constchar*} 目标字符集编码
|
||
* @return {string} 返回的 string 对象非空时(即: !string.empty()) 表示转换成功
|
||
*/
|
||
ACL_CPP_API string strconv(const char* in, size_t len,
|
||
const char* from_charset, const char* to_charset);
|
||
|
||
} // namespace acl
|