ncurses全部函数(ncurses API)

ncurses是Unix/Linux环境下用于终端界面开发的核心库，提供了一系列函数实现文本界面的窗口管理、输入输出控制、颜色渲染等功能。其设计目标是通过统一的API屏蔽不同终端的差异，使开发者能够编写可移植的终端交互程序。ncurses函数体系以窗口（WINDOW）为核心数据结构，围绕窗口创建、属性设置、事件处理、绘图操作等场景构建了完整的功能链。例如，通过initscr()初始化主窗口后，开发者可调用newwin()创建子窗口，利用wrefresh()刷新显示内容，并通过getch()捕获用户输入。该库采用分层架构，将终端能力封装为可编程接口，支持颜色对定义（start_color()）、光标移动（curs_set()）、键盘输入模式切换（raw()）等细粒度控制。其函数命名遵循清晰逻辑，如w前缀表示窗口相关操作，pair系列用于颜色管理，形成高度内聚的功能集群。

一、窗口管理函数

ncurses通过窗口对象管理终端显示区域，核心函数涵盖窗口生命周期与属性控制：

函数类别	典型函数	功能描述	参数特征
窗口创建/删除	newwin(), delwin()	创建指定尺寸子窗口，释放窗口资源	包含坐标(starty, startx)、尺寸(height, width)
窗口属性设置	scrollok(), idlok()	控制窗口滚动行为与输入焦点	布尔型参数控制开关状态
窗口层叠操作	overlay(), overwrite()	子窗口覆盖策略选择	目标窗口与源窗口双参数

窗口管理函数通过WINDOW指针进行操作，需注意父子窗口的层级关系。例如derwin()可创建父窗口的子区域视图，而wsyncup()能同步两个窗口的显示内容。

二、输入处理函数

输入模式	关键函数	触发条件	返回值特征
原始模式	raw(), noraw()	禁用/启用输入字符缓冲	影响ctrl+C等特殊键处理
延时等待	nodelay(), halfdelay()	非阻塞输入与超时设置	返回ERR或实际按键值
多窗口输入	wgetch(), getch()	指定窗口或全局输入捕获	返回键值编码（如KEY_UP）

输入处理支持三种模式：原始模式直接传递按键字符，节点延迟模式立即返回，半延迟模式设置超时时间。特殊键处理需配合KEY_宏定义，如KEY_F(1)表示功能键F1。

三、屏幕绘制函数

绘制类型	基础函数	窗口专用版	参数特点
字符输出	addch(), addstr()	waddch(), waddstr()	支持ACS字符、属性组合
区域清除	clear(), clrtoeol()	wclear(), wclrtoeol()	可选参数控制清除范围
边框绘制	box(), whline()	wborder(), wvline()	需指定角字符与边线字符

绘制操作需注意窗口坐标体系，原点(0,0)位于左上角。mv系列函数（如mvaddch）支持前置移动光标，实现定位绘制。所有绘图操作最终需通过refresh()序列化更新到终端。

四、颜色管理函数

操作阶段	初始化函数	颜色对函数	应用函数
能力检测	has_colors(), can_change_color()	-	-
颜色对定义	start_color()	init_pair(), pair_content()	init_pair(pair_num, fg, bg)
颜色应用	-	color_set(), bkgd()	attron(COLOR_PAIR(n))

颜色管理采用short型颜色编号体系，前8色为标准色，扩展色需终端支持。init_pair()定义的颜色对需通过attrset()或wattron()激活，且同一窗口仅能使用一套颜色对。

五、面板管理函数

操作类型	核心函数	数据结构	特性说明
面板创建	new_panel(), dup_panel()	PANEL结构体	包含窗口指针与层级信息
显示控制	top_panel(), bottom_panel()	-	调整面板堆叠顺序
事件触发	update_panels(), show_panel()	-	批量刷新可见面板

面板机制实现窗口的分层管理，每个面板包含关联窗口及显示优先级。hide_panel()仅隐藏不销毁，需配合free_panel()释放资源。多层面板切换时需显式调用更新函数。

六、菜单系统函数

构建流程	初始化函数	选项管理	交互函数
菜单创建	new_menu(), free_menu()	menu_opts()	post_menu()
选项配置	set_menu_item()	item_opts_off()	driver->format()
用户交互	menu_driver()	-	返回选中项索引

菜单系统依赖ITEM系列结构体构建选项，通过set_menu_userptr()绑定用户数据。布局方式支持水平排列（O_HORIZONTAL）与垂直排列（默认），导航键处理需结合menu_opts->op->keyfld配置。

七、事件处理函数

输入超时触发

事件类型	处理函数	触发条件	返回值
定时器事件	timeout(), nodelay()	返回ERR或按键值
窗口大小变更	resizeterm(), is_termresized()	终端尺寸变化	需重新初始化窗口
鼠标事件	mousemask(), mouse_trafo()	启用鼠标支持	返回MEVENT结构体

事件处理需结合nodes()和doupdate()实现循环监听。鼠标事件处理需先调用mousemask(ALL_MOUSE_EVENTS)开启支持，坐标系统可通过savetty()/endwin()保存恢复。

八、高级特性函数

隐藏/显示光标或设为块状恢复终端原始状态

特性类别	关键函数	依赖条件	应用场景
软光标控制	curs_set(), curs_inopts()	终端支持cup
多字节支持	set_esc_delay(), wset_char()	UTF-8终端环境	处理宽字符绘制
程序退出	endwin(), ripoffline()	-

高级特性包含国际化支持（set_term()）、制表符处理（tab_size()）等边缘功能。其中ripoffline()可移除特定行号的终端输出，常用于覆盖状态栏信息。

ncurses函数体系通过模块化设计实现了终端交互的完整闭环，其窗口-面板双层架构既保证灵活性又控制复杂度。实际应用中需特别注意资源管理（如window/panel对象的配对释放）、坐标体系转换（物理屏与窗口坐标的映射）以及终端差异兼容性（通过tigetstr()获取终端能力字符串）。虽然部分函数存在历史包袱（如过时的mvaddch()建议改用mvwaddch()），但整体仍是终端界面开发的事实标准库。