cpp-terminal源码级教程SIGWINCH信号与屏幕尺寸变化处理的实现秘密【免费下载链接】cpp-terminalC library for writing multiplatform terminal applications项目地址: https://gitcode.com/gh_mirrors/cp/cpp-terminalcpp-terminal是一款零依赖、跨平台的 C 终端应用库。本文带你深入源码揭秘它是如何处理SIGWINCH 信号、监听屏幕尺寸变化并把窗口缩放事件变成应用里一条普通事件的完整实现机制。为什么需要 SIGWINCH窗口一变谁在通知你的程序当你拖拽终端窗口边缘改变大小时内核会向前台进程发送一个名为SIGWINCHWindow Change的信号。这是 Linux/macOS 下感知尺寸变化的唯一官方途径。但直接用传统信号处理函数有个大坑信号处理函数中只能调用异步信号安全的极少数函数稍微复杂一点就可能死锁如果信号处理函数没执行完信号再次到来之前的会被直接丢弃——快速拖动窗口会丢事件Windows 根本没有 SIGWINCH 这个概念cpp-terminal 的解法是把信号彻底变成可读取的文件描述符塞进统一的 I/O 事件循环。这正是本文要拆解的核心。三平台、三条路径一套接口的跨平台设计所有平台差异都被收敛在一个极小的类里——sigwinch.hpp 中声明、sigwinch.cpp 中实现的Term::Private::Sigwinch对外只暴露 4 个静态方法方法职责registerSigwinch()注册信号监听机制blockSigwinch()用pthread_sigmask阻塞信号unblockSigwinch()退出时恢复信号isSigwinch(fd)判断某事件描述符是否是窗口变化并消费信号get()返回可被 I/O 多路复用的句柄三条实现路径泾渭分明1️⃣ Linuxsignalfd epoll 的黄金组合Linux 路径调用了signalfd(-1, set, SFD_NONBLOCK | SFD_CLOEXEC)——把 SIGWINCH 变成一个文件描述符m_fd。之后窗口变化 → 内核往m_fd里写入一段signalfd_siginfo数据epoll_wait像等待键盘输入一样等待它读到数据 收到一次 resizeread()同时完成了消费信号天然不会丢失后续事件信号从此只是数据不再有回调也就没有异步信号安全问题。2️⃣ macOS / WebAssemblyvolatile 标志位方案macOS 没有 signalfd。这里退回经典做法sigaction注册一个极简处理函数它唯一的工作就是把volatile sig_atomic_t m_signalStatus置 1。事件循环每次醒来时调isSigwinch()检查并清零这个标志。简单、可靠且处理函数短到不可能死锁。3️⃣ Windows根本没有信号用事件代替Windows 的控制台 API 会在输入队列里推送WINDOW_BUFFER_SIZE_EVENT。cpp-terminal 的 input.cpp 在遍历INPUT_RECORD时识别它用一个need_windows_size标志攒批先把本轮按键事件全部投递最后才补发一次screen_size()——注释里写着 if we send directly its too much generations意思是快速拖窗口会产生大量重复事件批量化处理让上层只关心最终尺寸。初始化时序的隐藏细节先阻塞再注册在 terminal_impl.cpp 的使能流程里顺序非常讲究Term::Private::Sigwinch::blockSigwinch(); // 先 SIG_BLOCK Term::Private::Sigwinch::registerSigwinch(); // 再注册 signalfd为什么要先阻塞因为SIGWINCH的默认行为是……什么都不做但如果注册 signalfd 之前信号恰好到达处理时机就不受控了。先pthread_sigmask(SIG_BLOCK, ...)把信号拦下来再注册监听保证从启用到关闭期间每一次 resize 都确定性地落进 signalfd。退出时则对称地调用unblockSigwinch()把信号掩码恢复原状做到进入终端模式 → 离开还原一切的干净生命周期。事件循环的心脏把尺寸变化变成一条 Event打开 input.cpp 的Input::read_event()Linux 分支的核心只有寥寥数行逻辑epoll_create1建轮子EPOLL_CTL_ADD挂上两个描述符signalfd 句柄标准输入 fd死循环epoll_wait阻塞等待醒来后判断Sigwinch::isSigwinch(ret.data.fd)命中 → 执行m_events.push(Term::Screen(screen_size()))否则走read_raw()读按键推入字符事件尺寸是怎么读出来的答案在 screen.cpp 的Term::screen_size()POSIXioctl(fd, TIOCGWINSZ, window)取ws_row/ws_colWindowsGetConsoleScreenBufferInfo计算窗口右下角减左上角随后这条Screen事件进入线程安全的BlockingQueue应用主线程调Term::read_event()就能像取按键一样取到它。实际应用在你的程序里响应窗口缩放得益于这套机制应用层代码非常清爽——参考示例 events.cppTerm::terminal.setOptions(Term::Option::NoClearScreen, Term::Option::NoSignalKeys, // 关键不让库自己处理信号 Term::Option::Raw); while(true) { auto event Term::read_event(); if(event.type() Term::Event::Type::Screen) { Term::Screen s(event); // 按 s.rows() / s.columns() 重新布局 } }项目里三个示例展示了不同复杂度的用法events.cpp打印每一种事件最适合学习事件模型menu.cpp菜单按新尺寸自适应居中kilo.cpp一个完整文本编辑器setScreenSize后整体重绘屏幕尺寸事件的结构定义见 screen.hpp单元测试在 screen.test.cpp。核心设计总结5 个值得抄走的技巧 ✅signalfd 化把不可预测的信号变成可 epoll 的 fd消除异步信号安全问题先 block 后 register用信号掩码锁住初始化间隙事件不丢不重对称还原退出时unblockSigwinch恢复现场不污染宿主进程批量化Windows 路径攒批尺寸事件防止拖动窗口时事件风暴平台收敛所有差异藏在private/目录的三个小文件里公共 API 一行不变理解了这一套你就不只会用 cpp-terminal还能在自己的 C TUI 项目中复刻出同等质量的屏幕尺寸变化处理 【免费下载链接】cpp-terminalC library for writing multiplatform terminal applications项目地址: https://gitcode.com/gh_mirrors/cp/cpp-terminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 cpp-terminal源码级教程：SIGWINCH信号与屏幕尺寸变化处理的实现秘密
cpp-terminal源码级教程SIGWINCH信号与屏幕尺寸变化处理的实现秘密【免费下载链接】cpp-terminalC library for writing multiplatform terminal applications项目地址: https://gitcode.com/gh_mirrors/cp/cpp-terminalcpp-terminal是一款零依赖、跨平台的 C 终端应用库。本文带你深入源码揭秘它是如何处理SIGWINCH 信号、监听屏幕尺寸变化并把窗口缩放事件变成应用里一条普通事件的完整实现机制。为什么需要 SIGWINCH窗口一变谁在通知你的程序当你拖拽终端窗口边缘改变大小时内核会向前台进程发送一个名为SIGWINCHWindow Change的信号。这是 Linux/macOS 下感知尺寸变化的唯一官方途径。但直接用传统信号处理函数有个大坑信号处理函数中只能调用异步信号安全的极少数函数稍微复杂一点就可能死锁如果信号处理函数没执行完信号再次到来之前的会被直接丢弃——快速拖动窗口会丢事件Windows 根本没有 SIGWINCH 这个概念cpp-terminal 的解法是把信号彻底变成可读取的文件描述符塞进统一的 I/O 事件循环。这正是本文要拆解的核心。三平台、三条路径一套接口的跨平台设计所有平台差异都被收敛在一个极小的类里——sigwinch.hpp 中声明、sigwinch.cpp 中实现的Term::Private::Sigwinch对外只暴露 4 个静态方法方法职责registerSigwinch()注册信号监听机制blockSigwinch()用pthread_sigmask阻塞信号unblockSigwinch()退出时恢复信号isSigwinch(fd)判断某事件描述符是否是窗口变化并消费信号get()返回可被 I/O 多路复用的句柄三条实现路径泾渭分明1️⃣ Linuxsignalfd epoll 的黄金组合Linux 路径调用了signalfd(-1, set, SFD_NONBLOCK | SFD_CLOEXEC)——把 SIGWINCH 变成一个文件描述符m_fd。之后窗口变化 → 内核往m_fd里写入一段signalfd_siginfo数据epoll_wait像等待键盘输入一样等待它读到数据 收到一次 resizeread()同时完成了消费信号天然不会丢失后续事件信号从此只是数据不再有回调也就没有异步信号安全问题。2️⃣ macOS / WebAssemblyvolatile 标志位方案macOS 没有 signalfd。这里退回经典做法sigaction注册一个极简处理函数它唯一的工作就是把volatile sig_atomic_t m_signalStatus置 1。事件循环每次醒来时调isSigwinch()检查并清零这个标志。简单、可靠且处理函数短到不可能死锁。3️⃣ Windows根本没有信号用事件代替Windows 的控制台 API 会在输入队列里推送WINDOW_BUFFER_SIZE_EVENT。cpp-terminal 的 input.cpp 在遍历INPUT_RECORD时识别它用一个need_windows_size标志攒批先把本轮按键事件全部投递最后才补发一次screen_size()——注释里写着 if we send directly its too much generations意思是快速拖窗口会产生大量重复事件批量化处理让上层只关心最终尺寸。初始化时序的隐藏细节先阻塞再注册在 terminal_impl.cpp 的使能流程里顺序非常讲究Term::Private::Sigwinch::blockSigwinch(); // 先 SIG_BLOCK Term::Private::Sigwinch::registerSigwinch(); // 再注册 signalfd为什么要先阻塞因为SIGWINCH的默认行为是……什么都不做但如果注册 signalfd 之前信号恰好到达处理时机就不受控了。先pthread_sigmask(SIG_BLOCK, ...)把信号拦下来再注册监听保证从启用到关闭期间每一次 resize 都确定性地落进 signalfd。退出时则对称地调用unblockSigwinch()把信号掩码恢复原状做到进入终端模式 → 离开还原一切的干净生命周期。事件循环的心脏把尺寸变化变成一条 Event打开 input.cpp 的Input::read_event()Linux 分支的核心只有寥寥数行逻辑epoll_create1建轮子EPOLL_CTL_ADD挂上两个描述符signalfd 句柄标准输入 fd死循环epoll_wait阻塞等待醒来后判断Sigwinch::isSigwinch(ret.data.fd)命中 → 执行m_events.push(Term::Screen(screen_size()))否则走read_raw()读按键推入字符事件尺寸是怎么读出来的答案在 screen.cpp 的Term::screen_size()POSIXioctl(fd, TIOCGWINSZ, window)取ws_row/ws_colWindowsGetConsoleScreenBufferInfo计算窗口右下角减左上角随后这条Screen事件进入线程安全的BlockingQueue应用主线程调Term::read_event()就能像取按键一样取到它。实际应用在你的程序里响应窗口缩放得益于这套机制应用层代码非常清爽——参考示例 events.cppTerm::terminal.setOptions(Term::Option::NoClearScreen, Term::Option::NoSignalKeys, // 关键不让库自己处理信号 Term::Option::Raw); while(true) { auto event Term::read_event(); if(event.type() Term::Event::Type::Screen) { Term::Screen s(event); // 按 s.rows() / s.columns() 重新布局 } }项目里三个示例展示了不同复杂度的用法events.cpp打印每一种事件最适合学习事件模型menu.cpp菜单按新尺寸自适应居中kilo.cpp一个完整文本编辑器setScreenSize后整体重绘屏幕尺寸事件的结构定义见 screen.hpp单元测试在 screen.test.cpp。核心设计总结5 个值得抄走的技巧 ✅signalfd 化把不可预测的信号变成可 epoll 的 fd消除异步信号安全问题先 block 后 register用信号掩码锁住初始化间隙事件不丢不重对称还原退出时unblockSigwinch恢复现场不污染宿主进程批量化Windows 路径攒批尺寸事件防止拖动窗口时事件风暴平台收敛所有差异藏在private/目录的三个小文件里公共 API 一行不变理解了这一套你就不只会用 cpp-terminal还能在自己的 C TUI 项目中复刻出同等质量的屏幕尺寸变化处理 【免费下载链接】cpp-terminalC library for writing multiplatform terminal applications项目地址: https://gitcode.com/gh_mirrors/cp/cpp-terminal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考