состоит из трех типов элементов. Каждый элемент называется
capname
(имя характеристики) и определяет характеристику терминала.
Булевы или логические характеристики просто обозначают наличие или отсутствие поддержки терминалом конкретного свойства. Например, булева характеристика
xon
присутствует, если терминал поддерживает управление потоком
XON/XOFF
.
Числовые характеристики определяют размеры или объемы, например
lines
— это количество строк на экране, a
cols
— количество столбцов. Число отделяется от имени характеристики символом
#
. Для описания терминала с 80 столбцами и 24 строками следует написать
cols#80, lines#24
.
Строковые характеристики немного сложнее. Они применяются для двух разных типов характеристик: определения строк вывода, необходимых для доступа к функциям терминала, и определения строк ввода, которые будут получены, когда пользователь нажмет определенные клавиши, обычно функциональные или специальные клавиши на цифровой клавиатуре. Некоторые строковые параметры очень просты, например
el
, что означает "стереть до конца строки". Для того чтобы сделать это на терминале VT100, потребуется escape-последовательность
Esc, [, K
. В исходном формате terminfo это записывается как
еl=\Е[K
.
Специальные клавиши определены аналогичным образом. Например, функциональная клавиша <F1> на терминале VT100 посылает последовательность
Esc, O, P
, которая определяется как
kf1=\EOP
.
Все несколько усложняется, если escape-последовательности требуются какие-либо параметры. Большинство терминалов могут перемещать курсор в заданные строку и столбец. Ясно, что неразумно хранить отдельную характеристику для каждой точки экрана, в которую можно переместить курсор, поэтому применяется общая строковая характеристика с параметрами, определяющими значения, которые вставляются при использовании характеристики. Например, терминал VT100 использует последовательность
Esc, [, <row>, <col>, H
для перемещения курсора в заданную позицию. В исходном формате terminfo это записывается довольно устрашающе:
cup=\E[%i%p1%d;%p2%dH$<5>
.
Эта строка означает следующее:
\E
— послать escape-символ;
[
— послать символ
[
;
%i
— дать приращение аргументам;
%p1
— поместить первый аргумент в стек;
%d
— вывести число из стека как десятичное;
;
— послать символ
;
;
%р2
— поместить второй аргумент в стек;
%d
— вывести число из стека как десятичное;
H
—послать символ
H
.
Данная запись кажется сложной, но позволяет задавать параметры в строгом порядке, не зависящем от порядка, в котором терминал ожидает их появления в финальной escape-последовательности. Приращение аргументов
%i
необходимо, поскольку стандартная адресация курсора задается, начиная от верхнего левого угла экрана (0, 0), а терминал VT100 обозначает начальную позицию курсора как (1, 1). Заключительные символы
$<5>
означают, что для обработки терминалом перемещения курсора требуется задержка, эквивалентная времени вывода пяти символов.
Примечание
Мы могли бы описывать огромное множество характеристик, но, к счастью, в основном системы UNIX и 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
после своего аварийного завершения вызвала завершение программы: