/*
 * .============.
 * // M A K E / \
 * // C++ DEV / \
 * // E A S Y / \/ \
 * ++ ----------. \/\ .
 * \\ \ \ /\ /
 * \\ \ \ /
 * \\ \ \ /
 * -============'
 *
 * Copyright (c) 2018 Hevake and contributors, all rights reserved.
 *
 * This file is part of cpp-tbox (https://github.com/cpp-main/cpp-tbox)
 * Use of this source code is governed by MIT license that can be found
 * in the LICENSE file in the root of the source tree. All contributing
 * project authors may be found in the CONTRIBUTORS.md file in the root
 * of the source tree.
 */
#ifndef TBOX_UTIL_STRING_H_20220103
#define TBOX_UTIL_STRING_H_20220103

#include <stdint.h>
#include <string>
#include <vector>

namespace tbox {
namespace util {
namespace string {

/**
 * \brief 分隔字符串
 * \param src_str 被分隔的字串
 * \param sep 分隔字串
 * \param str_vec 分隔后输出的字串数组
 * \return 分隔得到了子字串个数
 */
size_t Split(const std::string &src_str, const std::string sep, std::vector<std::string> &str_vec);

/**
 * \brief 以空格分隔字串
 */
size_t SplitBySpace(const std::string &src_str, std::vector<std::string> &str_vec);

/**
 * \brief 合并字符串
 * \param str_vec 字串数组
 * \param delimiter 分隔符
 */
std::string Join(const std::vector<std::string> &str_vec, const std::string &delimiter = "");

/**
 * \brief 消除字串左边的空格符
 * \param orig_str 原始字串
 * \return 处理后的字串
 */
std::string StripLeft(const std::string &orig_str);

/**
 * \brief 消除字串右边的空格符
 * \param orig_str 原始字串
 * \return 处理后的字串
 */
std::string StripRight(const std::string &orig_str);

/**
 * \brief 消除字串双边的空格符
 * \param orig_str 原始字串
 * \return 处理后的字串
 */
std::string Strip(const std::string &orig_str);

/**
 * \brief 消除字串两边的引号,包括单引号与双引号
 * \param orig_str 原始字串
 * \return 处理后的字串
 */
std::string StripQuot(const std::string &orig_str);

/**
 * \brief 将原始数据转换成HEX字串
 *
 * \param data_ptr 原始数据内存地址
 * \param data_len 原始数据长度
 * \param uppercase HEX中a~f
 * \param delimiter 分隔字串
 *
 * \return 转换后的HEX字串
 */
std::string RawDataToHexStr(const void *data_ptr, uint16_t data_len,
 bool uppercase = false,
 const std::string &delimiter = std::string(" "));

//! 字符不是A-Z a-z 0-9
class NotAZaz09Exception : public std::exception {
 virtual const char* what() const throw() override {
 return "character not a-z A-Z 0-9";
 }
};

//! 字串个体超过2个
class MoreThan2CharException : public std::exception {
 virtual const char* what() const throw() override {
 return "more than 2 characters";
 }
};

/**
 * \brief 将HEX字串转换成原始数据
 *
 * \param hex_str HEX字串
 * \param out_ptr 输出到数据地址
 * \param out_len 输出到数据长度
 *
 * \return 实际转换的数据长度
 */
size_t HexStrToRawData(const std::string &hex_str, void *out_ptr, uint16_t out_len);

/**
 * \brief 将HEX字串转换成原始数据
 *
 * \param hex_str HEX字串
 * \param out 输出到数据vector
 * \param delimiter 分隔符,常用的分隔符有 " \t", ": ", ", "
 *
 * \return 实际转换的数据长度
 */
size_t HexStrToRawData(const std::string &hex_str, std::vector<uint8_t> &out, const std::string &delimiter = "");

/**
 * \brief 替换字串中指定个数的字串
 *
 * \param target_str 被修改的字串
 * \param pattern_str 匹配字串
 * \param replace_str 用于替换的字串
 * \param count 替换次数
 */
void Replace(std::string &target_str, const std::string &pattern_str, const std::string &replace_str,
 std::string::size_type start = 0, std::string::size_type count = 0);

/**
 * \brief 将字串中所有小写字母替换成大写
 *
 * \param origin_str 原始字串
 *
 * \return std::string 修改后的字串
 */
std::string ToUpper(const std::string &origin_str);

/**
 * \brief 将字串中所有大写字母替换成小写
 *
 * \param origin_str 原始字串
 *
 * \return std::string 修改后的字串
 */
std::string ToLower(const std::string &origin_str);

/**
 * \brief 判断字串是否以指定字串开头
 *
 * \param origin_str 原始字串
 * \param text 指定字串
 */
bool IsStartWith(const std::string &origin_str, const std::string &text);

/**
 * \brief 判断字串是否以指定字串结束
 *
 * \param origin_str 原始字串
 * \param text 指定字串
 */
bool IsEndWith(const std::string &origin_str, const std::string &text);

/**
 * \brief 提取多个字串的共同前缀
 *
 * \param str_vec 字串数组
 *
 * \return 共同前缀字串
 */
std::string ExtractCommonPrefix(const std::vector<std::string> &str_vec);

}
}
}

#endif //TBOX_UTIL_STRING_H_20220103