std::setw和std::setfill不能截断字符串，仅当输出内容宽度不足时填充，超宽则原样输出；它们必须与流配合使用，且setw仅作用于下一次插入操作。
用 std::setw 和 std::setfill 无法直接截断字符串
很多人看到 std::setw 就以为能“控制字符串显示宽度”，但其实它只对 operator 输出起作用，且仅在输出时填充空格（或指定字符），完全不改变原字符串内容，更不会截断超长部分。如果你写了 <code>std::cout ，结果仍是完整输出 <code>hello world，setw 被忽略——因为输入长度 > 指定宽度时，setw 不生效。
手动截断 + 补全：核心逻辑是先裁剪再填充
真正可控的做法是显式处理字符串长度：先用 substr 截取前 n 个字符，再用 append 或构造函数补足到目标宽度。注意两个关键点：目标宽度是否包含原始内容？补全字符放左边还是右边？
- 若要求「最多显示
width字符，不足则右补空格」：str.substr(0, width).append(width - str.length(), ' ')是错的——str.length()可能大于width，应改为width - std::min(str.length(), (size_t)width) - 更安全写法：
auto clipped = str.substr(0, width); clipped.append(width - clipped.length(), ' ') - 若需左对齐补全（如日志字段对齐），用
append；若需右对齐，用std::string(width, ' ') + clipped再取后width位，或直接用std::string(width - clipped.length(), ' ') + clipped
处理中文等宽字符时，length() 不等于显示宽度
std::string::length() 返回字节数，不是字符数。UTF-8 编码下，一个中文字符占 3 字节，"你好".length() == 6，但显示宽度通常是 2 个英文字符位（假设等宽字体）。此时用 length() 做截断会错切字节，导致乱码。
- 简单规避方式：只处理 ASCII 字符串，或提前约定输入为单字节编码
- 严谨做法：用 ICU、utf8cpp 等库计算 Unicode 字符数（
utf8::distance），再按字符数截断 - 若只是日志/CLI 工具且终端支持 UTF-8，可依赖终端自动换行，不强行按“视觉宽度”截断，而按字节数截断后加
"…"提示截断（如clipped += "…"）
封装成可复用函数要注意 const 引用和移动语义
直接传 std::string 值参数会触发拷贝；传 const std::string& 安全，但返回新字符串时，现代编译器能自动应用 RVO 或移动构造，无需过度优化。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
std::string truncate_and_pad(const std::string& s, size_t width, char pad = ' ', bool right_pad = true) {
auto clipped = s.substr(0, width);
size_t pad_len = width > clipped.length() ? width - clipped.length() : 0;
if (right_pad) {
return clipped + std::string(pad_len, pad);
} else {
return std::string(pad_len, pad) + clipped;
}
}
调用示例：truncate_and_pad("abc", 5, '.', false) → "..abc"；truncate_and_pad("hello world", 5) → "hello"（无填充，因已满宽）。
容易被忽略的是：当 width == 0 时，substr(0, 0) 合法，但 pad_len 计算中 width > clipped.length() 为假，结果为空字符串——这符合直觉，但若业务要求强制返回 width 个 pad 字符，就得单独判断 width == 0。
