C++如何实现字符串的按指定列宽进行自动折行排版显示-C++-PHP中文网

手动切分std::string时不能按字节截断utf-8字符，需解析utf-8编码识别字符边界，按显示列宽（ascii=1、cjk=2、emoji依终端设为2、tab展开为4空格）累加计数，超限时回退至软断点（空格/标点）换行。

c++如何实现字符串的按指定列宽进行自动折行排版显示

用 `std::string` 手动切分时，别直接按字符数截断

中文、全角标点、emoji 或 UTF-8 多字节字符会让简单 substr(i, width) 出错：可能把一个汉字切成两半，显示为乱码或崩溃。C++ 标准库不自带 Unicode 字符边界识别，所以必须先做字节到字符的对齐判断。

实际做法是遍历字节，用 static_cast<unsigned char></unsigned> 判断 UTF-8 首字节类型（0xxxxxxx、110xxxxx、1110xxxx、11110xxx），跳过后续的 10xxxxxx 字节。每识别完一个字符，才计入当前行宽度计数。

英文 ASCII 字符占 1 字节 → 算 1 宽度
中文/日文/韩文等常用 Unicode 字符多为 3 字节 UTF-8 编码 → 仍算 1 宽度（按“显示列宽”而非字节数）
emoji 如 ? 是 4 字节 UTF-8，但多数终端显示占 2 列 → 可按需设为 2，不能硬写死为 1
遇到制表符 '\t' 要展开为 4 或 8 空格再计算，否则折行位置会偏移

用 `icu::BreakIterator` 做真·按显示宽度折行太重，但最稳

如果项目已依赖 ICU 库（比如跨平台桌面应用），icu::BreakIterator::createLineInstance() 是唯一能正确处理中英文混排、CJK 标点不断行、西文连字符（hyphenation）、以及不同 locale 下换行规则的方案。它不看字节，而基于 Unicode Line Breaking Algorithm（UAX #14）。

注意它默认按“字符数”折行，要实现“列宽控制”，得配合 getColumnsWidth() 类似逻辑手动推进：每次 next() 得到候选断点后，调用自定义函数累加该段内每个字符的显示宽度（查 uniset 或用 u_getIntPropertyValue(c, UCHAR_EAST_ASIAN_WIDTH) 判别 F/W 宽度），直到超限再回退到上一个合法断点。

必须用 UNICODE_STRING_SIMPLE 构造 UnicodeString，避免隐式转换出错
BreakIterator 不缓存文本，每次 setText() 有开销，高频调用需复用实例
Android NDK 或某些嵌入式环境可能没 ICU，这时得降级到轻量级 UTF-8 解析

`std::wcout` 和宽字符不是解法，反而容易让事情更糟

有人想转 std::wstring 再用 wcout 输出，但这解决不了列宽问题：Windows 控制台对 wcout 支持差，Linux 终端也不保证 wchar_t 和显示列一一对应（比如 L'?' 这种增补平面字符在 wcwidth() 中返回 -1）。而且 C++ 标准不规定 wchar_t 编码，MSVC 是 UTF-16，GCC/Clang 通常是 UTF-32，混用极易出错。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

真正可用的是 POSIX 的 wcwidth() + mbstowcs() 组合，但仅限于 locale 设置为 UTF-8 的环境（setlocale(LC_CTYPE, "en_US.UTF-8")），且要处理转换失败返回 -1 的情况（如无效字节序列）。

wcwidth('\t') 返回 -1，得单独处理；wcwidth('a') 返回 1，wcwidth('汉') 返回 2（在大多数 UTF-8 locale 下）
mbstowcs() 遇到非法多字节序列会停在错误位置，必须检查返回值是否等于目标缓冲区大小
Windows 默认 locale 不是 UTF-8，mbstowcs() 在 CMD 中对中文基本失效，别试

最终推荐的轻量实操路径：UTF-8 字节解析 + 列宽映射表

90% 场景下，不需要 ICU 或宽字符。写一个不到 100 行的 wrap_string(const std::string& s, int max_cols) 函数即可：内部用状态机解析 UTF-8 字节流，维护当前行已用列数，对每个字符查宽度映射（ASCII=1，CJK=2，tab=4，control=0），超限时插入 '\n' 并重置计数。关键是要支持“保留单词完整性”——即英文单词不从中截断。

示例逻辑片段：

size_t i = 0;
while (i  max_cols && !line_empty) {
        result += '\n';
        current_line_cols = 0;
        // 若当前字符是空格/标点，可优先在此断；否则回退到上个空格位置
    }
    result += s.substr(prev_i, i - prev_i);
    current_line_cols += ch_width;
}