Книга: Основы программирования в Linux

Применение характеристик terminfo

Применение характеристик terminfo

Теперь, когда вы знаете, как определить характеристики терминала, нужно научиться обращаться к ним. Когда используется terminfo, прежде всего вам нужно задать тип терминала, вызвав функцию setupterm. Она инициализирует структуру TERMINAL для текущего типа терминала. После этого вы сможете запрашивать характеристики терминала и применять его функциональные возможности. Делается это с помощью вызова setupterm, подобного приведенному далее:

#include <term.h>
int setupterm(char *term, int fd, int *errret);

Библиотечная функция setupterm задает текущий тип терминала в соответствии с заданным параметром term. Если term — пустой указатель, применяется переменная окружения TERM. Открытый дескриптор файла, предназначенный для записи на терминал, должен передаваться в параметре fd. Результат функции хранится в целой переменной, на которую указывает errret, если это не пустой указатель. Могут быть записаны следующие значения:

? -1 — нет базы данных terminfo;

? 0 — нет совпадающего элемента в базе данных terminfo;

? 1 — успешное завершение.

Функция setupterm возвращает константу OK в случае успешного завершения и ERR в случае сбоя. Если на параметр errret установлен как пустой указатель, setupterm выведет диагностическое сообщение и завершит программу в случае своего аварийного завершения, как в следующем примере:

#include <stdio.h>
#include <term.h>
#include <curses.h>
#include <stdlib.h>
int main() {
 setupterm("unlisted", fileno(stdout), (int *)0);
 printf("Done.n");
 exit(0);
}

Результат выполнения этой программы в вашей системе может не быть точной копией приведенного далее, но его смысл будет вполне понятен. "Done." не выводится, поскольку функция setupterm после своего аварийного завершения вызвала завершение программы:

$ cc -о badterm badterm.с -lncurses
$ ./badterm
'unlisted': unknown terminal type.
$

Обратите внимание на строку компиляции в примере: в этой системе Linux мы используем реализацию ncurses библиотеки curses со стандартным заголовочным файлом, находящимся в стандартном каталоге. В таких системах вы можете просто включить файл curses.h и задать -lncurses для библиотеки.

В функции выбора пункта меню хорошо было бы иметь возможность очищать экран, перемещать курсор по экрану и записывать его положение на экране. После вызова функции setupterm вы можете обращаться к характеристикам базы данных terminfo с помощью вызовов трех функций, по одной на каждый тип характеристики:

#include <term.h>
int tigetflag(char *capname);
int tigetnum(char *capname);
char *tigetstr(char *capname);

Функции tigetflag, tigetnum и tigetstr возвращают значения характеристик terminfo булева или логического, числового и строкового типов соответственно. В случае сбоя (например, характеристика не представлена) tigetflag вернет -1, tigetnum — -2, a tigetstr — (char*)-1.

Вы можете применять базу данных terminfo для определения размера экрана терминала, извлекая характеристики cols и lines с помощью следующей программы sizeterm.c:

#include <stdio.h>
#include <term.h>
#include <curses.h>
#include <stdlib.h>
int main() {
 int nrows, ncolumns;
 setupterm(NULL, fileno(stdout), (int *)0);
 nrows = tigetnum("lines");
 ncolumns = tigetnum("cols");
 printf("This terminal has %d columns and %d rowsn", ncolumns, nrows);
 exit(0);
}
$ echo $TERM
vt100
$ ./sizeterm
This terminal has 80 columns and 24 rows

Если запустить эту программу в окне рабочей станции, вы получите результат, отражающий размер текущего окна:

$ echo $TERM
xterm
$ ./sizeterm
This terminal has 88 columns and 40 rows
$

