string.hpp

浏览该文件的文档.

/*
 * @Description: 字符串工具函数 头文件及其实现
 * @Version: 
 * @Autor: dreamy-xay
 * @date: 2023-12-14
 * @LastEditors: dreamy-xay
 * @LastEditTime: 2024-03-01
 */
 
#ifndef COMMON_UTILS_STRING_HPP
#define COMMON_UTILS_STRING_HPP
 
#include <cstdarg>
#include <cstring>
#include <string>
 
#include "common/enum.h"
#include "common/macro.h"
#include "common/type.h"
#include "common/base/list.hpp"
 
/* declare */
namespace cm {
 
std::string Sprintf(const char* format, ...);
List<std::string> Ssplit(const std::string& original_str, const char* delimiter);
 
} // namespace cm
 
/* implement */
namespace cm {
 
inline std::string Sprintf(const char* format, ...) {
    va_list args;            // 定义va_list类型变量
    va_start(args, format);  // 初始化va_list变量
 
    // 获取格式化字符串的长度
    int length = std::vsnprintf(nullptr, 0, format, args);  // flawfinder: ignore
    va_end(args);
 
    std::string result;
    
    if (length >= 0) {
        result.resize(length);  // 如果实际需要的大小超过了初始分配的大小，重新调整缓冲区大小（增加一个字符用于存储终止符 '\0'）
 
        va_start(args, format);
        // flawfinder: ignore
        std::vsnprintf(&result[0], length + 1, format, args);  // 重新格式化字符串
        va_end(args);
    }
 
    return std::move(result);  // 将结果转换为std::string并返回
}
 
inline List<std::string> Ssplit(const std::string& original_str, const char* delimiter) {
    List<std::string> result;  // 结果数组
 
    // flawfinder: ignore
    if (strlen(delimiter) == 0)  // 如果字符串长度为0，则不处理
        return result;
 
    // 查找分隔符开始索引和查找到的索引
    std::size_t start = 0, index = original_str.find_first_of(delimiter, 0);
 
    // 查找整个字符串
    while (index != original_str.npos) {
        if (start != index)  // 如果不是第一个字符，则将字符串添加到结果数组中
            result.push_back(original_str.substr(start, index - start));
 
        start = index + 1;  // 更新查找开始索引
 
        index = original_str.find_first_of(delimiter, start);  // 查找下一个分隔符索引
    }
 
    if (start < original_str.size())  // 如果不是最后一个字符，则将字符串添加到结果数组中
        result.push_back(original_str.substr(start));
 
    return std::move(result);
}
 
} // namespace cm
 
 
#endif