使用curses管理基于文本的屏幕－－（二）

初始化与结束

正如我们所看到的，所有的curses必须与initscr开始，并且以endwin结束。下面是他们头文件的定义：

#include <curses.h>
WINDOW *initscr(void);
int endwin(void);

在每个程序中initscr应只被调用一次。如果函数调用成功，initscr函数会返回一个指向stdscr结构的指针。如果函数失败，他只简单的打印出一个诊断错误信息，并且使得程序退出。

endwin函数成功时会返回OK，而失败则会返回ERR。我们可以调用endwin来离开curses，并且在以后通过调用clearok(stdscr,1)与refresh来恢复curses。这会有效的使得curses忘记物理屏幕的实际样子，并且会强制执行一次完全的重新显示。

输出到屏幕

为更新屏幕提供了一些基本的函数。他们是

#include <curses.h>
int addch(const chtype char_to_add);
int addchstr(chtype *const string_to_add);
int printw(char *format, ...);
int refresh(void);
int box(WINDOW *win_ptr, chtype vertical_char, chtype horizontal_char);
int insch(chtype char_to_insert);
int insertln(void);
int delch(void);
int deleteln(void);
int beep(void);
int flash(void);

curses有其自己的字符类型，chtype，其位数要比标准的char多。在ncurses的标准Linux版本中，chtype实际上为unsigned long的一个typedef。

add...函数会在当前位置添加指定的字符或是字符串。printw函数的工作方式与printf相类似，他会格式化一个字符串，并且将其添加到当前位置中。refresh函数会使得物理屏幕进行更新，如果成功则会返回OK，失败则会返回ERR。box函数会允许我们在窗口周围画一个盒子。

insch函数会插入一个字符，将已存在的字符向右移动，我们并没有指定此时在一行的末尾会发生什么，而且这依赖于我们所使用的终端。insertln会插入一个空行，将已存在的行向下移动一行。两个delete函数正好与两个insert函数相反。

要发出声音，我们可以调用beep。只有一少部分终端不可以发出声音，所以一些curses的设置会在调用beep时闪动屏幕。如果我们在一个忙碌的办公室中工作，在这里会在有声音由不同的机器发出，所以也许我们会更喜欢闪动屏幕的方式。正如我们所期望的，flash会使得我们的屏幕冷却，如果这个不可用，他就会尝试着在终端上发出声音。

由屏幕读取

我们可以由屏幕读取字符，尽管这个功能并不会经常用到，因为通常很容易跟踪所输出的内容。如果我们需要这样做，可以用下面的函数来完成。

#include <curses.h>
chtype inch(void);
int instr(char *string);
int innstr(char *string, int number_of_characters);

inch函数应总是会可用的，但是instr与innstr函数并不总是被支持的。inch函数会由光标的当前屏幕位置返回一个字符及其属性。注意，inch并不会返回一个字符，而是一个chtype，而instr与innstr会写入char数组。

清除屏幕

有四个函数可以用于清除屏幕区域。他们是

#include <curses.h>
int erase(void);
int clear(void);
int clrtobot(void);
int clrtoeol(void);

erase函数会将每一个屏幕位置清空。clear函数与erase函数相似，清除屏幕，但是同时会强制屏幕调用clearok来重新显示。clearok会在下一次调用refresh时强制一个清屏序列，并且会重新显示。

clear函数通常用作一个终端命令来清除整个屏幕，而不是简单的尝试清除任何当前非空的屏幕位置。这就使得clear函数成为一个更可靠的方式来完全清除屏幕。clear命令以及其后的refresh命令的组合会提供一个有用的重绘命令。

clrtobot函数会清除光标位置到屏幕结束处的屏幕，而clrtoeol函数会清除光标位置到光标所在行的结束处。

移动光标

另外提供了一个单一的函数用于移动光标，并且有另一个命令用来控制在屏幕更新之后curses离开光标的位置：

