XM_project/plc调度节点/error_code/error_code.cpp

//Error_code是错误码的底层通用模块，
//功能：用作故障分析和处理。

//用法：所有的功能接口函数return错误管理类，
//然后上层判断分析错误码，并进行故障处理。



#include "error_code.h"

/////////////////////////////////////////////
//构造函数
Error_manager::Error_manager()
{
    m_error_code = SUCCESS;
    m_error_level = NORMAL;
}
//拷贝构造
Error_manager::Error_manager(const Error_manager & error_manager)
{
    this->m_error_code = error_manager.m_error_code;
    this->m_error_level = error_manager.m_error_level;
	this->m_error_description=error_manager.m_error_description;
    return ;
}
//赋值构造
Error_manager::Error_manager(Error_code error_code, Error_level error_level,
    const char* p_error_description)
{
    m_error_code = error_code;
    m_error_level = error_level;
    if(p_error_description!= nullptr)
	{
		m_error_description=std::string(p_error_description);
	}
	return ;
}
//赋值构造
Error_manager::Error_manager(Error_code error_code, Error_level error_level , std::string   error_aggregate_string)
{
    m_error_code = error_code;
    m_error_level = error_level;
    m_error_description=error_aggregate_string;
	return ;
}
//析构函数
Error_manager::~Error_manager()
{
}

//初始化
void Error_manager::error_manager_init()
{
    error_manager_clear_all();
    return;
}
void Error_manager::error_manager_init(Error_code error_code, Error_level error_level, const char* p_error_description)
{
    m_error_code = error_code;
    m_error_level = error_level;
	if(p_error_description!= nullptr)
	{
		m_error_description=std::string(p_error_description);
	}
	return ;
}
//初始化
void Error_manager::error_manager_init(Error_code error_code, Error_level error_level , std::string error_aggregate_string)
{
    m_error_code = error_code;
    m_error_level = error_level;
    m_error_description=error_aggregate_string;
    return ;
}
//重置
void Error_manager::error_manager_reset(Error_code error_code, Error_level error_level, const char* p_error_description)
{
    m_error_code = error_code;
    m_error_level = error_level;
	if(p_error_description!= nullptr)
	{
		m_error_description=std::string(p_error_description);
	}
	return ;
}
//重置
void Error_manager::error_manager_reset(Error_code error_code, Error_level error_level , std::string error_aggregate_string)
{
    m_error_code = error_code;
    m_error_level = error_level;
    m_error_description=error_aggregate_string;
	return;
}
//重置
void Error_manager::error_manager_reset(const Error_manager & error_manager)
{
    this->m_error_code = error_manager.m_error_code;
    this->m_error_level = error_manager.m_error_level;
	this->m_error_description=error_manager.m_error_description;
    return ;
}
//清除所有内容
void Error_manager::error_manager_clear_all()
{
    m_error_code = SUCCESS;
    m_error_level = NORMAL;
	m_error_description.clear();
	return;
}

//重载=
Error_manager& Error_manager::operator=(const Error_manager & error_manager)
{
    error_manager_reset(error_manager);
	return *this;
}
//重载=，支持Error_manager和Error_code的直接转化，会清空错误等级和描述
Error_manager& Error_manager::operator=(Error_code error_code)
{
    error_manager_clear_all();
    set_error_code(error_code);
	return *this;
}
//重载==
bool Error_manager::operator==(const Error_manager & error_manager)
{
	return is_equal_error_manager(error_manager);
}
//重载==，支持Error_manager和Error_code的直接比较
bool Error_manager::operator==(Error_code error_code)
{
    if(m_error_code == error_code)
    {
        return true;
    }
    else
    {
        return false;
    }
}

//重载!=
bool Error_manager::operator!=(const Error_manager & error_manager)
{
	return (! is_equal_error_manager(error_manager));
}
//重载!=，支持Error_manager和Error_code的直接比较
bool Error_manager::operator!=(Error_code error_code)
{
    if(m_error_code != error_code)
    {
        return true;
    }
    else
    {
        return false;
    }
}
//重载<<，支持cout<<
std::ostream & operator<<(std::ostream &out, Error_manager &error_manager)
{
	out << error_manager.to_string();
	return out;
}

//获取错误码
Error_code Error_manager::get_error_code()
{
    return m_error_code;
}
//获取错误等级
Error_level Error_manager::get_error_level()
{
    return m_error_level;
}
//获取错误描述的指针，（浅拷贝）
std::string Error_manager::get_error_description()
{
    return m_error_description;
}

//复制错误描述，（深拷贝）
//output：p_error_description     错误描述的字符串指针，不可以为NULL，必须要有实际的内存
//output:description_length      错误描述的字符串长度，不可以为0，长度最好足够大，一般256即可。
void Error_manager::copy_error_description(const char* p_error_description)
{
    if(p_error_description != NULL)
    {
        m_error_description=std::string(p_error_description);
    }
	return;
}
//复制错误描述，（深拷贝）
//output：error_description_string     错误描述的string
void Error_manager::copy_error_description(std::string error_description_string)
{
    m_error_description=error_description_string;
	return;
}