Если применить функцию tigetstr для получения характеристики перемещения курсора (cup) терминала типа xterm, вы получите параметризованный ответ: Е[%p1%d;%p2%dH.

Этой характеристике требуются два параметра: номер строки и номер столбца, в которые перемещается курсор. Обе координаты измеряются, начиная от нулевого значения в левом верхнем углу экрана.

Вы можете заменить параметры в характеристике реальными значениями с помощью функции tparm. До девяти параметров можно заменить значениями и получить в результате применяемую escape-последовательность символов.

#include <term.h>
char *tparm(char *cap, long p1, long p2, ..., long p9);

После формирования escape-последовательности с помощью tparm, ее нужно отправить на терминал. Для корректной обработки этой последовательности не следует пересылать строку на терминал с помощью функции printf. Вместо нее примените одну из специальных функций, обеспечивающих корректную обработку любых задержек, необходимых для завершения операции, выполняемой терминалом. К ним относятся следующие:

#include <term.h>
int putp(char *const str);
int tputs(char *const str, int affcnt, int (*putfunc)(int));

В случае успешного завершения функция putp вернет константу OK,в противном случае — ERR. Эта функция принимает управляющую строку терминала и посылает ее в стандартный вывод stdout.

Итак, для перемещения в строку 5 и столбец 30 на экране можно применить блок программного кода, подобный приведенному далее:

char *cursor;
char *esc_sequence;
cursor = tigetstr("cup");
esc_sequence = tparm(cursor, 5, 30);
putp(esc_sequence);

Функция tputs предназначена для ситуаций, в которых терминал не доступен через стандартный вывод stdout, и позволяет задать функцию, применяемую для вывода символов. Она возвращает результат заданной пользователем функции putfunc. Параметр affcnt предназначен для обозначения количества строк, подвергшихся изменению. Обычно он устанавливается равным 1. Функция, используемая для вывода строки, должна иметь те же параметры и возвращать тип значения как у функции putfunc. В действительности putp(string) эквивалентна вызову tputs (string, 1, putchar). В следующем примере вы увидите применение функции tputs, используемой с функцией вывода, определенной пользователем.

Имейте в виду, что в некоторых старых дистрибутивах Linux последний параметр функции tputs определен как int (*putfunc)(char), что заставит вас изменить определение функции char_to_terminal из упражнения 5.6.

Вы почти готовы добавить обработку экрана в вашу функцию выбора пункта меню. Единственно, что осталось, — очистить экран просто с помощью свойства clear. Некоторые терминалы не поддерживают характеристику clear, которая помещает курсор в левый верхний угол экрана. В этом случае вы можете поместить курсор в левый верхний угол и применить команду ed — удалить до конца экрана.

Для того чтобы собрать всю полученную информацию вместе, напишем окончательную версию примера программы выбора пункта меню screenmenu.c, в которой вы "нарисуете" варианты пунктов меню на экране для того, чтобы пользователь выбрал нужный пункт (упражнение 5.6).

Вы можете переписать функцию getchoice из программы menu4.c для предоставления полного управления терминалом. В этом листинге функция main пропущена, потому что она не меняется. Другие отличия от программы menu4.c выделены цветом.

#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <termios.h>
#include <term.h>
#include <curses.h>
static FILE* output_stream = (FILE *)0;
char *menu[] = {
 "a — add new record",
 "d — delete record",
 "q - quit",
 NULL,
};
int getchoice(char *greet, char *choices[], FILE *in, FILE *out);
int char_to_terminal(int_char_to_write);
int main() {
 ...
}
int getchoice(char *greet, char* choices[], FILE[]* in, FILE* out) {
 int chosen = 0;
 int selected;
 int screenrow, screencol = 10;
 char **option;
 char* cursor, *clear;
 output_stream = out;
 setupterm(NULL, fileno(out), (int*)0);
 cursor = tigetstr("cup");
 clear = tigetstr("clear");
 screenrow =4;
 tputs(clear, 1, (int*)char_to_terminal);
 tputs(tparm(cursor, screenrow, screencol), 1, char_to_terminal);
 fprintf(out, "Choice: %s", greet);
 screenrow += 2;
 option = choices;
 while (*option) {
  ftputs(tparm(cursor, screenrow, screencol), 1, char_to_terminal);
  fprintf(out, "%s", *option);
  screenrow++;
  option++
 }
 fprintf(out, "n");
 do {
  fflush(out);
  selected = fgetc(in);
  option = choices;
  while (*option) {
   if (selected == *option[0]) {
    chosen = 1;
    break;
   }
   option++;
  }
  if (!chosen) {
   tputs(tparm(cursor, screenrow, screencol), 1, char_to_terminal);
   fprintf(out, "Incorrect choice, select againn");
  }
 } while (!chosen);
 tputs(clear, 1, char_to_terminal);
 return selected;
}
int char_to_terminal(int char_to_write) {
 if (output_stream) putc(char_to_write, output_stream);
 return 0;
}

Сохраните эту программу как menu5.с.

Как это работает

Переписанная функция getchoice выводит то же меню, что и в предыдущих примерах, но подпрограммы вывода изменены так, чтобы можно было воспользоваться характеристиками из базы данных terminfo. Если вы хотите видеть на экране сообщение "You have chosen:" дольше, чем одно мгновение перед очисткой экрана и подготовкой его к следующему выбору пункта меню, добавьте в функцию main вызов sleep:

do {
 choice = getchoice("Please select an action", menu, input, output);
 printf("nYou have chosen: %cn", choice);
 sleep(1);
} while (choice != 'q');

Последняя функция в этой программе char_to_terminal включает в себя вызов функции putc, которую мы упоминали в главе 3.

В завершение этой главы бегло рассмотрим пример определения нажатий клавиш.

Оглавление книги