/** 字符串工具类 */
const StringUtil = {
    /**
     * 随机生成一个中文字符串
     * @param {number} length 要生成的字符串长度
     * @returns {string} 随机中文字符串
     */
    randomChineseString(length) {
        const characters = "丰王井开夫天无元专云扎艺木不太犬区历尤友匹车巨牙屯比互切瓦少日中冈贝内水见午毛气升长仁什片仆化仇币仍斤爪反介父从今凶分乏公仓月氏勿欠风丹匀乌凤勾文六方火为忆订计户认心尺引丑巴孔队办以允劝双书幻";
        let result = '';
        for (let i = 0; i < length; i++) {
            result += characters.charAt(Math.floor(Math.random() * characters.length));
        }
        //console.log("randomChineseString result:", result)
        return result;
    },

    /**
     * 将字符串按照指定的分隔符进行分割，并将分隔符也包含在结果数组中
     * @param {string} str - 要分割的原始字符串
     * @param {string} separator - 用于分割字符串的分隔符
     * @returns {Array<string>} 包含分割后的字符串片段和分隔符的数组
     * 
     * @example
     * // 基本用法
     * StringUtil.splitStringIncludeSeparator("hello,world,test", ",")
     * // 返回: ["hello", ",", "world", ",", "test"]
     * 
     * // 包含连续分隔符的情况
     * StringUtil.splitStringIncludeSeparator("a,,b", ",")
     * // 返回: ["a", ",", "", ",", "b"]
     * 
     * // 分隔符在开头或结尾
     * StringUtil.splitStringIncludeSeparator(",hello", ",")
     * // 返回: ["", ",", "hello"]
     * 
     * // 多字符分隔符
     * StringUtil.splitStringIncludeSeparator("a::b::c", "::")
     * // 返回: ["a", "::", "b", "::", "c"]
     * 
     * // 不包含分隔符的字符串
     * StringUtil.splitStringIncludeSeparator("hello", ",")
     * // 返回: [] (空数组)
     */
    splitStringIncludeSeparator(str, separator) {
        //console.log("splitStringIncludeSeparator str:", str, "separator:", separator)
        let arr = [];
        if (str.includes(separator)) {
            while (true) {
                let n = str.indexOf(separator);
                if (n != -1) {
                    let firstStr = str.substring(0, n);
                    let separatorStr = str.substring(n, n + separator.length);
                    str = str.substring(n + separator.length);

                    if (firstStr.length > 0)
                        arr.push(firstStr);

                    if (separatorStr.length > 0)
                        arr.push(separatorStr);
                } else {
                    if (str.length > 0)
                        arr.push(str);
                    break;
                }
            }
        }
        return arr;
    }
};

// 导出工具类，供其他文件导入使用
module.exports = { StringUtil };//使用 CommonJS 模块导出方式