//设置错误码
void Error_manager::set_error_code(Error_code error_code)
{
    m_error_code = error_code;
    return;
}
//比较错误等级并升级，取高等级的结果
void Error_manager::set_error_level_up(Error_level error_level)
{
    if(m_error_level < error_level)
    {
        m_error_level = error_level;
    }
    return;
}
//比较错误等级并降级，取低等级的结果
void Error_manager::set_error_level_down(Error_level error_level)
{
    if(m_error_level > error_level)
    {
        m_error_level = error_level;
    }
    return;
}
//错误等级，设定到固定值
void Error_manager::set_error_level_location(Error_level error_level)
{
    m_error_level = error_level;
    return;
}
//设置错误描述
void Error_manager::set_error_description(const char* p_error_description)
{
	if(p_error_description != NULL)
	{
		m_error_description=std::string(p_error_description);
	}
	return;
}
//设置错误描述
void Error_manager::set_error_description(std::string error_description_string)
{
	m_error_description = error_description_string;
	return ;
}

//尾部追加错误描述
void Error_manager::add_error_description(const char* p_error_description)
{
    if(p_error_description !=NULL)
    {
        m_error_description+=std::string(p_error_description);
    }
}
//尾部追加错误描述
void Error_manager::add_error_description(std::string error_description_string)
{
    m_error_description+=error_description_string;
}

//比较错误是否相同，
// 注：只比较错误码和等级
bool Error_manager::is_equal_error_manager(const Error_manager & error_manager)
{
    if(this->m_error_code == error_manager.m_error_code
       && this->m_error_level == error_manager.m_error_level)
    {
        return true;
    }
    else
    {
        return false;
    }
}
//比较并覆盖错误，讲低级错误转为字符串存放于描述中，
//如果错误相同，则保留this的，将输入参数转入描述。
void Error_manager::compare_and_cover_error(const Error_manager & error_manager)
{
    if(this->m_error_code == SUCCESS)
    {
        error_manager_reset(error_manager);
    }
    else if (error_manager.m_error_code == SUCCESS)
    {
		return;
    }
    else
    {
        Error_manager t_error_manager_new;
        std::string pt_string_inside ;
        if(this->m_error_level < error_manager.m_error_level)
        {
            translate_error_to_string(pt_string_inside);
            error_manager_reset(error_manager);
            add_error_description(pt_string_inside);
        }
        else
        {
			((Error_manager&)error_manager).translate_error_to_string(pt_string_inside);
            add_error_description(pt_string_inside);
        }
    }
	return;
}
//比较并覆盖错误，讲低级错误转为字符串存放于描述中，
//如果错误相同，则保留this的，将输入参数转入描述。
void Error_manager::compare_and_cover_error( Error_manager * p_error_manager)
{
	if(this->m_error_code == SUCCESS)
	{
		error_manager_reset(*p_error_manager);
	}
	else if (p_error_manager->m_error_code == SUCCESS)
	{
		return;
	}
	else
	{
		Error_manager t_error_manager_new;
		std::string pt_string_inside;
		if(this->m_error_level < p_error_manager->m_error_level)
		{
			translate_error_to_string(pt_string_inside);
			error_manager_reset(*p_error_manager);
			add_error_description(pt_string_inside);
		}
		else
		{
			p_error_manager->translate_error_to_string(pt_string_inside);
			add_error_description(pt_string_inside);
		}
	}
}


//output：error_description_string     错误汇总的string
void Error_manager::translate_error_to_string(std::string error_aggregate_string)
{
    char t_string_array[255] = {0};
    sprintf(t_string_array, "error_code:0x%08x, error_level:%02d, error_description:",
            m_error_code , m_error_level);

    error_aggregate_string = t_string_array ;
	error_aggregate_string+= m_error_description;
	return;
}
//错误码转字符串的简易版，可支持cout<<
//return     错误汇总的string
std::string Error_manager::to_string()
{
	char t_string_array[255] = {0};
	sprintf(t_string_array, "error_code:0x%08x, error_level:%02d, error_description:",
            m_error_code , m_error_level);
    std::string error_aggregate_string = t_string_array ;
	error_aggregate_string+= m_error_description;
	return error_aggregate_string;
}




//释放错误描述的内存，
void Error_manager::free_description()
{
}

//重新分配错误描述的内存，并从外部拷贝新的（深拷贝）
//input：p_error_description     错误描述的字符串指针，可以为NULL，
//input:description_length      错误描述的字符串长度，如果为0，则从p_error_description里面获取有效的长度
void Error_manager::reallocate_memory_and_copy_string(const char* p_error_description, int description_length)
{
    return;
}


//重新分配错误描述的内存，并从外部拷贝新的（深拷贝）
//input：error_aggregate_string     错误描述的string
void Error_manager::reallocate_memory_and_copy_string(std::string error_aggregate_string)
{
    return;
}