校園網路策進會
會長 林建宏
■ 前言
相信您在網路上一定用過如 tin,elm 等工具, 這些軟體有項共同的特色,
即他們能利用上下左右等方向鍵來控制游標的位置. 除此之外, 這些程式
的畫面也較為美觀. 對 Programming 有愛好的朋友一定對此感到好奇, 也
許他能在 PC 上用 Turbo C 輕易地寫出類似的程式, 然而, 但當他將相同
的程式一字不變地移到工作站上來編譯時, 卻出現一堆抓也抓不完的錯誤.
其實, 原因很簡單, 他使用的函式庫可能在 UNIX 上是沒有定義的. 有些
在 Turbo-C 上被廣泛使用的一些函式, 可能在 UNIX 上是不被定義的.
為了因應網路上各式各樣的終端機形態 (terminal), UNIX 上非凡發展出
一套函式庫, 專門用來處理 UNIX 上游標移動及螢幕的顯示. 這就是本篇
文章要為您介紹的 - curses.h 函式庫. 利用這個函式庫, 您也可以寫出
像 elm 般利用方向鍵來移動光棒位置的程式. (CCCA 近來所提供的線上選
課程式, 及程式服務界面, 即是筆者利用 curses 發展而成的 )
■ curses 的歷史與版本
cureses 最早是由柏克萊大學的 Bill Joy 及 Ken Arnold 所發展出來的.
當時發展此一函式庫主要原因是為了提高程式對不同終端機的相容性而設
計的. 因此, 利用 curses 發展出來的程式將和您所使用的終端機無關.
也就是說, 您不必擔心您的程式因為換了一部終端機而無法使用. 這對程
式設計師而言, 尤其是網路上程式的撰寫, 是件相當重要的一件事.
curses之所以能對上百種以上的終端機工作, 是因為它將所有終端機的資
料, 存放在一個叫 termcap 的資料庫, ( 而在第二版的 System V 系統中
, 新版的 curses 以 terminfo 取代原來的 termcap). 有了這些記錄, 程
式就能夠知道碰到哪一種終端機時, 須送什麽字元才能移動游標的位置,
送什麽字元才能清除整個螢幕清除. (* 注一)
另外, 本文的介紹 以 System V 的 curses 版本為主.
■ 如何在您的程式使用 curses ？
在您的 C 程式的檔頭將 <curses.h> include 進來.當您引進 curses.h
這個函式庫後, 系統會自動將 <stdio.h> 和 <unctl.h>一並 include 進
來.另外, 在 System V 版本中, <terminfo.h> 這個函式庫也將一並
include進來.
#include <curses.h>
main()
{
: :
: :
}
當然, 您的系統內必須放有 curses.h 這個函式庫.
■ 如何編譯(compile)
當您編輯好您的程式, 在 UNIX 提示符號下鍵入:
% /usr/5bin/cc [file.c] -lcurses
^^^^^^^
引進 curses.h 這個 library
或 % /usr/5bin/cc [file.c] -lcurses -ltermlib
(*注二)
■ 如何開始我的第一個 curses 程式？
在開始使用 curses 的一切命令之前, 您必須先利用 initscr()這個函式
來開啟 curses 模式.
相對的, 在結束 curses 模式前 ( 通常在您結束程式前 ) 也必須以
endwin()來關閉 curses 模式.
#include <curses.h>
main()
{
initscr();
: :
: :
: :
endwin();
}
這是一般 curses 程式標准的模式.
此外, 您可以就您程式所須, 而做不同的設定. 當然, 您可以不做設定,而
只是呼叫 initscr().
您可以自己寫一個函式來存放所有您所須要的設定. 平常使用時, 只要呼
叫這個函式即可啟動 curses 並完成一切設定.
下面的例子, 即是筆者將平常較常用的一些設定放在一個叫 initial()的函
式內.
void initial()
{
initscr();
cbreak();
nonl();
noecho();
intrflush(stdscr,FALSE);
keypad(stdscr,TRUE);
refresh();
}
各函式分別介紹如下:
□ initscr()
initscr() 是一般 curses 程式必須先呼叫的函數, 一但這個函數
被呼叫之後, 系統將根據終端機的形態並啟動 curses 模式.
□ endwin()
curses 通常以呼叫 endwin() 來結束程式. endwin() 可用來關閉
curses 模式, 或是暫時的跳離 curses 模式.假如您在程式中須要
call shell ( 如呼叫 system() 函式 ) 或是需要做 system call,
就必須先以 endwin() 暫時跳離 curses 模式. 最後再以
wrefresh() doupdate() 來重返 curses 模式.
□ cbreak()
nocbreak()
當 cbreak 模式被開啟後, 除了 DELETE 或 CTRL 等仍被視為非凡
控制字元外一切輸入的字元將馬上被一一讀取.當處於 nocbreak 模
式時, 從鍵盤輸入的字元將被儲存在 buffer 裡直到輸入 RETURN
或 NEWLINE.在較舊版的 curses 須呼叫 crmode(),nocrmode() 來
取代 cbreak(),nocbreak()
□ nl()
nonl()
用來決定當輸入資料時, 按下 RETURN 鍵是否被對應為 NEWLINE 字
元 ( 如
).
而輸出資料時, NEWLINE 字元是否被對應為 RETURN 和 LINDFEED
系統預設是開啟的.
□ echo()
noecho()
此函式用來控制從鍵盤輸入字元時是否將字元顯示在終端機上.系統
預設是開啟的.
□ intrflush(win,bf)
呼叫 intrflush 時須傳入兩個值:
win 為一 WINDOW 型態指標, 通常傳入標准輸出入螢幕 stdscr
bf 為 TRUE 或 FALSE
當 bf 為 true 時, 當輸入中斷字元 ( 如 break) 時, 中斷的反應
將較為快速.但可能會造成螢幕的錯亂.
□ keypad(win,bf)
呼叫 keypad 時須傳入兩個值:
win 為一 WINDOW 型態指標, 通常傳入標准輸出入螢幕 stdscr
bf 為 TRUE 或 FALSE
當開啟 keypad 後, 可以使用鍵盤上的一些非凡字元, 如上下左右
等方向鍵, curses 會將這些非凡字元轉換成 curses.h 內定義的一
些非凡鍵. 這些定義的非凡鍵通常以 KEY_ 開頭.
□ refresh()
refresh() 為 curses 最常呼叫的一個函式.
curses 為了使螢幕輸出入達最佳化, 當您呼叫螢幕輸出函式企圖改
變螢幕上的畫面時, curses 並不會馬上對螢幕做改變, 而是等到
refresh() 呼叫後, 才將剛才所做的變動一次完成. 其馀的資料將
維持不變. 以盡可能送最少的字元至螢幕上. 減少螢幕重繪的時間.
假如是 initscr() 後第一次呼叫 refresh(), curses 將做清除螢
幕的工作.
■ 游標的控制
move(y,x) 將游標移動至 x,y 的位置
getyx(win,y,x) 得到目前游標的位置
(請注重! 是 y,x 而不是 &y,&x )
■ 有關清除螢幕的函式
clear()
erase() 將整個螢幕清除
(請注重配合refresh() 使用)
■ 如何在螢幕上顯示字元
echochar(ch) 顯示某個字元
addch(ch) 顯示某個字元
mvaddch(y,x,ch) 在(x,y) 上顯示某個字元
相當於呼叫 move(y,x);addch(ch);
addstr(str) 顯示一串字串
mvaddstr(y,x,str) 在(x,y) 上顯示一串字串
相當於呼叫 move(y,x);addstr(str);
printw(format,str) 類似 printf() , 以一定的格式輸出至螢幕
mvprintw(y,x,format,str) 在(x,y) 位置上做 printw 的工作.
相當於呼叫 move(y,x);printw(format,str);
■ 如何從鍵盤上讀取字元
getch() 從鍵盤讀取一個字元 (注重! 傳回的是整數值)
getstr() 從鍵盤讀取一串字元
scanw(format,&arg1,&arg2...) 如同 scanf, 從鍵盤讀取一串字元
□例:
int ch;
char string1[80]; /* 請注重! 不可宣告為 char *string1; */
char string2[80];
echo(); /* 開啟 echo 模式, 使輸入馬上顯示在螢幕上 */
ch=getch();
string1=getstr();
scanw("%s",string2);
mvprintw(10,10,"String1=%s",string1);
mvprintw(11,10,"String2=%s",string2);
■ 如何利用方向鍵
curses 將一些如方向鍵等非凡控制字元, 以 KEY_ 為開頭定義在 curses.h
這個檔案裡頭, 如 KEY_UP 即代表方向鍵的 " ↑ ". 但, 假如您想使用
curses.h 所為您定義的這些非凡鍵的話, 您就必須將 keypad 設定為
TRUE. 否則, 您就必須自己為所有的非凡鍵定義了.
curses.h 為一些非凡鍵的定義如下:
KEY_UP 0403 ↑
KEY_DOWN 0402 ↓
KEY_LEFT 0404 ←
KEY_RIGHT 0405 →
KEY_HOME 0406 Home key (upward+left arrow)
KEY_BACKSPACE 0407 backspace (unreliable)
KEY_F0 0410 Function keys.
KEY_F(n) (KEY_F0+(n)) Formula for f .
KEY_NPAGE 0522 Next page
KEY_PPAGE 0523 Previous page
以上僅列出筆者較常使用的一些控制鍵, 至於其他控制鍵的定義, 請自行參
閱 man curses (* 注三)
一並為您列出其他常用的一些非凡字元
[TAB] /t
[ENTER] /r
[ESC] 27
[BACKSPACE] 127
