如何使std::cout在输出时丢弃ANSI转义序列？

有一台设备通过UTF-8编码发送字节流，其中包含由ESC符号（0x1B）开头的ANSI转义序列（如0x1B[?25h、0x1B[nJ、0x1B[u等），后续会使用std::cout打印该字节流。以下是几种实现强制丢弃这些转义序列的方法：

方法一：手动过滤字符串 #

先对输入的字符串进行预处理，过滤掉所有ANSI转义序列后再输出。核心逻辑是识别以0x1B开头的序列，直到遇到转义序列的结束标记（通常是a-z/A-Z范围内的字母），跳过这段内容。

示例代码：

#include <iostream>
#include <string>

std::string filter_ansi_escape(const std::string& input) {
    std::string result;
    bool in_escape_seq = false;

    for (char c : input) {
        if (c == 0x1B) {
            in_escape_seq = true;
            continue;
        }
        if (in_escape_seq) {
            // 转义序列以字母结尾，遇到字母则退出转义状态
            if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')) {
                in_escape_seq = false;
            }
            continue;
        }
        result += c;
    }
    return result;
}

int main() {
    std::string raw_data = "测试内容\x1B[2J\x1B[?25h，过滤后显示";
    std::string filtered_data = filter_ansi_escape(raw_data);
    std::cout << filtered_data << std::endl;
    return 0;
}

方法二：自定义流缓冲区 #

通过自定义std::streambuf，让std::cout直接使用这个缓冲区，实现输出时自动过滤转义序列，无需每次手动处理字符串。

示例代码：

#include <iostream>
#include <streambuf>

class AnsiFilterStreamBuf : public std::streambuf {
private:
    std::streambuf* target_buf;
    bool in_escape;

protected:
    int overflow(int c) override {
        if (c == EOF) {
            return target_buf->overflow(c);
        }
        if (c == 0x1B) {
            in_escape = true;
            return c;
        }
        if (in_escape) {
            if ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')) {
                in_escape = false;
            }
            return c;
        }
        return target_buf->overflow(c);
    }

public:
    AnsiFilterStreamBuf(std::streambuf* buf) : target_buf(buf), in_escape(false) {}
};

int main() {
    AnsiFilterStreamBuf filter_buf(std::cout.rdbuf());
    std::streambuf* original_buf = std::cout.rdbuf(&filter_buf);

    // 直接使用cout输出，自动过滤转义序列
    std::cout << "Hello\x1B[31m 带颜色的文本\x1B[0m，过滤后无颜色控制" << std::endl;

    // 恢复原缓冲区
    std::cout.rdbuf(original_buf);
    return 0;
}

注意事项 #

• 上述代码覆盖了绝大多数常见的ANSI转义序列（如CSI控制序列、简单转义命令），如果需要支持更复杂的特殊序列，可以参考ANSI转义序列的官方标准调整判断逻辑。
• 由于输入是UTF-8编码，过滤过程不会破坏多字节的UTF-8字符，因为转义序列都是单字节控制字符，不会干扰UTF-8的多字节结构。

内容的提问来源于stack exchange，提问作者Max Popov