#include <curses.h>
int move(int new_y, int new_x);
int leaveok(WINDOW *window_ptr, bool leave_flag);

move函数只是简单的将逻辑光标位置移动到指定的位置。记住屏幕坐标是由左上角的(0,0)来指定的。在curses的大多数版本中，两个extern整数LINES与COLUMNS包含物理屏幕尺寸并且可以用来确定new_y与new_x所允许的最大值。调用move并不会使得物理光标移动。他只会改变当下一次输出出现时其所在的逻辑屏幕的位置。如果我们希望屏幕光标在调用move之后立即移动，我们可以在其后调用refresh函数。

leaveok函数会设置一个控制在屏幕更新之后光标curses离开物理光标位置的标记。在默认情况下，这个标记为false，而且在refresh之后，硬件光标会停留在与逻辑光标相同的屏幕位置上。如果这个标记设置为true，硬件光标的停留位置是随机的，可以是屏幕上的任何位置。一般而言，我们会更喜欢默认选项来保证光标停留在一个可感知的位置上。

字符属性

每一个curses字符都有一个特定的属性来控制他如何在屏幕上显示，假定显示硬件可以支持所请求的属性。定义的属性为A_BLINK,A_BOLD,A_DIM,A_REVERSE,A_STANDOUT,A_UNDERLINE。我们可以下面的函数来单独或是组合设置属性。

int attron(chtype attribute);
int attroff(chtype attribute);
int attrset(chtype attribute);
int standout(void);
int standend(void);

attrset函数可以设置curses属性，attron与attroff函数可以打开或是关闭指定的属性，而不会影响其他属性，而standout与standend提供了一个更为通用的方式，或是"独立"(stand out)模式。在大多数终端上，这通常映射到声音。

试验－－移动，插入以及属性

现在我们已经了解了很多管理屏幕的内容，我们可以试验一个更为复杂的例子，moveadd.c。在这个例子中，我们将会包含一些refresh与sleep调用，从而使得我们可以看到每一阶段屏幕显示的样子。通常，curses程序会尽可能少的刷新屏幕，因为这并不是非常有效的操作。下面的代码会显示这些特点。

1 我们包含某些头文件，定义了一些字符数组以及一个指向这些数组的指针，然后会初始化curses结构。

#include <unistd.h>
#include <stdlib.h>
#include <curses.h>
int main()
{
    const char witch_one[] = “ First Witch “;
    const char witch_two[] = “ Second Witch “;
    const char *scan_ptr;
    initscr();

2 现在对于要在屏幕上显示的三个文本初始集合，要注意文本属性的on与off标记。

move(5, 15);
attron(A_BOLD);
printw(“%s”, “Macbeth”);
attroff(A_BOLD);
refresh();
sleep(1);
move(8, 15);
attron(A_STANDOUT);
printw(“%s”, “Thunder and Lightning”);
attroff(A_STANDOUT);
refresh();
sleep(1);
move(10, 10);
printw(“%s”, “When shall we three meet again”);
move(11, 23);
printw(“%s”, “In thunder, lightning, or in rain ?”);
move(13, 10);
printw(“%s”, “When the hurlyburly’s done,”);
move(14,23);
printw(“%s”, “When the battle’s lost and won.”);
refresh();
sleep(1);

3 每次插入一个字符

attron(A_DIM);
scan_ptr = witch_one + strlen(witch_one) - 1;
while(scan_ptr != witch_one) {
    move(10,10);
    insch(*(scan_ptr--));
}
scan_ptr = witch_two + strlen(witch_two) - 1;
while (scan_ptr != witch_two) {
    move(13, 10);
      insch(*(scan_ptr--));
}
  attroff(A_DIM);
  refresh();
  sleep(1);

4 最后，我们将光标移动到屏幕的右下角，进行整理并退出。

  move(LINES - 1, COLS - 1);
  refresh();
  sleep(1);
  endwin();
  exit(EXIT_SUCCESS);
}