NCURSES 函数简要参考
BenBear
目录
说明
简介
初始化与结束
基本输入、输出函数预览
函数命名、参数习惯
getch()
窗口 WINDOW
颜色
Panel、Menus 和 Forms
其它
参考资料
说明
在这里写下对 NCURSES 库使用的经验，希望对你有用。由于条件的不足，
我只是在 WMware Workstation 4.0.5 里安装的 Debian Linux 3.0 r2 下使用
过 NCURSES，所以这里所说的片面性在所难免，还请细查。如有问题，你可以给
我发邮件：cxj1024@etang.com。
简介
NCURSES 是 Linux 下进行终端界面开发的库，其功能相当强大。它以
WINDOW（窗口）为基本要素，在此基础上支持 Panel、Memus 及 Forms 等更加
强大的元素。更多的信息请参考资料。
初始化与结束
当然了，为了使用 NCURSES 库，你应该 #include <curses.h>，在编译时，
应该加上 -lncurses。
在使用 NCURSES 库前，必须先行初始化；用完后必须结束，否则终端可能
会不正常。初始化是一系列的动作，内容有关功能键、输入回显、换行符、颜色
等。
一般地，第一个函数调用必须是 initscr()。这个函数初始化终端，然后清
屏。它的参数为空，返回值一般也不用管。它会初始化一个叫 stdscr 的变量，
stdscr 有点像 stdin 或 stdout 的地位，它是 NCURSES 默认的窗口。
紧接着 initscr() 的应该是其它初始化，下面一一介绍。
即时按键。raw() 和 cbreak() 两个函数都是用来关闭行缓冲以使按键可以
马上被程序处理的。只是 cbreak() 可以在按 Ctrl-C 的时候退出程序，我一般
用这个。两个函数都无参数。
使用功能键。keypad() 可以用来打开一个窗口的功能键，从来使程序可以
识别 F1、F2、Up、Down 等这样的按键。一般用 keypad (stdscr, TRUE) 来打
开 stdscr 的这项功能。
按键回显。echo() 和 noecho()，后者可以关闭按键回显，这在使用
getch() 时特别有用。在程序中间，二者可以交替使用。两个函数都无参数。
换行符。nl() 和 nonl()，用来设置换行是对应一个 '\n' 还是 '\r''\n'。
一般使用默认的就要可以了，所以不需调用。两个函数都无参数。
启动颜色。has_colors() 返回一个 bool 值，用来表示终端是否支持颜色；
支持则返回真。如果支持颜色，那么就可以用 start_color() 来打开颜色功能。
终合这些，我的初始化代码一般是：
initscr ();
cbreak ();
noecho ();
start_color ();
keypad (stdscr, TRUE);
结束很简单，只需调用 endwin(); 即可，但一定要记得调用。如下：
endwin();
基本输入、输出函数预览
由于 NCURSES 已经接管了输入输出，所以 <stdio.h> 里标准 I/O 就不好
再使用了；当然，你可以用，但很可能出错。
很高兴的是，NCURSES 中基本的输入输出设计得跟标准 I/O 十分相似，比
如输出有 printw()，输入有 scanw()，呵呵，只是把“f”换成了“w”，其它
定义完全一样。
基本的输出函数有 addch()、addstr()、printw()，分别为输出一个字符、
输出一个字符串和格式化输出。在这几个函数上会演化出很多函数。演化的两大
要素是：坐标和窗口。
坐标是相对于窗口的左上角的，从 (0, 0) 开始，但注意 NCURSES 里的下
标是 (y, x) 表示的，这个务必记住。move(y, x); 可以直接移动 stdscr 的光
标到某一位置。窗口 Window 是 NCURSES 的基本操作对象，事实上所有的的输
入输出都关联到窗口上，如果缺省的话，就是 stdscr。
当然，从 addstr() 到 addnstr() 也是一种演化。
例如 addch() 这一系列的函数有：addch()、mvaddch()、wadch() 和
mvwaddch() 四个。其中“mv”表示 move，也就是移动到某一坐标处再输出。而
“w”表示 Window，即向某一窗口输出。而 move() 也可以变化成 wmove()。
要注意的是，这些输出不是直接输出到屏幕上的，而是输出到某一窗口（当
然缺省的是 stdscr）。所以应该使用 refresh() 刷新 stdscr 的输出；对应的，
用 wrefresh() 可以刷新某一窗口的输出；wrefresh(stdscr) == refresh()。
基本的输入函数有 getch()、getstr()、scanw()，也可以演化出很多函数。
echo 的设置会对输入函数产生一定的影响，可能由于 noecho 而使输入时
没有回显。如果这样的话，可以先打开 echo 然后再关闭。按照我看的资料，像
scanw () 这样的函数，会自动打开 echo 的，但实际上确实出现了没有回显的
情况。
函数名命、参数习惯
这些输入输出函数都是很规范的，下面总结一下。
如果没有前缀，那就表示在 stdscr 的当前位置输入或输出。如果前缀是
“w”，表示向某一个窗口的当前位置上操作。如果前缀是“mv”，表示要在
stdscr 的某一位置上操作。如果前缀是“mvw”，表示在某一窗口的某一位置上
进行操作。
参数的排列是这样的：([WINDOW,] [y, x,] arg1, agr2, ...)。也就是如
果有窗口，那么窗口就是第一个参数；其次是如果有 (y, x)，处于窗口后而在
其它参数前。如 addch() 系列是：addch(ch)、mvaddch(y, x, ch)、
waddch(win, ch)、mvwaddch (win, y, x, ch)。
知道这些规则，对于记忆众多的函数大有益处。
getch()
getch() 是极有用的函数，它可以读取功能键，所以几乎是必须用到的函数。
如果 echo()，那么 getch() 是有回显的；否则，noecho() 下没有回显。只有
在 keypad(win, TRUE) 后，才能使用功能键。
getch() 无参数，返回值表示按键的值，可以是一个 ASCII 值，也可能是
一个功能键。功能键可以在 man 3 getch 里查到，都是以 KEY_ 开头的。下面
列出常用的一些：
回退键： KEY_BACKSPACE
Insert： KEY_IC
Delete： KEY_DC
上方向键： KEY_UP
左方向键： KEY_LEFT
F1： KEY_F(1)
F2： KEY_F(2)
PageUp： KEY_PPAGE
PageDown： KEY_NPAGE
TAB、ESC、ENTER 都是 ASCII 值对应。
getch() 从 stdscr 中读取按键值，wgetch() 从某一窗口中读取按键值。
窗口 WINDOW
WINDOW 是 NCURSES 管理的基本单元，也是应用的基础，后面要说到的
Menus Library 和 Forms Library 都要用到 WINDOW 来管理其输出。
每个窗口都对应一个数据结构，在创建窗口时 NCURSES 会分配这些空间，
所以窗口使用完了应该删除。一个窗口的数据结构里记录有窗口的大小，窗口左
上角的位置，一个显示缓冲区，当前颜色等等众多数据。
你应该知道了，stdscr 是 NCURSES 缺省的窗口，也是启动后的第一个窗口。
newwin() 可以建立一个新窗口，其声明是：
WINDOW* newwin(int height, int width, int y, int x);
其中 (y, x) 是窗口左上角的坐标。窗口建立后，如果想要打开功能键的话，
应该调用 keypad()。我一般是两个一起使用。
一个窗口使用完后，应该删除掉，函数是 delwin()，参数是要删除的窗口
指针。在删除窗口之前，你也许要清除窗口里的内容，可以用 wclear()。但是
wclear() 似乎并不使用当前颜色，而只是使窗口黑掉。
box() 是一个有用的函数，可以给一个窗口画一个边框，一般这样用：
box(win, 0, 0);。类似的函数还有 wborder()。画框时可能要用到一些 ASCII
之外的字符，NCURSES 定义了一些字符，以 ASC_ 开头，如果终端不支持这些字
符，NCURSES 会自动以相似的字符代替。
在窗口里，你就可以输出东西了，addch()、addstr() 和 printw() 几类函
数可以随意使用，但一定要记得 wrefresh()。要注意的是，窗口的 refresh 是
优化了的，它只会刷新被改变的部分，所以效率是比较高的。
当窗口比较多时，为了显示被埋在下面的窗口，可以使用 redrawwin(win)
来重绘窗口，这个时候 wrefresh() 并不是那么有效。
wnoutrefresh(win) 和 doupdate() 是很好的一对搭配。当你窗口很多时，
对每个窗口直接用 wrefresh() 是比交耗时的。这时你可以用 wnoutrefresh()
来更新每个窗口的缓冲区，最后用 doupdate() 显示。
我并没有使用复杂的很多个窗口，所以在窗口之间的重叠上不是太了解。
你也可以创建一个窗口的子窗口，函数是 subwin() 和 derwin()，它们的
定义是：
WINDOW *subwin(WINDOW *orig, int lines, int cols, int y, int x);
WINDOW *derwin(WINDOW *orig, int lines, int cols, int y, int x);
它们都是在窗口 orig 中创建一个 lines * cols 大小的子窗口，它们的区
别是前者的 (y, x) 是相对于屏幕的，而后者的 (y, x) 是相对于窗口 orig 的。
子窗口共享窗口 orig 的内存。在 wrefresh 子窗口前，应该调用
touchwin(orig) 或 touchline(orig)，否则可能输出不正常。
颜色
实际上在 NCURSES 里颜色只是字符属性的一部分，另一种是 highlighting
（高亮）。我更喜欢将它们统称为颜色。通过设置字符的属性和高亮显示，就可
以获得一个漂亮界面。
只有在 start_color() 后，才能使颜色；当然，高亮显示不需要这样。
NCURSES 预定义了八种颜色，以 COLOR_ 开头，有 COLOR_BLACK、
COLOR_RED、COLOR_GREEN 等。比较奇怪一点的是，你必须成对使用这些颜色，
也就是同时指定前景色和背景色。init_pair(pair, g, b) 用来指定一个
COLOR_PAIR（“色对”）的，pair 是一个 1 到 COLOR_PAIRS-1 之间的值。
COLOR_PAIRS 指定了色对的最大数目，相应有 COLORS 指定了颜色的最大数目。
高亮的属性是以 A_ 开头的，有 A_NORMAL、A_REVERSE、A_UNDERLINE、
A_BOLD 等。但是这些高亮属性与终端有很大关系，例如我基本上只能用到
A_REVERSE，也就是反色。
attron() 和 attroff() 用来设置字符的属性，之后输出的字符都会具有改
变后的属性。例如 attron(A_REVERSE) 可以打开反色属性，可能的就是黑底白
字变成白底黑字。attron(COLOR_PAIR(n)) 则可以打开色对 n 所对应的前景和
背景。注意在 attron() 之后，对应地用 attroff() 来关闭。在 attron() 的
时候，高亮与颜色应该可以通过“或”运算同时使用。
设定色对的一个技巧是使用颜色本身作序号，如 init_pair(COLOR_RED,
COLOR_RED, COLOR_BLACK);，这样 COLOR_PAIR(COLOR_RED) 就很明显了。
chtype 类型可以同时携带字符及其属性。这是 addch() 的参数类型。
wchgat() 是一个极有用的函数，它可以改变从当前光标位置开始若干字节
的属性，这个在显示菜单或按钮时特别有用。但我在用这个函数时被郁闷了，不
知什么原因，这个函数总是不灵。
我现在使用 wchgat() 的方法是：通过 derwin() 申请一个子窗口，然后用
wchgat() 来改变子窗口中字符的属性，然后更新到父窗口。问题真不少，居然
mvwchgat() 不能正常工作，所以不得已我只有先 wmove() 然后再 wchgat()。
chgat() 的参数有四个，第一个是要改变属性的字符的长度，-1 表示到窗
口结尾；第二个是属性；第三个是颜色号，注意不要用 COLOR_PAIR，直接用色
对的序号；第四个参数保留，真接填 NULL。它从当前光标改变若干字符的属性
后，会返回原光标处。哦,你应该知道 chgat() 与 wchgat() 的关系吧。
Panel、Menus 和 Forms
NCURSES 还有这三个库：Panel Library、Menus Library 和 Forms
Library。其头文件分别为 <panel.h>、<menu.h> 和 <form.h>；编译选项分别
为 -lpanel、-lmenu 和 -lform，注意最好放在 -lncurses 前。
Panel 不了解；Menus 和 Forms 也只是简单抄了例子。
Menus 与 Forms 都要先手动创建基本元素，然后有一个“驱动”函数可以
用来驱动 Menus 或 Forms。你要做的就是从 wgetch() 接收按键，转化成命令
然后通过“驱动”函数来驱动 Menus 或 Forms。
Menus 主要提供对菜单的支持；Forms 提供一些输入的部件等。
其它
有很多函数我没有用到，下面简单列出。
erase() 与 clear() 类似；而 clrtobot() 和 clrtoeol() 是更小范围的
清除。mvwin() 可以用来移动窗口；还有更多函数参考 man 3 newwin。
getch() 的功能键里似乎包含了鼠标的按键。
我并不知道有什么函数可以在 newwin() 的同时，保存其时的屏幕的显示，
在 delwin() 后再恢复之。
NCURSES 对层叠窗口的支持不好。
参考资料
1、Eric S. Raymond and Zeyd M. Ben-Halim，《Writing Programs with NCURSES》
2、Pradeep Padala，《NCURSES Programming HOWTO》
3、man ncurses(3X)
4、http://poet.cosoft.org.cn/index.htm，正在翻译《NCURSES Programming HOWTO》
